MCP yapılandırma oluşturucu
Bir istemci ve kullanmak istediğiniz sunucuları seçin. İstemcinin beklediği biçimde yapılandırmayı, varsa ilgili CLI komutlarını ve çalıştıramayacağı öğeler için bir uyarıyı alın.
{
"mcpServers": {
"github": {
"type": "http",
"url": "https://api.githubcopilot.com/mcp/"
},
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp"
},
"playwright": {
"type": "stdio",
"command": "npx",
"args": [
"@playwright/mcp@latest"
]
}
}
}
Ya da komut satırından ekleyin
claude mcp add --transport http --scope project github https://api.githubcopilot.com/mcp/
claude mcp add --transport http --scope project context7 https://mcp.context7.com/mcp
claude mcp add --scope project playwright -- npx @playwright/mcp@latest
Çıktı nasıl çalışır?
Barındırılan veya yerel
Barındırılan sunucu, istemcinin Streamable HTTP üzerinden bağlandığı bir URL'dir; sağlayıcı sunucuyu çalıştırır ve herhangi bir kurulum gerekmez. Yerel sunucu npx, uvx veya docker aracılığıyla bir alt süreç olarak başlatılır ve makinenizin erişim izinleriyle çalışır. Bir sunucu her iki seçeneği de sunuyorsa oluşturucu önce barındırılan seçeneği belirler; dilerseniz bunu değiştirebilirsiniz.
Gizli bilgiler dosyaya yazılmaz
Oluşturucu hiçbir zaman gerçek bir anahtar yazmaz. Her istemcinin kendi referans söz dizimini kullanır: Claude Code'da ${VAR}, Cursor ve Windsurf'te ${env:VAR}, VS Code'da inputs istemi, Gemini CLI'da $VAR, Codex'te env_vars ve Continue'da ${{ secrets.VAR }}. Diğer istemcilerde doldurmanız için <VAR> yer tutucusu kullanılır.
İlk kullanımda OAuth
Buradaki barındırılan sunucuların çoğunda OAuth ile oturum açarsınız. İstemci ilk kez bağlandığında veya oturum açma adımını çalıştırdığınızda bir tarayıcı açar: Claude Code'da /mcp, codex mcp login, devin mcp login veya openclaw mcp login. Slack, Asana ve HubSpot yalnızca önceden kaydedilmiş istemcileri kabul eder; bu nedenle istemcinizin desteklendiğini kontrol edin.
Düzenlemeden sonra yeniden yükleyin
Claude Desktop dosyasını başlangıçta okur; bu nedenle değişiklikten sonra uygulamadan çıkıp yeniden açın. macOS'ta günlükleri ~/Library/Logs/Claude konumundadır. Yeni bir sunucu başka bir istemcide görünmüyorsa istemciyi yeniden başlatın veya pencereyi yeniden yükleyin. OpenClaw'da openclaw mcp doctor <name> --probe komutu tek bir sunucuyu sınar.
Yapılandırma hakkında sorular
Cursor ve Claude Code için mcp.json nereye konur?
Cursor her proje için projedeki .cursor/mcp.json dosyasını veya ~/.cursor/mcp.json dosyasını okur. Claude Code, proje kapsamı için deponun kökündeki .mcp.json dosyasını okur; yerel ve kullanıcı kapsamındaki ayarları ise ~/.claude.json dosyasında tutar. VS Code .vscode/mcp.json dosyasını, Codex ise JSON yerine ~/.codex/config.toml dosyasını kullanır.
Uzak sunucu neden claude_desktop_config.json dosyasından yüklenmiyor?
Claude Desktop bu dosyadan yalnızca yerel sunucuları alır. Uzak sunucuları Ayarlar > Bağlayıcılar bölümünde özel bağlayıcı olarak eklemeniz, URL'yi yapıştırıp oturum açmanız gerekir. Oluşturucu bu nedenle URL'leri ayrı listeler.
API anahtarlarını commit edilen .mcp.json dosyasının dışında nasıl tutabilirim?
Anahtarı doğrudan yapıştırmak yerine bir ortam değişkenine başvurun. Claude Code ${VAR} ve ${VAR:-default} ifadelerini, Cursor ${env:NAME} ifadesini genişletir; VS Code ise bir inputs girdisi aracılığıyla gizli bilgi isteyebilir. İstemciyi başlatmadan önce değişkeni kabuğunuzda veya gizli bilgi yöneticinizde ayarlayın.
Tek bir MCP yapılandırmasını birden fazla istemcide yeniden kullanabilir miyim?
Değişiklik yapmadan kullanamazsınız: çoğu istemcide en üst düzey anahtar mcpServers iken .vscode/mcp.json dosyasında servers, Zed'de context_servers, Codex'te ise mcp_servers tablolarıdır. Bazı istemciler diğerlerinin dosyalarını içe aktarabilir: VS Code, Claude Desktop, Cursor ve Windsurf yapılandırmalarını bulur; Continue, doğrudan eklenen bir mcp.json dosyasını kabul eder; JetBrains AI Assistant'ta ise Claude'dan içe aktarma seçeneği bulunur.
Windows'ta Claude Desktop'ta npx neden başarısız oluyor?
MCP sunucuları README'si, Windows'ta npx'i cmd üzerinden çalıştırır: command olarak cmd, bağımsız değişkenler olarak /c, npx ve paket. Claude Desktop ve Windows'u seçtiğinizde oluşturucu bu sarmalayıcıyı otomatik olarak uygular.
Bir sunucunun barındırılan sürümünü mü, yerel sürümünü mü kullanmalıyım?
Barındırılan sürüm daha basittir: kurulacak bir çalışma zamanı gerekmez ve OAuth, diskte uzun süre geçerli token'lar tutma ihtiyacını ortadan kaldırır. Sunucunun makinenizdeki dosyalara veya kimlik bilgilerine erişmesi gerekiyorsa ya da Filesystem, Playwright ve AWS API sunucusunda olduğu gibi barındırılan bir endpoint yoksa yerel sürüm uygundur.