MCP sunucuları Claude Desktop'a nasıl bağlanır

Uzak sunucular: özel bir bağlayıcı ekleme

Claude Desktop'ı açın, Ayarlar'a, ardından Bağlayıcılar'a gidin ve Özel bağlayıcı ekle'ye tıklayın. Bir isim verin, sunucu URL'sini yapıştırın ve onaylayın. Uzak MCP kullanan özel bağlayıcılar Free, Pro, Max, Team ve Enterprise planlarında kullanılabilir; Free hesap tek bir özel bağlayıcıyla sınırlıdır. Team ve Enterprise planlarında önce bir organizasyon sahibi bağlayıcıyı organizasyon ayarlarında ekler, üyeler daha sonra kendi Bağlayıcılar sayfalarından etkinleştirir.

OAuth destekleyen sunucular, ilk kullanımınızda tarayıcıda oturum açmanızı ve kapsamları onaylamanızı ister; başka bir şeye gerek yoktur. İsteğe bağlı bir Gelişmiş ayarlar bölümü, önceden kaydedilmiş bir istemci gerektiren sunucular için bir OAuth istemci kimliği ve gizli anahtarı alır; çoğu genel sunucu bunu gerektirmez. HostTracker'ın sunucusu için URL https://mcp.host-tracker.com/mcp'dir; dinamik istemci kaydıyla OAuth kullanır, bu yüzden bağlayıcı yalnızca sizin onayladığınız kapsamları tutar ve yapıştıracak bir anahtar yoktur.

Bağlayıcılar sizin makinenizden değil Anthropic tarafından çalışır, bu yüzden yerel ağınızdaki bir sunucuya erişemezler; claude.ai ve Cowork'ün kullandığı mekanizmayla aynıdır. Az sonra anlatılan yapılandırma dosyası bunun yerel karşılığıdır.

Yerel sunucular: claude_desktop_config.json dosyasını düzenleme

Ayarlar'ı açın, Geliştirici sekmesini seçin ve Yapılandırmayı Düzenle'ye tıklayın. Bu, yapılandırma dosyasını düzenleyicinizde açar; dosya henüz yoksa oluşturur. Dosya macOS'ta ~/Library/Application Support/Claude/claude_desktop_config.json, Windows'ta %APPDATA%\Claude\claude_desktop_config.json konumunda bulunur; Linux beta sürümünde bir yol tahmin etmek yerine Yapılandırmayı Düzenle düğmesini kullanın. Her sunucu, başlatılacak komut ve argümanlarıyla birlikte mcpServers altında bir girdidir:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/username/Desktop",
        "/Users/username/Downloads"
      ]
    }
  }
}

Dosyayı kaydedin, ardından Claude Desktop'ı tamamen kapatıp yeniden başlatın; bir pencereyi kapatmak yeterli değildir, çünkü sunucular uygulama başlarken çalıştırılır. Windows'ta komutun dayandığı çalışma zamanının, örneğin npx için Node.js'in, kurulu olması ve masaüstü uygulamasının gördüğü PATH içinde bulunması gerekir; bir terminalde sorunsuz çalışıp uygulamadan çalışmayan bir sunucu genellikle bir PATH farkından kaynaklanır.

Bir sunucunun yüklendiğini görmek için mesaj kutusunun sol altındaki "Dosya, bağlayıcı ve daha fazlasını ekle" simgesine tıklayın, Bağlayıcılar üzerine gelin ve Bağlayıcıları yönet'i açın; sunucu araçlarıyla birlikte orada listelenir. Eski belgeler buna çekiç simgesi der ve sorun giderme sayfası hala bir başlıkta bu adı kullanır.

Dizindeki eklentiler

Ayarlar, ardından Eklentiler, ardından Eklentilere göz at, eklenti olarak paketlenmiş yerel sunuculardan oluşan derlenmiş bir dizin gösterir; bunlar tek tıkla kurulur ve kendilerini otomatik günceller. İndirilen bir paket, dosya seçilerek Eklenti Kur üzerinden kurulur; bu paketler, daha önceki .dxt adının yerini alan .mcpb biçimini kullanır ve Node.js, Python veya ikili sunucuları sarmalayabilir. Özel olarak dağıtılan paketler kendini otomatik güncellemez ve bir değişiklikten sonra elle yeniden kurulmalıdır.

Hiçbir şey görünmediğinde günlükler nerede

Claude Desktop genel bir bağlantı günlüğü ve her sunucu için bir günlük yazar. macOS'ta bunlar ~/Library/Logs/Claude/ altında mcp.log ve mcp-server-NAME.log olarak bulunur; Windows'ta %APPDATA%\Claude\logs altındadır. Sunucuya özel dosya, eksik bir modülün, hatalı bir yolun veya reddedilen bir kimlik bilgisinin açıkça yazıldığı sunucunun kendi hata çıktısını taşır. Dosya boşsa uygulama komutu hiç başlatamamış demektir; bu da yine PATH'e ya da yapılandırma dosyasındaki bir JSON söz dizimi hatasına işaret eder.

Tek uygulama, iki yüzey

Claude Desktop artık Chat sekmesinin yanında, uygulama içinde Claude Code'u çalıştıran bir Code sekmesi içeriyor. claude_desktop_config.json içinde tanımlanan sunucular hem sohbet yüzeyinde hem de yerel Code sekmesi oturumlarında, ~/.claude.json ve bir projenin .mcp.json dosyasındakilerin yanı sıra kullanılabilir; aynı ad her iki yerde de varsa Code sekmesi masaüstü dosyasındaki tanımı kullanır. Bağımsız komut satırı Claude Code, masaüstü dosyasını okumaz. Sunucuları önce masaüstü uygulamasında kurduysanız ve terminalde de istiyorsanız, claude mcp add-from-claude-desktop bunları macOS ve Windows Subsystem for Linux üzerinde, Claude Code'a MCP sunucusu nasıl eklenir rehberinde anlatıldığı gibi içe aktarır.

İlk bağlayıcı olarak uzak bir izleme sunucusu

Uzak bir sunucu, kurulacak hiçbir şey olmadığı ve yanıt kontrol edilebildiği için bağlayıcı akışının çalıştığını doğrulamanın en hızlı yoludur. HostTracker'ın sunucusunu özel bir bağlayıcı olarak ekleyin, istendiğinde oturum açın ve Claude'a bildiğiniz bir sitenin ayakta olup olmadığını sorun; yanıt bir tahmin yerine HostTracker'ın adlandırılmış konumlardaki kontrol noktalarından çalıştırılan bir kontrolden alıntı yapmalıdır. MCP sunucusu sayfası, anlık kontrollerden durum sayfası güncellemelerine kadar tüm 65 aracı ve her birinin gerektirdiği kapsamları listeler.