MCP Yapılandırma Oluşturucu
Claude Desktop, Claude Code, Cursor, VS Code, Codex CLI, Gemini CLI veya Devin Desktop (eski adıyla Windsurf) için MCP sunucu yapılandırmasını oluşturun: bir komut ya da sunucu URL'si girin, ardından JSON veya TOML çıktısını ve ekleneceği dosyayı kopyalayın.
Girdi
Çıktı
| Konum | Dosya |
|---|---|
macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
Windows | %APPDATA%\Claude\claude_desktop_config.json |
Linux | ~/.config/Claude/claude_desktop_config.json |
Uzak sunucular | Ayarlar > Bağlayıcılar > Özel bağlayıcı ekle |
Readme
MCP nedir?
Model Context Protocol (MCP), yapay zekâ asistanlarının sunucular aracılığıyla araçları ve verileri kullanmasını sağlayan açık bir standarttır. Sunucu ya asistanın bilgisayarınızda başlattığı ve onunla standart giriş ve çıkış (stdio) üzerinden iletişim kuran yerel bir programdır ya da asistanın HTTP üzerinden eriştiği uzak bir sunucudur. Her asistan sunucularını kendi yapılandırma dosyasında tutar ve her dosya biraz farklı görünür.
Nasıl kullanılır?
- İstemcinizi, yani kullandığınız asistanı veya düzenleyiciyi seçin.
- Sunucuya harf, rakam, tire ve alt çizgiden oluşan bir ad verin.
- Yerel bir sunucu için onu başlatan komutu (
npx,uvxveyadockergibi), her satıra bir tane olacak şekilde bağımsız değişkenlerini ve API anahtarları gibi ortam değişkenleriniKEY=valuebiçiminde girin. Komut alanına bir komut satırının tamamını yapıştırdıysanız alanın içindeki ayırma düğmesi, ilk kelimeden sonraki her şeyi bağımsız değişkenlere taşır. - Uzak bir sunucu için Uzak URL seçeneğine geçin; sunucunun URL'sini ve varsa
Authorization: Bearer <token>gibi başlıkları girin. - Yapılandırmayı Ekleneceği yer altında listelenen dosyaya kopyalayın veya indirin. Dosyada zaten sunucular varsa dosyanın tamamını değiştirmek yerine yeni girdiyi
mcpServersiçinde (Codex'te[mcp_servers]) onların yanına ekleyin. - Uygulamayı yeniden başlatın veya MCP sunucularını yeniden yükleyin.
Claude Code, Codex CLI, Gemini CLI ve VS Code için Komut kutusu, sunucuyu sizin yerinize ekleyen terminal komutunu da verir.
İstemciler
| İstemci | Yapılandırma dosyası | Bilinmesi gerekenler |
|---|---|---|
| Claude Desktop | claude_desktop_config.json |
Yalnızca yerel sunucuları tutar. Uzak sunucular uygulamada Ayarlar > Bağlayıcılar > Özel bağlayıcı ekle bölümünden eklenir. |
| Claude Code | Proje kök dizinindeki .mcp.json |
claude mcp add ise sunucuları yalnızca sizin için ~/.claude.json dosyasına kaydeder. |
| Cursor | Projedeki .cursor/mcp.json veya ~/.cursor/mcp.json |
|
| GitHub Copilot ile VS Code | Çalışma alanı kök dizinindeki .mcp.json veya ~/.copilot/mcp-config.json |
.vscode/mcp.json içindeki eski servers biçimi yalnızca VS Code'un kullanımdan kaldırılan yerel çalıştırma ortamı içindir. |
| Codex CLI | ~/.codex/config.toml |
Bir TOML dosyasıdır. Uzak bir sunucunun başlıkları codex mcp add ile değil, yalnızca dosyada ayarlanabilir. |
| Gemini CLI | Projedeki .gemini/settings.json veya ~/.gemini/settings.json |
Uzak sunucular httpUrl kullanır. |
| Devin Desktop (Windsurf) | ~/.config/devin/mcp_config.json veya .devin/mcp_config.json |
Windsurf'ün adı Devin Desktop olarak değiştirildi. Kişisel anahtarlar, sürüm denetiminin dışında kalan .devin/mcp_config.local.json dosyasına yazılır. |
Chrome, .mcp.json adlı bir indirmeyi mcp.json olarak kaydeder; bu nedenle dosyayı yerine taşırken baştaki noktayı geri ekleyin.
Anahtarları güvende tutma
Yapılandırma dosyaları API anahtarlarını düz metin olarak tutar. Gerçek anahtarlar içeren bir proje dosyasını paylaşılan bir depoya commit etmeyin. Çoğu istemci bir anahtarı dosya yerine ortam değişkenlerinizden okuyabilir; her birinin kendi söz dizimi vardır ve bu söz dizimi istemcinin belgelerinde açıklanır.
Her şey tarayıcınızda bir araya getirilir; bu nedenle girdiğiniz komutlar, URL'ler ve anahtarlar hiçbir yere gönderilmez.