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: 1 ile 365 gün arasında bir süre seçin. Hazır seçenekler 1, 7, 30, 90 ve 365 gündür. Süresiz anahtar oluşturulamaz. Kısa süreli görevler için kısa süre 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: istemcide özel bağlayıcı ekranını açmak ve açılan tten sayfasında bağlantıyı yetkilendirmek. İstemciler arasında değişen tek şey menü yoludur, yetkilendirme adımı hepsinde aynıdır. Önce kendi istemcinizin menü yolunu 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

Pro veya Max planı:

1. Claude’da Ayarlar → Bağlayıcılar (Connectors) sekmesine gidin.

2. Özel bağlayıcı ekle seçeneğini seçin.

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

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

Team veya Enterprise planı:

1. Kuruluşun bir Owner’ı, organizasyon ayarlarındaki Bağlayıcılar bölümünden özel bağlayıcıyı https://mcp.tten.net/mcp adresiyle ekler.

2. Bireysel üyeler, bağlayıcı listesinde Custom etiketli tten bağlayıcısını bulup Bağlan der ve ortak yetkilendirme adımını kendi API anahtarlarıyla uygular.

2b. Cursor

1. Cursor’da Settings → Cursor Settings → MCP Servers seçeneğini açın.

2. Add new MCP server düğmesine tıklayın.

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

Bağlantı kurulduğunda MCP Servers sekmesinde yeşil durum göstergesi belirir.

2c. ChatGPT

ChatGPT’de özel bağlayıcılar Developer Mode altındadır. Bu özellik Plus ve üzeri planlarda mevcuttur, Team ve Enterprise’da yöneticinin etkinleştirmesi gerekir.

1. Profil resminize tıklayın, Ayarlar → Connectors yolunu izleyin.

2. Alt kısımdaki Advanced bölümünü açın.

3. Developer Mode seçeneğini etkinleştirin, üçüncü taraf kod uyarısını onaylayın.

4. Connectors panelinde beliren Add custom connector düğmesine tıklayın.

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

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, API anahtarınızın izin verdiği işlemleri keşfeder ve sunucu listesini döndürür. 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.