Sorun giderme
Sorunun bağlantı erişimi mi, araç izinleri mi yoksa yukarı akış hizmeti mi olduğunu belirleyin.
İngilizceden otomatik olarak çevrilmiştir. İngilizce aslını oku
2 dakikalık okuma · Müşteri kılavuzu
Başarısız aşamayı belirleyerek başlayın: bağlantıyı eklemek, araçları keşfetmek, bir aracı çalıştırmak veya bir yazıyı doğrulamak. Ayarları değiştirmeden önce zamanı ve kısa bir açıklamayı yakalayın.
Bağlantıya ulaşılamıyor#
Tam olarak atanan uç noktayı ve AI istemcisinin taşıma ve kimlik doğrulama yöntemini destekleyip desteklemediğini kontrol edin. Platform ev adresi bir MCP uç noktası değildir. Normal güvenli bağlantıyı kullanın; Sertifika uyarısını atlamayın.
Aynı atanmış bağlantı daha önce çalıştıysa, en son ne zaman başarılı olduğunu ve istemcide neyin değiştiğini bildirin. Bir değiştirme doğrulanmadan önce çalışan bağlantı ayrıntılarını silmekten kaçının.
Hata referansı#
| Symptom | Ne kontrol etmek için |
|---|---|
401 bağlantı veya keşifte | Eksik, yanlış, süresi dolmuş veya iptal edilmiş kimlik; yanlış başlık veya uç nokta. |
403 bir operasyon için | Kimlik bilgisi kapsamı, araç izni veya yukarı akış hizmet rolü; hangi katmanın onu döndürdüğünü belirleyin. |
429 | İstek ödeneği aşıldı; yeniden deneme gecikmesine saygı gösterin ve istek sıklığını azaltın. |
404 | Uç nokta veya başvurulan kayıt yanlış veya kullanılamıyor olabilir; tam yolu ve bağlamı kontrol edin. |
5xx veya kullanılamıyor | Platform veya upstream servis sorunu; yakalama süresi ve istek aşaması. |
| Geçersiz argümanlar | Gerekli alan, girdi türü, desteklenmeyen ekstra alan veya uyumsuz bir tanımlayıcı. |
| Bağlı ancak beklenen araç yok | Atanan kapsam, etkin olmayan veya doğrulanmamış ekleme veya eski istemci keşfi. |
| Araçlar görünür ancak aramalar başarısız olur | Upstream yetkilendirme, hesap yetkilendirme veya operasyona özel girdi. |
Bunlar teşhis başlangıç noktalarıdır. Bir HTTP hatasının gerçek kaynağı önemlidir; bir hizmetin izin hatası MCP kimlik doğrulamasını zayıflatarak düzeltilmez.
Güvenli bir teşhis sırası#
Uç noktayı onaylayın, araç listesini yenileyin, bunu geçişle karşılaştırın ve üzerinde anlaşılan salt okunur testi çalıştırın. Başarısız olursa, takım adını ve düzeltilen hatayı kaydedin. Sonucu belirsiz olan bir yazma eylemini tekrarlamadan önce durun.
Destek göndermek için ne#
Kullanın destek kontrol listesi. Tam konuşma aktarımını veya anahtar içeren bir yapılandırmayı değil, gizli bilgilerin gizlendiği bir ekran görüntüsünü veya ilgili hata metnini ekleyin.