Claude Code, Cursor ve Claude Desktop'ı bağlamak

Contextator’ın sunduğu her proje tek bir adrestir:

http://localhost:3444/mcp/<proje-adi>

Bir istemciyi oraya yöneltin; ajan beş dokümantasyon aracı kazanır: search_docs, list_topics, read_document, whats_new ve report_gap. Kurulacak bir eklenti ya da yapıştırılacak bir satıcı API anahtarı yoktur — yalnızca projenin kendi token’ı vardır, çünkü yeni bir proje bir token ister. Panodaki Connect an agent bölümü aşağıdaki her parçayı gerçek URL ile doldurulmuş hâlde, Authorization başlığını da token’ınızın geleceği yerde bir yer tutucuyla yazdırır; buradaki sürümlerde proje adı olarak demo, token olarak da proje sayfasının size gösterdiği token yerine ctxm_9f3a… kullanılıyor. Open’a çevrilmiş bir proje için başlığı çıkarın.

Claude Code

claude mcp add --transport http demo-docs http://localhost:3444/mcp/demo \
  --header "Authorization: Bearer ctxm_9f3a…"

Eklendiğini doğrulayın:

claude mcp list

Sonra dokümantasyonunuzla ilgili bir soru sorun, o kadar. Claude Code search_docs’u çağırmaya kendi karar verir; çünkü sunucu oturum açıldığında ne tuttuğunu kendisi anlatır.

Cursor

Bütün projeler için ~/.cursor/mcp.json, tek bir depo içinse .cursor/mcp.json:

{
  "mcpServers": {
    "demo-docs": {
      "url": "http://localhost:3444/mcp/demo",
      "headers": { "Authorization": "Bearer ctxm_9f3a…" }
    }
  }
}

Cursor’ı yeniden başlatın ve Settings → MCP altında yeşil göstergeye bakın.

Claude Desktop

Claude Desktop stdio konuşur, bu yüzden bir köprüye ihtiyaç duyar. claude_desktop_config.json içinde:

{
  "mcpServers": {
    "demo-docs": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "http://localhost:3444/mcp/demo",
        "--header", "Authorization:${AUTH_HEADER}"
      ],
      "env": { "AUTH_HEADER": "Bearer ctxm_9f3a…" }
    }
  }
}

Token env içinde durur ve başlık argümanında bilerek boşluk yoktur: Windows’ta Claude Desktop args’ı npx’e boşlukları kaçırmadan iletir, bu yüzden "Authorization: Bearer …" ikiye bölünmüş hâlde gelir ve her istek 401 ile döner. Bu düzen token’ı süreç listesinin dışında da tutar.

Yeniden başlatın; araçlar konektör simgesinin altında görünür. Yapılandırma dosyası macOS’ta ~/Library/Application Support/Claude/claude_desktop_config.json, Windows’ta %APPDATA%\Claude\claude_desktop_config.json adresindedir.

Neden taşıma ayarı yok

Bağlanmanın yolu Streamable HTTP’dir ve yukarıdaki her parça onu kullanır. Eski taşıma eski istemciler için aynı adreste hâlâ sunulur ve sunucu, istemcinin gönderdiğine göre seçer:

• Streamable HTTP, 2026-07-28, güncel istemciler için: _meta zarfını taşıyan bir POST oturumsuz (stateless) servis edilir. initialize el sıkışması da oturum da yoktur; bir mcp-session-id başlığı gelirse yok sayılır.
• Streamable HTTP, oturumlu, daha eski istemciler için: istemci bir initialize isteği POST eder, oturum kimliği mcp-session-id başlığında geri gelir.
• HTTP + SSE, 2024-11-05 protokolü, eski: istemci adrese GET atar, sunucu /mcp/demo/messages?sessionId=… adresini gösteren bir endpoint olayıyla cevap verir. Kullanımdan kaldırılmıştır — çalışmaya devam eder, ama yeni istemciler onun üzerine kurulmamalıdır.

Aralarında hiçbir şey geçiş yapmaz; yukarıdaki parçaların bu kadar kısa olmasının sebebi budur.

Ajansız kontrol etmek

Bir istemci sessizse ve sorunun endpoint’te mi istemcide mi olduğunu bilmek istiyorsanız, endpoint’e doğrudan ürün deposundan sorun:

npm install && npm run smoke -- http://localhost:3444/mcp/demo "how do I re-index"

Sıralı bir alıntı listesi dönüyorsa sunucu iyidir, sorun istemcinin yapılandırmasındadır. Smoke test hiçbir Authorization başlığı göndermez, bu yüzden token isteyen bir proje ona 401 ile cevap verir — Yapay Zekâ İstemcilerini Bağlamak o durum için curl kontrolünü gösterir.

Henüz bir proje başlatmadıysanız ana sayfa kurulumun tamamını yaklaşık on dakikada anlatır. Hakkında sayfası ise bir projenin dokümantasyonunu ona emanet etmeden önce Contextator’ın ne yapıp ne yapmadığını anlatır.