MCP dokümantasyonu

Bu doküman, tten bulut altyapınızı bir yapay zeka istemcisine (Claude, Cursor, ChatGPT) bağlamak için gereken adımları anlatır. Süreç üç adımdan oluşur: API anahtarı oluşturun, istemciye bağlayıcıyı tanıtın, bağlantıyı doğrulayın.

Bağlanılacak sunucu adresi tüm istemcilerde aynıdır:

Yetki detayları ve endpoint referansı için tten API Dokümantasyonu’na bakın.

1. API anahtarı oluşturun

1. Sol menüden Geliştirici → API Anahtarları sekmesine gidin. Geliştirici bölümüne girdiğinizde API Anahtarları solda açık kalır.

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

3. Açılan sihirbazda üç ayarı yapın:

   • İsim: anahtarı tanımlayan bir isim verin (örnek: claude-prod-okuma, cursor-deploy-bot).

   • Yetkiler: anahtarın hangi işlemleri yapabileceğini kutucuklarla seçin. Yalnızca ihtiyaç duyduğunuz yetkileri verin. İlk denemelerde yalnızca okuma yetkilerini seçmeniz önerilir. Yetkilerin ayrıntısı API Dokümantasyonu’ndadır.

   • Geçerlilik süresi: hazır seçenekler 1, 7, 30, 90 ve 365 gündür. Özel bir tarih (Custom date) seçebilir ya da anahtarı süresiz (Never) bırakabilirsiniz. Panel de uyarır: süresiz anahtar güvenlik riski taşır, mümkünse kısa süreli anahtar kullanın. Süresiz anahtar için dar yetki tercih edin.

   Anahtarın kullanılabileceği IP’leri de kısıtlayabilirsiniz.

4. Anahtar Oluştur düğmesine tıklayın. Anahtar bir kez gösterilir, kopyalayıp güvenli bir yere kaydedin.

2. İstemciye bağlayıcıyı tanıtın

Bu adımın iki parçası var: tten sunucusunu istemcinize eklemek ve açılan tten sayfasında bağlantıyı yetkilendirmek. İstemciler arasında değişen tek şey sunucunun eklendiği yerdir, yetkilendirme adımı hepsinde aynıdır. Önce kendi istemcinizin adımlarını izleyin, sonra aşağıdaki ortak adımı uygulayın.

Ortak adım: bağlantıyı yetkilendirin

1. Bağlayıcı ekranında yalnızca sunucu adresini girin: https://mcp.tten.net/mcp

2. İstemci Client ID ve Client Secret alanları soruyorsa ikisini de boş bırakın. Bu alanlar tten MCP Server tarafında doldurulur.

3. Tarayıcıda tten’in yetkilendirme sayfası açılır. Sayfanın başlığı “TTEN hesabınıza erişimi yetkilendirin”, altbilgisi “TTEN güvencesiyle · mcp.tten.net” olur.

4. Sayfadaki tek alana 1. adımda oluşturduğunuz API anahtarını yapıştırın ve gönderin.

5. İstemciye geri döndüğünüzde bağlantı kurulmuş olur.

Kullandığınız istemciye göre ilgili bölüme geçin.

2a. Claude

Free, Pro veya Max planı:

1. Claude’da Customize → Connectors sayfasını açın.

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

3. Ortak yetkilendirme adımını uygulayın.

4. Add düğmesine tıklayın.

Team veya Enterprise planı:

1. Kuruluşun bir Owner’ı Organization settings → Connectors sayfasında Add düğmesine tıklar, Custom üzerine gelip Web seçeneğiyle https://mcp.tten.net/mcp adresini ekler.

2. Üyeler Customize → Connectors sayfasında Custom etiketli tten bağlayıcısını bulup Connect düğmesine tıklar ve ortak yetkilendirme adımını kendi API anahtarlarıyla uygular.

2b. Cursor

1. Bütün projeleriniz için ~/.cursor/mcp.json, tek bir proje için projenin kökündeki .cursor/mcp.json dosyasını açın.

2. Aşağıdaki tanımı dosyaya ekleyip kaydedin.

3. Tarayıcıda tten’in yetkilendirme sayfası açıldığında ortak adımın 3-5. maddelerini uygulayı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"
    }
  }
}

Sunucuyu kenar çubuğundaki Customize sayfasından açıp kapatabilirsiniz. Bağlantı hatalarını Output panelindeki MCP Logs kaydında görürsünüz.

Anahtarı dosyaya yazmayın. OAuth kullanmadan bağlanmanız gerekirse anahtarı bir ortam değişkeninde tutun ve headers alanına "Authorization": "Bearer ${env:TTEN_API_KEY}" olarak ekleyin (2d).

2c. ChatGPT

ChatGPT’de uzak MCP sunucusunu developer mode ile bir uygulama olarak eklersiniz. Tam MCP desteği bugün yalnızca Business ve Enterprise/Edu planlarında ve yalnızca web’de vardır. 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şlemleriyle kullanır.

1. Developer mode’u açın. Business’ta developer mode’u yalnızca yöneticiler kullanır ve Settings → Apps → Advanced settings altında açar. Enterprise/Edu’da yönetici önce Permissions & Roles → Connected Data altında 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ğrulamada OAuth’u seçin.

3. Scan Tools düğmesine tıklayın ve ortak yetkilendirme adımını uygulayın. Tarama bitince Create ile uygulamayı oluşturun.

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

2d. Diğer istemciler

Bağlayıcı arayüzü olmayan ya da HTTP başlıklarını elle tanımladığınız istemcilerde OAuth akışını atlayabilirsiniz. Bağlantı iki bilgiyle kurulur. Arayüz istemciden istemciye değişir, istenen bilgiler değişmez:

1. Sunucu adresi: https://mcp.tten.net/mcp

2. Anahtar: 1. adımda oluşturduğunuz API anahtarı. Authorization başlığında Bearer token olarak gider:

Anahtarı panelden kopyaladığınız gibi yapıştırın. Başına ya da sonuna bir şey eklemeniz, anahtarı parçalara ayırmanız veya bir önek üretmeniz gerekmez.

Bazı istemciler bu alanları farklı adlandırır. Kimlik doğrulandıktan sonra istemcinin yapabilecekleri anahtara verdiğiniz yetkilerle sınırlı kalır. Anahtarda olmayan bir yetki istemci üzerinden de kullanılamaz.

3. Bağlantıyı doğrulayın

Bağlantının çalıştığını teyit etmek için istemciye düşük riskli, okuma amaçlı bir komut yazın:

Beklenen davranış: istemci sunucu listenizi döndürür. Henüz sunucunuz yoksa boş liste de bağlantının çalıştığını gösterir. Sonuç geliyorsa bağlantı çalışıyordur.

Yanıt gelmiyorsa ya da yetki hatası alıyorsanız destek talebi oluşturun.

Anahtar yönetimi

Anahtarı iptal etme

1. Geliştirici → API Anahtarları menüsüne gidin.

2. İptal etmek istediğiniz anahtarın yanındaki Sil düğmesine tıklayın.

İptal edilen anahtarla kurulan tüm bağlantılar anında geçersiz olur.

Anahtar kullanımını izleme

Her API çağrısı denetim kayıtlarına token, kullanıcı, işlem, zaman damgası ve sonuç bilgisiyle yazılır. Kayıtlara Geliştirici → API Anahtarları yolundan, ilgili anahtarı seçtikten sonra İstek Logları üzerinden ulaşırsınız.

Dikkat edilmesi gerekenler

• Her kişi ve her görev için ayrı anahtar oluşturun.

• Anahtarlara anlamlı isimler verin.

• Görev süresinden uzun ömürlü anahtarlar oluşturmayın.

• Şüphe durumunda anahtarı iptal edip yenisini oluşturun.