MCP istemci yapılandırması başvuru kaynağı
Her MCP istemcisi sunucu yapılandırmalarını farklı bir konumdan, kendi anahtarının altında ve bazen kendi biçiminde okur. Bu tablo her istemcinin yapılandırmayı nerede aradığını, hangi yapıyı beklediğini ve uzak sunucular için OAuth desteği olup olmadığını gösterir.
| İstemci | Yapılandırma dosyası | Üst düzey anahtar | Biçim | Uzak OAuth | CLI ile ekleme |
|---|---|---|---|---|---|
| Claude Desktop | ~/Library/Application Support/Claude/claude_desktop_config.json | mcpServers | json | Evet | Hayır |
| Claude Code | .mcp.json | mcpServers | json | Evet | Evet |
| Cursor | .cursor/mcp.json | mcpServers | json | Evet | Hayır |
| VS Code (GitHub Copilot) | .vscode/mcp.json (key 'servers') or portable .mcp.json (key 'mcpServers') | servers | json | Evet | Evet |
| Windsurf / Devin Desktop | .devin/mcp_config.json (Devin CLI / Devin Local project scope) | mcpServers | json | Evet | Evet |
| Zed | ~/.config/zed/settings.json | context_servers | json | Evet | Hayır |
| OpenAI Codex CLI | .codex/config.toml (trusted projects only) | mcp_servers | toml | Evet | Evet |
| Gemini CLI | .gemini/settings.json | mcpServers | json | Evet | Evet |
| ChatGPT | Yalnızca ayarlar ekranı | — | — | Evet | Hayır |
| OpenClaw | ~/.openclaw/openclaw.json | mcp.servers | json5 | Evet | Evet |
| Cline | ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json | mcpServers | json | Belgelenmemiş | Evet |
| Continue | .continue/mcpServers/<name>.yaml (or drop a Claude/Cursor/Cline-style mcp.json into .continue/mcpServers/) | mcpServers | yaml | Belgelenmemiş | Hayır |
| JetBrains AI Assistant | Yalnızca ayarlar ekranı | mcpServers | json (pasted in UI) | Belgelenmemiş | Hayır |
Kurulumları bozan farklılıklar
VS Code, servers anahtarını kullanır
.vscode/mcp.json girdileri mcpServers yerine servers altında listeler. Bu nedenle Cursor veya Claude yapılandırmasını değiştirmeden yapıştırırsanız dosya yüklenmez. Daha yeni taşınabilir .mcp.json ve ~/.copilot/mcp-config.json dosyaları ise mcpServers kullanır.
Gemini CLI: url değil, httpUrl
Gemini CLI, aktarım türünü alan adına göre belirler. httpUrl, Streamable HTTP anlamına gelir; url eski SSE aktarımını, command ise stdio'yu belirtir. Güncel bir uzak sunucu için httpUrl gerekir.
OpenClaw ve Cline varsayılan olarak SSE kullanır
Uzak bir girdide aktarım türünü belirtmezseniz ikisi de eski SSE'ye geri döner. OpenClaw'da transport değerini streamable-http, Cline'da type değerini streamableHttp olarak ayarlayın.
Claude Code bir type alanı ister
.mcp.json içinde url olup type olmayan bir uzak girdi hataya yol açar. url yanına type http ekleyin; stdio girdilerinde type stdio kullanılır.
Codex TOML kullanır; her sunucu için ayrı tablo gerekir
Codex için JSON dosyası yoktur. config.toml içinde her sunucu kendi [mcp_servers.<name>] tablosunda tanımlanır, args bir TOML dizisidir ve env_vars, kabuğunuzdaki gizli değerleri adlarıyla aktarır.
Continue, YAML listesi bekler
Continue'da mcpServers, ada göre anahtarlanan bir eşleme değil, her birinde name bulunan girdilerden oluşan bir listedir. Her blok dosyasının en üstünde name, version ve schema: v1 da bulunmalıdır.