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

> Her proje tek bir URL'dir. Her istemciye neyin yapıştırılacağı, taşımayı neden hiçbir ayarın seçmediği ve bağlantının gerçekten çalışıp çalışmadığı nasıl anlaşılır.

- Yayın: 2026-09-18
- Tags: mcp, claude-code, cursor, kurulum
- Kaynak: https://contextator.com/tr/blog/ajani-baglama/
- Dil: tr-TR
- Yazar: Muhammet Şafak

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

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

Eklendiğini doğrulayın:

```bash
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`:

```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:

```json
{
  "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.

:::note
MCP endpoint'i, o projeye bir bearer token koyana kadar kimlik doğrulaması istemez. Portu özel bir ağda
tutun ya da projeyi kapatın — bkz.
[Security](https://github.com/Tunedness/Contextator/wiki/Security).
:::

## 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:

```bash
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.