Claude Code'a MCP sunucusu nasıl eklenir

HTTP üzerinden uzak bir sunucu ekleme

Uzak bir sunucu bir URL'den ibarettir. Claude Code onunla streamable HTTP üzerinden konuşur, bu yüzden kayıt işleminin tamamı tek satırdır:

claude mcp add --transport http hosttracker https://mcp.host-tracker.com/mcp

Transport'tan sonraki ilk argüman /mcp içinde ve araç adlarında göreceğiniz isimdir; ikincisi ise uç noktadır (endpoint). OAuth ile kimlik doğrulayan sunucular komut satırında başka bir şeye ihtiyaç duymaz: /mcp'yi ilk açtığınızda sunucuyu seçersiniz, Claude Code tarayıcıyı oturum açma ve izin adımı için açar, ardından elde edilen token'ı saklar ve kendi kendine yeniler. Claude Code 2.1.186'dan itibaren oturum açmayı etkileşimli oturum dışında da claude mcp login hosttracker ile çalıştırabilirsiniz; tarayıcısı olmayan bir makinede başka bir yerde yapıştırmak üzere bir URL almak için --no-browser ekleyin.

Statik bir token bekleyen sunucular bunu bir başlık (header) olarak alır:

claude mcp add --transport http secure-api https://api.example.com/mcp --header "Authorization: Bearer YOUR_TOKEN"

Birkaç eski sunucu hala SSE transport'unu konuşuyor. Bu, HTTP lehine kullanımdan kaldırılmıştır ve Claude Code 2.1.265'ten itibaren --transport http önce HTTP'yi dener, sunucu reddederse SSE'ye geri döner; bu yüzden --transport sse'ye artık nadiren ihtiyacınız olur.

Yerel bir sunucu ekleme

Yerel bir sunucu, Claude Code'un sizin için başlattığı ve standart girdi/çıktı üzerinden konuştuğu bir programdır. Komutunu ve argümanlarını çift tireden sonra yazın, böylece Claude Code'un kendi bayrakları sunucununkilerle karışmaz:

claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/projects

Sunucunun ihtiyaç duyduğu ortam değişkenleri --env (kısa hali -e) üzerinden geçilir, her değişken için bir kez tekrarlanır. Belgelenmiş bir tuzak: seçenek ayrıştırıcı, --env KEY=value'dan sonra geleni başka bir çift olarak okur, bu yüzden sunucu adını doğrudan ondan sonra koymayın; arasına başka bir seçenek yerleştirin ya da --env'i --transport'tan önce koyun:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable -- npx -y airtable-mcp-server

Sunucunun yapılandırması elinizde zaten JSON olarak varsa, örneğin README'sinden, claude mcp add-json <name> '<json>' bunu type, command, args ve env dahil olduğu gibi alır.

Kapsam seçimi: bu proje, ekip veya her yer

Varsayılan olarak bir sunucu yerel (local) kapsamda eklenir; bu yalnızca bu proje anlamına gelir ve kendi ~/.claude.json dosyanızda saklanır. İki kapsam daha vardır:

• --scope project girdiyi depo kökündeki bir .mcp.json dosyasına yazar. Bunu commit ederseniz her katkıda bulunan aynı sunucuya sahip olur; Claude Code her kişiden ilk seferinde onay ister.
• --scope user sunucuyu makinenizdeki her projede kullanılabilir hale getirir, yine de yalnızca size özeldir.

Aynı ad birden fazla kapsamda varsa yerel, proje kapsamına üstün gelir; proje kapsamı da kullanıcı kapsamına üstün gelir. Girdinin tamamı kazanan kapsamdan alınır; alanlar kapsamlar arasında asla birleştirilmez. Mantıklı bir ayrım, izleme veya destek talebi sunucusu gibi kendi hesabınıza bağlı hizmetler için --scope user, tüm ekibin paylaşması gereken araçlar için --scope project kullanmaktır.

Çalıştığını kontrol etme

claude mcp list komutunu bir oturumun dışında çalıştırın. Her sunucu birkaç durumdan birini yazdırır: bağlandı, kimlik doğrulama gerekiyor, bağlantı başarısız (2.1.219'dan itibaren HTTP durumu veya hata mesajı eklenmiş olarak), onaylanmamış bir proje sunucusu için onay bekliyor, ya da bu proje için devre dışı. Bir oturum içinde /mcp aynı sunucuları araç sayılarıyla birlikte gösterir; ihtiyacı olan bir sunucu için oturum açmayı başlatmanıza, kimlik doğrulamasını temizlemenize ya da kaldırmadan mevcut proje için devre dışı bırakmanıza izin verir.

Hızlı bir işlevsel test, yalnızca sunucu tarafından yanıtlanabilecek bir istektir. HostTracker sunucusu bağlıyken "hangi monitörlerim şu an çökük?" ya da "example.com üzerinde üç konumdan bir HTTP kontrolü çalıştır" diye sorun; asistan sunucunun adını taşıyan bir aracı çağırmalı ve bilemeyeceği bir sonucu alıntılamalıdır. Hiçbir şey olmuyorsa neden genellikle araç listesidir: /mcp, bağlanmış ama yetkilendirmesi başarısız olmuş bir sunucu için sıfır araç gösterir.

Kaldırma, inceleme ve içe aktarma

claude mcp get <name> bir sunucunun tam yapılandırmasını ve kapsamını yazdırır. claude mcp remove <name> onu saklanan tüm OAuth token'larıyla birlikte siler. Sunucuları önce Claude Desktop'ta kurduysanız claude mcp add-from-claude-desktop bunları etkileşimli olarak içe aktarır; macOS'ta ve Windows Subsystem for Linux'ta çalışır, yerel Windows veya yerel Linux'ta çalışmaz, ve adı Claude Code'un izin vermediği karakterler içeren bir Desktop sunucusunu atlar (yalnızca harfler, rakamlar, tire ve alt çizgiye izin verilir).

İlk test olarak bir izleme sunucusu

Bir izleme hizmeti bağlanacak ilk sunucu için iyi bir seçimdir, çünkü bir araç çağrısının sonucu anında doğrulanabilir: asistan bir sitenin ayakta olduğunu söyler, siz de gidip açabilirsiniz. HostTracker'ın sunucusu yerel kurulum gerektirmez, tarayıcıda OAuth ile kimlik doğrular ve 300'den fazla konumdan anlık kontrollerin yanı sıra hesabınızdaki monitörleri, olayları, bakım pencerelerini ve durum sayfalarını da sunar; böylece "üretim ayakta mı?" sorusu eğitim verisinden değil gerçek kontrol noktalarından yanıtlanır. İlgili .mcp.json yapılandırması ve sorun giderme rehberi dosya biçimini, ortam değişkenlerini ve pratikte karşılaşılan hataları ele alır.