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 üç dokümantasyon aracı kazanır: search_docs, list_topics ve read_document. Kurulacak bir eklenti ya da yapıştırılacak bir API anahtarı yoktur. Panodaki Connect an agent bölümü aşağıdaki her parçayı gerçek URL ile doldurulmuş hâlde yazdırır; buradaki sürümlerde proje adı olarak demo kullanılıyor.

Claude Code

claude mcp add --transport http demo-docs http://localhost:3444/mcp/demo

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" }
  }
}

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"]
    }
  }
}

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

Contextator her iki MCP taşımasını da aynı adreste sunar ve istemcinin gönderdiğine göre seçer:

• Streamable HTTP, güncel 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 istemciler için: istemci adrese GET atar, sunucu /mcp/demo/messages?sessionId=… adresini gösteren bir endpoint olayıyla cevap verir.

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.