Claude MCP Kurulumu: Claude Code, Claude, Cursor, ChatGPT ve Codex’i tten MCP Server’a Bağlama

AI agent’ınıza (yapay zeka agent’ı) “bir test sunucusu kur” dediğinizde işlemi yapabilmesi için altyapınıza bir MCP sunucusu üzerinden bağlantı kurması gerekir. Uygulamalar aynı bağlantı adresini kullanır. Tek değişken bağlantı adresini nasıl kullandığınızdır: Claude Code ve Codex’te bir komut, Claude’da bir custom connector (özel bağlayıcı) ekranı, Cursor’da bir JSON dosyası, ChatGPT’de developer mode.

Bu yazıda beş uygulamayla tten MCP Server bağlantısını gerçekleştireceğiz. Yazının sonunda bağlantıyı doğrulayan komutları ve yetki kısıtlamasının yollarını öğreneceksiniz.

Claude MCP bağlantısı nasıl çalışır?

MCP (Model Context Protocol), agent’ların üçüncü parti araçları çağırmasını sağlayan açık bir standarttır. Ayrıntıları MCP nedir? yazısında bulabilirsiniz. Bilinmesi gereken tek ayrım: MCP sunucusu ya bilgisayarınızda yerel (stdio) çalışır ya da internette uzak (remote) bir adreste durur.

tten MCP Server uzak bir sunucudur. Adresi tüm uygulamalarda aynıdır:

Kimlik doğrulama OAuth üzerinden yapılır. Uygulama tten MCP Server’a ilk kez bağlandığında tarayıcınızda tten’in yetkilendirme sayfası açılır. API anahtarınızı bu sayfaya girersiniz. Anahtar uygulamanın ayar dosyasına kaydedilmez. E-posta adresiniz istenmez.

İşleyiş bu kadar. Önce API anahtarınızı oluşturun.

Başlamadan önce: API anahtarı oluşturun

Bağlantı için bir tten hesabı ve aktif bir paket ya da 7 günlük ücretsiz deneme gerekir. Deneme başlarken kartınızdan 1 TL doğrulama çekimi yapılır ve otomatik olarak iade edilir.

1. Core Panel’de Geliştirici → API Anahtarları sayfasını açın.

2. Yeni API Anahtarı düğmesine tıklayın.

3. Anahtara bir isim verin (örnek: claude-okuma).

4. Yetkileri seçin. 60’tan fazla yetki seçeneği vardır. İlk deneme için yalnızca okuma yetkileri yeterlidir.

5. Geçerlilik süresini seçin: 1, 7, 30, 90 ya da 365 gün, özel bir tarih ya da süresiz (Never). Kısa süreli görevler için kısa süre, süresiz anahtar için dar yetki tercih edin.

6. Anahtar Oluştur düğmesine tıklayın ve anahtarı kopyalayın. Panel anahtarı yalnızca bir kez gösterir.

Her uygulama için ayrı bir anahtar oluşturun. Kullanıcı başına en fazla 10 anahtar oluşturursunuz. Bir anahtarı iptal ettiğinizde diğer uygulamalar çalışmaya devam eder.

Anahtar hazır. Şimdi uygulamanızı seçin.

Claude Code’a MCP sunucusu ekleme: claude mcp add

Claude Code’a uzak bir MCP sunucusunu tek komutla eklersiniz:

claude mcp add --transport

claude mcp add --transport

claude mcp add --transport

Ardından Claude Code oturumunda /mcp yazın, listeden tten’i seçin ve yetkilendirmeyi başlatın. Tarayıcınızda tten’in yetkilendirme sayfası açılır. API anahtarınızı bu sayfaya girin. Aynı işlemi terminalden claude mcp login tten komutuyla da gerçekleştirirsiniz.

Komut varsayılan olarak sunucuyu yalnızca bulunduğunuz projeye ekler. Bütün projelerinizde kullanmak için --scope user ekleyin. --scope project ise tanımı .mcp.json dosyasına yazar. Bu dosya ekibinizle Git üzerinden paylaşılır.

Eklenen sunucuları claude mcp list komutuyla listeler, claude mcp remove tten komutuyla kaldırırsınız.

Sunucuyu --header parametresiyle bir Bearer header’ı vererek de eklersiniz. Bu durumda anahtar yapılandırma dosyasında saklanır. --scope project ile birlikte kullanıldığında .mcp.json üzerinden Git’e girer. OAuth yönteminde uygulama anahtarı değil, yalnızca bir OAuth token saklar. Anahtarı iptal ettiğinizde bu token da geçersiz olur. Header ile bağlanmanız gerekiyorsa anahtarı .mcp.json dosyasına açık metin olarak yazmayın. "Authorization": "Bearer ${TTEN_API_KEY}" biçiminde ortam değişkeninden okutun. Claude Code değişkenin değerini bu dosyada kendisi yerine koyar.

Claude’da custom connector ekleme

Claude’un web ve masaüstü uygulamalarında uzak MCP sunucusunu custom connector olarak eklersiniz. Claude Desktop’taki claude_desktop_config.json dosyası yerel sunucular içindir. tten bağlantısı için gerekmez.

Free, Pro ve Max planları:

1. Customize → Connectors sayfasını açın.

2. + düğmesine tıklayın, Add custom connector seçeneğini seçin.

3. Sunucu adresi olarak https://mcp.tten.net/mcp girin. Advanced settings altındaki OAuth Client ID ve Client Secret alanlarını boş bırakın.

4. Add düğmesine tıklayın. Tarayıcınızda tten’in yetkilendirme sayfası açıldığında API anahtarınızı girin.

Free plan tek bir custom connector ile sınırlıdır.

Team ve Enterprise planları: Kuruluşun Owner’ı Organization settings → Connectors sayfasında Add düğmesine tıklar, Custom → Web seçeneğiyle adresi ekler. Üyeler Customize → Connectors sayfasında tten connector’ını seçer ve Connect ile kendi API anahtarlarını bağlar.

Menü adımları uygulama güncellemeleriyle değişebilir. Güncel adımları MCP dokümantasyonunda bulabilirsiniz.

Cursor MCP kurulumu: mcp.json

Cursor’da uzak sunucu arayüzden değil, mcp.json dosyası üzerinden eklenir. Bütün projeleriniz için ~/.cursor/mcp.json, tek bir proje için projenin kökündeki .cursor/mcp.json dosyasını kullanın.

{
  "mcpServers": {
    "tten": {
      "url": "https://mcp.tten.net/mcp"

{
  "mcpServers": {
    "tten": {
      "url": "https://mcp.tten.net/mcp"

{
  "mcpServers": {
    "tten": {
      "url": "https://mcp.tten.net/mcp"

Dosyayı kaydettikten sonra tarayıcınızda tten’in yetkilendirme sayfası açılır. API anahtarınızı bu sayfaya girin. Sunucuyu kenar çubuğundaki Customize sayfasından etkinleştirir ya da devre dışı bırakırsınız. Sayfa açılmazsa ya da bağlantı kurulamazsa hata ayrıntıları Output panelindeki MCP Logs kaydında görünür.

Anahtarı dosyaya açık metin olarak yazmayın. OAuth dışında bir yöntem gerekirse anahtarı bir ortam değişkeninde tutun. headers alanına "Authorization": "Bearer ${env:TTEN_API_KEY}" olarak ekleyin. Proje klasöründeki .cursor/mcp.json dosyası Git’e girer. Anahtar içeren tanımı bu nedenle global dosyada tutun.

Cursor, MCP araçlarını çalıştırmadan önce varsayılan olarak onayınızı ister. Bu ayarı açık bırakın.

ChatGPT’de developer mode ile MCP bağlama

ChatGPT’de uzak MCP sunucusu developer mode üzerinden bir uygulama olarak eklenir. Tam MCP desteği bugün yalnızca Business ve Enterprise/Edu planlarında, yalnızca web üzerinde sunulur. Sunucu kurmak ya da port açmak gibi yazma işlemleri bu desteğe bağlıdır. Pro hesaplar developer mode’da MCP’yi yalnızca okuma işlemleri için kullanır.

1. Developer mode’u açın. Business planında developer mode’u yalnızca yöneticiler kullanır ve Settings → Apps → Advanced settings altından açar. Enterprise/Edu planında yönetici önce Permissions & Roles → Connected Data altından yetki verir. Siz de aynı Settings → Apps → Advanced settings yolundan açarsınız.

2. Settings → Apps → Create sayfasında adres olarak https://mcp.tten.net/mcp girin. Kimlik doğrulama yöntemi olarak OAuth’u seçin.

3. Scan Tools düğmesine tıklayın. Tarayıcınızda tten’in yetkilendirme sayfası açıldığında API anahtarınızı girin. Tarama bitince Create ile uygulamayı oluşturun.

4. Uygulamanız Settings → Apps → Enabled Apps altında Dev etiketiyle görünür.

ChatGPT yazma işlemlerinden önce, uygulamanın izinlerine ve işlemin etkisine göre onayınızı ister. Bir araç için verdiğiniz onayı isterseniz o sohbet boyunca geçerli tutabilirsiniz; yeni sohbette yeniden sorulur.

Codex’e MCP sunucusu ekleme: codex mcp add

Codex CLI, ChatGPT masaüstü uygulamasındaki Codex ve IDE eklentisi aynı yapılandırmayı paylaşır: ~/.codex/config.toml. Bir kez eklediğiniz sunucu üçünde de görünür.

codex mcp add tten --url

codex mcp add tten --url

codex mcp add tten --url

İkinci komut tarayıcınızda tten’in yetkilendirme sayfasını açar. API anahtarınızı bu sayfaya girin. Codex, OAuth kaydını config.toml dosyasında saklar ve sonraki girişlerde yeniden kullanır. Eklenen sunucuları codex mcp list komutuyla listelersiniz.

Aynı tanımı dosyaya elle de yazabilirsiniz:

[mcp_servers.tten]
url = "https://mcp.tten.net/mcp"

[mcp_servers.tten]
url = "https://mcp.tten.net/mcp"

[mcp_servers.tten]
url = "https://mcp.tten.net/mcp"

Masaüstü uygulamasında Settings → MCP servers → Add server yolunu izleyin. Bir ad verin, Streamable HTTP seçin, adresi girin, kaydedin ve Restart ile yeniden başlatın. OAuth isteyen sunucular listede işaretlenir, Authenticate ile yetkilendirmeyi başlatırsınız.

Codex araç çağrılarını varsayılan olarak onayınıza sunar. default_tools_approval_mode = "writes" ayarı yalnızca okuma dışındaki araçlarda onay ister, bu ayarı kapatmayın. OAuth dışında bir yöntem gerekirse anahtarı dosyaya açık metin olarak yazmayın: bearer_token_env_var = "TTEN_API_KEY" ile ortam değişkeninden okutun.

Bağlantıyı doğrulayın: ilk komutlar

Bağlantıyı okuma amaçlı bir komutla test edin: “Sunucularımı listele.”

Agent’ınız sunucu listenizi döndürüyorsa bağlantı kurulmuştur. Henüz sunucunuz yoksa boş liste de bağlantının kurulduğunu gösterir. Sonraki adımlar anahtarınıza verdiğiniz yetkilere bağlıdır:

• “Sunucularımın CPU ve RAM kullanımını göster.”

• “Ubuntu ile 2 CPU ve 4 GB RAM’li, test-01 adında bir sunucu kur.”

• “Dışarıdan erişim için test-01 sunucusunda 80 ve 443 portlarını aç.”

Kullanım bilgisi okuma yetkisiyle görünür; sunucu kurmak ve port açmak için yazma yetkisi gerekir.

Bağlantı kuruldu. Son adım, agent’ınızın yetkilerini bilinçli olarak sınırlamak.

Güvenlik: yetki, onay, veri akışı ve izleme

Yetki. Agent’ınız anahtarınızda tanımlı olmayan bir işlemi çalıştıramaz. tten MCP Server yetkisiz çağrıyı reddeder. Dar yetkiyle başlayın, gerektikçe genişletin.

Onay. Sunucu silmek gibi kritik işlemler ilk çağrıda çalışmaz. tten MCP Server önce bir önizleme döndürür ve 60 saniye geçerli, tek kullanımlık bir onay kodu ister. Bu güvence uygulamadan bağımsızdır. Claude’dan ChatGPT’ye geçtiğinizde de geçerli kalır. Onay kodu size değil agent’a döner. Sunucu, önizlemeyi bir insanın gördüğünü doğrulayamaz. Bu nedenle uygulamanızın araç onayını da açık tutun.

Veri akışı. Yazdığınız komutlar, agent’ın çağırdığı işlemler ve bu işlemlerden dönen yanıtlar çoğu uygulamada yurt dışındaki model sağlayıcısında işlenir. Yanıtlar sunucu adlarınızı, IP adreslerinizi, firewall kurallarınızı ve fatura tutarlarınızı içerir. Agent’ınıza sunucu kurdurduğunuzda üretilen root parolası da aynı yoldan döner. Bu parolayı diğer parolalarınız gibi koruyun ve ilk girişte değiştirin. Sunucularınızın diskindeki veriler ve veritabanlarınız Türkiye’deki veri merkezinden çıkmaz. MCP bu verilerin içine bakmaz, yalnızca altyapı işlemlerini çalıştırır.

İzleme. Her işlem Core Panel’de log kaydına düşer: hangi anahtarın ne zaman neyi değiştirdiğini görürsünüz. Hız sınırı dakikada 120 okuma ve 60 yazma işlemidir. Sınır, hatalı bir döngünün altyapınızı yormasını engeller. Bir anahtarı Core Panel’den iptal ettiğinizde erişim anında sona erer.

Güvenlik konusunun ayrıntıları için: Yapay zekaya sunucu yetkisi vermek güvenli mi?

Sık sorulan sorular

Claude MCP için hangi plan gerekir?

Uzak MCP sunucusunu Claude’un Free, Pro, Max, Team ve Enterprise planlarında custom connector olarak eklersiniz. Free plan tek bir custom connector ile sınırlıdır. Team ve Enterprise planlarında connector’ı kuruluşun Owner’ı ekler. Üyeler kendi anahtarlarıyla bağlanır. Claude Code ise Pro, Max, Team ve Enterprise planlarında ya da API kullanımıyla çalışır. Sunucuyu claude mcp add komutuyla eklersiniz.

MCP bağlamak için kod yazmam gerekir mi?

Claude ve ChatGPT’de bağlantıyı arayüzden kurarsınız. Claude Code ve Codex’te tek bir komut yeterlidir. Cursor’da ise mcp.json dosyasına yedi satırlık bir tanım eklersiniz.

Custom connector ile yerel MCP sunucusu arasındaki fark nedir?

Yerel MCP sunucusu bilgisayarınızda bir süreç olarak çalışır. Uygulama bu sunucuyla doğrudan iletişim kurar. Custom connector ise internetteki uzak bir MCP sunucusuna HTTP üzerinden bağlanır. tten MCP Server uzak bir sunucudur. Bu nedenle Claude’da custom connector olarak eklenir.

Yapay zeka sunucumu silebilir mi?

API anahtarınıza silme yetkisi tanımazsanız agent bu işlemi yapamaz. Tanırsanız bile silme ilk çağrıda çalışmaz: tten MCP Server 60 saniye geçerli, tek kullanımlık bir onay kodu ister. Onay kodu size değil agent’a döner. Sunucu bir insanın onayladığını doğrulayamaz, bu nedenle uygulamanızın araç onayını da açık tutun.

Aynı anahtarı birden fazla uygulamada kullanabilir miyim?

Evet, ancak her uygulama için ayrı anahtar oluşturmanızı öneririz. Kullanıcı başına en fazla 10 anahtar oluşturursunuz. Bir uygulamanın erişimini kapatmak istediğinizde yalnızca o anahtarı iptal edersiniz. Diğerleri çalışmaya devam eder.

Bağlantıyı nasıl kapatırım?

Core Panel’de Geliştirici → API Anahtarları sayfasından anahtarı iptal edin. Erişim anında sona erer. Uygulama tarafında da sunucuyu kaldırın: Claude Code’da claude mcp remove tten, Claude’da Connectors listesinden, Cursor’da mcp.json ve Codex’te config.toml dosyasından. ChatGPT’de anahtarı iptal etmek erişimi keser.

Kurulumu kendi hesabınızda deneyin

Kurulum birkaç dakika sürer: bir API anahtarı, uygulamanızda tek bir adres ve tarayıcınızda bir onay. tten’i 7 gün ücretsiz deneyin. İlk komutunuzu okuma yetkisiyle verin, yetkiyi gerektikçe genişletin.

Ücretsiz deneyin

İlgili içerikler

• MCP (Model Context Protocol) nedir?

• AI ile bulut sunucu yönetimi

• Yapay zekaya sunucu yetkisi vermek güvenli mi?

• MCP dokümantasyonu

Kaynaklar

1. Anthropic. Get started with custom connectors using remote MCP. https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp (son güncelleme 2026-08-11, erişim 2026-09-25)

2. Anthropic. Connect Claude Code to tools via MCP. https://code.claude.com/docs/en/mcp (erişim 2026-09-28)

3. Cursor. Model Context Protocol (MCP). https://cursor.com/docs/context/mcp (erişim 2026-09-25)

4. OpenAI. Developer mode and MCP apps in ChatGPT. https://help.openai.com/en/articles/12584461-developer-mode-and-mcp-apps-in-chatgpt (erişim 2026-09-28)

5. OpenAI. Model Context Protocol (MCP) in Codex. https://learn.chatgpt.com/docs/extend/mcp (erişim 2026-09-29)

6. tten. MCP dokümantasyonu. https://tten.net/dokumantasyon/mcp-dokumantasyonu