MCP sunucusunu kullanma

Bu kılavuz, harici bir MCP istemcisini — Claude Code, bir düzenleyici veya MCP Inspector — Control Center’ın kendi araç sunucusuna nasıl bağlayacağınızı gösterir.

Control Center 110 araç kaydeder ve bunları Model Context Protocol üzerinden, 2024-11-05 protokol sürümünde sunar. Bekleyebileceğiniz bazı araç aileleri yoktur: toplantı veya takvim araçları ve proje araçları bulunmaz.

Uç noktayı bulma

MCP yüzeyi, ana cc_server dinleyicisini paylaşır. Ayrı bir MCP portu yoktur.

Uç nokta	Yöntem	Amaç
/mcp	POST	Streamable HTTP taşıması — bir istemcinin konuştuğu şey budur
/mcp	DELETE	Bir oturumu sonlandırır
/sse	GET	Sunucudan gönderilen bildirim akışı

Yani varsayılan bir yerel kurulum http://127.0.0.1:9030/mcp adresindedir.

1. Ayarlar → Sunucu → MCP sunucuları sayfasına gidin
2. MCP sunucusu kartını okuyun — kart, sunucunun çalışıyor mu durduruldu mu olduğunu ve dinlediği portu gösterir

Yüzey, yeni bir kurulumda varsayılan olarak açıktır; bu yüzden bir loopback istemcisi hiçbir ayara dokunmadan çalışır. Uygulama açılışında başlat, yeniden başlatmadan sonra geri gelip gelmeyeceğini denetler; Başlat / Durdur ise bu tercihi değiştirmeyen oturum denetimleridir.

Sunucu varsayılan olarak loopback’e bağlanır; bu nedenle, --bind any ile başlatmadığınız sürece uç noktaya yalnızca cc_server’ın çalıştığı makineden erişilebilir.

Bir istemci bağlama

İstemcinizi Streamable HTTP uç noktasına yöneltin. Yapılandırmanın tam şekli istemcinizin işidir; URL her iki durumda da aynıdır.

{
  "mcpServers": {
    "control-center": {
      "type": "http",
      "url": "http://127.0.0.1:9030/mcp"
    }
  }
}

Claude Code

Claude Code bunu bir projedeki .mcp.json dosyasından almaz — proje kapsamlı MCP sunucularını, etkileşimsiz bir claude -p çalıştırmasının asla yanıtlamayacağı bir onay isteminin arkasına koyar. Yapılandırmayı açıkça geçin:

claude --mcp-config /path/to/mcp.json --strict-mcp-config

--strict-mcp-config, Claude’un yalnızca o dosyayı kullanmasını sağlar; böylece aynı sunucu projeden de keşfedilip iki kez kaydedilmez.

Kontrol noktası: istemciden araçlarını listelemesini isteyin. Biletleri, alanları, belleği, kod grafiğini ve incelemeyi kapsayan mcp__* girdileri görmelisiniz.

MCP’yi ana makine dışına sunma

1. Ayarlar → Sunucu → MCP sunucuları sayfasında, Kimlik doğrulama token’ı satırında Ayarla’ya basın ve bir token yapıştırın
2. Her POST /mcp isteğinde bunu Authorization: Bearer <token> olarak gönderin

Token’sız bir yüzey, loopback dışından gelen her çağrıyı 403 ile reddeder. Bu, tasarım gereği reddetme yönünde çalışır: ana makine dışına hizmet vermeyi asıl mümkün kılan şey token’dır.

Token değişiklikleri canlı yüzeye anında uygulanır — yeniden başlatma gerekmez.

GET /sse token’ı sorgu dizesinde alır

Bildirim akışı da diğer tüm rotalar gibi token denetiminden geçer, ancak bir tarayıcı EventSource’u bir Authorization başlığı gönderemez — bu yüzden /sse token’ı ?token=<token> olarak da kabul eder. Token olmadan 401 yanıtı verir.

Her çağrıyı bir çalışma alanına kapsamlandırma

Çalışma alanı kapsamlı verilere dokunan her araç workspace_id gerektirir; bu değer olmadan yapılan bir çağrı, herhangi bir “geçerli” çalışma alanına göre çözülmek yerine reddedilir:

{
  "workspace_id": "acme",
  "title": "Fix login bug",
  "priority": "high"
}

Bu kimlik, tarayıcınızın veya uygulamanın URL’sindeki kimliktir: /workspaces/<workspace_id>/…. Tek istisnalar, gerçekten çalışma alanlarını aşan araçlardır; örneğin list_workspaces ve haber akışı araçları — haber akışı kullanıcı başına olduğundan ve bir ajanın kendine ait bir kullanıcısı bulunmadığından, bu araçlar sunucu sahibinin akışları üzerinde çalışır.

Depo kapsamlı araçlar ayrıca deponun o çalışma alanına bağlı olduğunu denetler.

Yüzeyin neyi reddedeceğini bilme

• Mod kapılaması. Bir çağrı, sunucu tarafında çağıran ajanın alanının moduna göre çözülür. Salt okunur bir moddaki bir ajan, space_id değerini atlayarak bir yazma aracına ulaşamaz — mod bunun yerine etkin çalıştırmasından bulunur.
• Eylem korumaları. Değişiklik yapan araçlar etki sınıflarını bildirir ve ürünün geri kalanının kullandığı aynı politikadan geçer. Bkz. Korumaları yapılandırma.
• Onay. Bazı yıkıcı araçlar, çağrı ilerlemeden önce onaylanması gereken bir onay yükü oluşturur.

Tam katalog, tools/list içinde hiçbir keşif kapılaması olmadan duyurulur — harici bir MCP istemcisi, önbelleğe aldığı listesinde bulunmayan bir aracı çağırmayı reddeder; dolayısıyla araçları gizlemek, onları düzenlemek yerine bozar.

Sorun giderme

İstemci hiç araç görmüyor

• MCP sunucusu kartının çalışıyor gösterdiğini kontrol edin
• Portun cc_server portunuzla eşleştiğini kontrol edin
• Claude Code’da --mcp-config ve --strict-mcp-config seçeneklerini geçtiğinizi kontrol edin

Sunucu olmayan bir makineden 403

Yapılandırılmış bir bearer token yok. Bir tane ayarlayın ve gönderin.

Bir araç çağrısı “Missing or invalid argument: workspace_id” hatasıyla başarısız oluyor

workspace_id ekleyin. Örtük bir çalışma alanı yoktur.

Bir araç çağrısı bilinmeyen olarak reddediliyor

MCP araçları kataloğu listeler. Adı, orada göründüğü şekilde tam olarak çağırın.

İlgili kılavuzlar

• MCP araçları
• Korumaları yapılandırma
• Headless bir sunucu çalıştırma

İlgili kavramlar

• Mimari