MCP bağlantısının kurulması, sunucunun kullanmak istediğiniz aracı sunduğunu göstermez. Bağlantı, yetki ve araç keşfi ayrı aşamalardır. Sunucu yalnız kaynak veya hazır istem sağlayabilir; böyle bir bağlantıda dosya okuma ya da kayıt oluşturma aracı beklemek yanlış olabilir.
Yerel sunucuda çalıştırılacak paket veya komutun güvenilir kaynaktan geldiğini doğrulayın. Bağlantı sorununu çözmek için rastgele bir kurulum betiğini çalıştırmak, MCP protokolünü düzeltmekle aynı şey değildir.
Beklenen yeteneği doğrulayın
Önce sağlayıcının sunduğu araç adını ve hangi hesap kapsamında kullanılabildiğini bulun. Bir doküman arama bağlantısı, aynı üründe belge düzenlemeyi de desteklemek zorunda değildir. İstemcinin desteklediği MCP yetenekleri de sonucu etkiler; sunucudaki her özellik her uygulamada aynı arayüzle görünmeyebilir.Bağlantıyı katman katman kontrol edin
- Sunucu türünü belirleyin. Yerel stdio sunucusu istemci tarafından çalıştırılan bir süreçtir; uzak HTTP sunucusu ise bir ağ adresine bağlanır. Uzak sunucu adresini yerel komut alanına yazmayın.
- Başlatma veya bağlantı günlüğünü okuyun. Süreç bulunamadı, kimlik doğrulama reddi ve araç listesi boş hatalarını ayırın. Bunlar farklı düzeltmeler gerektirir.
- Mevcut yetenekleri listeleyin. İstemcinin gösterdiği araç, kaynak ve istem listesini kontrol edin. Beklenen araç adını sağlayıcının gerçek listesiyle karşılaştırın.
- Hesap ve kapsamı doğrulayın. Yanlış çalışma alanına bağlı hesap, doğru sunucuda da istenen veriyi göstermez. Gerekli izin yalnız okumaysa yazma yetkisini çözüm diye eklemeyin.
- Bağlantıyı yenileyip küçük okuma deneyin. Ayar değiştiğinde istemcinin araç listesini yeniden aldığından emin olun. Önce tek bir bilinen kaydı aratın; sonucu gerçek kaydın adıyla eşleştirin.
Araç listede var, çağrı yine başarısızsa
Bu durumda araç keşfi geçmiş, fakat çağrı girdisi veya hizmet koşulu başarısız olmuş olabilir. Zorunlu alanları, kimlik türünü ve izin verilen kaynağı kontrol edin. Gövdesinde kullanıcı verisi bulunan hata günlüğünü paylaşmadan önce hassas alanları temizleyin.Yerel sunucuda çalıştırılacak paket veya komutun güvenilir kaynaktan geldiğini doğrulayın. Bağlantı sorununu çözmek için rastgele bir kurulum betiğini çalıştırmak, MCP protokolünü düzeltmekle aynı şey değildir.
