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?

  1. İstemcinizi, yani kullandığınız asistanı veya düzenleyiciyi seçin.
  2. Sunucuya harf, rakam, tire ve alt çizgiden oluşan bir ad verin.
  3. Yerel bir sunucu için onu başlatan komutu (npx, uvx veya docker gibi), her satıra bir tane olacak şekilde bağımsız değişkenlerini ve API anahtarları gibi ortam değişkenlerini KEY=value biç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.
  4. 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.
  5. 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 mcpServers içinde (Codex'te [mcp_servers]) onların yanına ekleyin.
  6. 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.