| Sorun |
Hata Mesajı |
Neden |
Düzeltme/Sorun Giderme Adımları |
Belirtilmemiş "Araçları getir" hatası |
"MCP sunucusu ayrıntıları getirilemedi. Lütfen tekrar deneyin." (veya Araçları getir düğmesi belirli bir hata mesajı olmadan başarısız olur). |
Connected Console; geçersiz URL, çevrimdışı sunucu veya ağ hatası nedeniyle MCP uç noktanıza gönderilen isteği tamamlayamadı. |
Aşağıdakileri doğrulayın:
- MCP uç nokta URL'nizin doğru olduğundan ve
https:// kullandığından emin olun.
- MCP sunucunuzun çalıştığından emin olun.
- MCP sunucunuza herkese açık internetten erişilebildiğini doğrulayın (Google,
localhost veya özel intranet adreslerine erişemez).
|
MCP sunucusuna erişilemiyor |
"MCP sunucusuna erişilemiyor" |
Google'ın arka ucu, MCP uç noktanızla bağlantı kuramadı. |
Yaygın nedenler ve çözümler şunlardır:
- Güvenlik duvarı kısıtlamaları: Güvenlik duvarınızın veya WAF'ınızın Google'ın giden IP aralıklarını engellemediğinden emin olun.
- API ağ geçidi kuralları: API ağ geçidinizin
POST isteklerini kabul ettiğini ve MCP initialize el sıkışması sırasında Google'ın clientInfo isteklerini reddetmediğini doğrulayın.
- Alt alan adı uyuşmazlığı: Özel bir alt alan adı (ör.
gemini.mcp.company.com) kullanıyorsanız /.well-known/oauth-protected-resource meta verilerinin farklı bir temel alan adına (mcp.company.com) işaret etmek yerine bu alt alan adıyla eşleştiğinden emin olun.
|
Desteklenmeyen MCP aktarımı (HTTP 405) |
"MCP sunucusu isteği reddetti (HTTP 405 Yönteme izin verilmiyor). URL'nin, eski bir SSE uç noktasına değil, POST isteklerini kabul eden bir Streamable HTTP uç noktasına yönlendirdiğinden emin olun." |
Uç nokta URL'si, yalnızca GET isteklerini kabul eden veya JSON-RPC POST isteklerini reddeden eski bir HTTP+SSE uç noktasına yönlendiriyor. |
MCP sunucunuzu ve uç nokta URL'nizi, initialize ve tools/list için POST isteklerini kabul eden MCP Streamable HTTP aktarımını kullanacak şekilde güncelleyin.
|
OAuth korumalı kaynak dosyası eksik |
"MCP sunucusunda /.well-known/oauth-protected-resource dosyası yok" |
Google, OAuth 2.0 korumalı kaynak meta verilerini keşfetmeye (RFC 9728) çalıştı ancak bu işlem başarısız oldu. |
- MCP sunucunuz kimlik doğrulama GEREKTİRMİYORSA: Bu hata genellikle MCP uç nokta URL'sinde yazım hatası veya eksik yol segmenti olduğunda (örneğin,
https://mcp.example.com/mcp yerine https://mcp.example.com) ortaya çıkar ve HTTP 404 veya 500 döndürerek istemcinin OAuth keşfine geri dönmesine neden olur. Tam MCP uç nokta yolunuzun, kimliği doğrulanmamış POST initialize ve tools/list isteklerine HTTP 200 OK döndürdüğünü doğrulayın ve Erişim kimlik bilgileri bölümündeki Sunucunuz yetkilendirme gerektiriyor mu? sorusunun altında Hayır'ı seçin.
- MCP sunucunuz kimlik doğrulama gerektiriyorsa: MCP sunucunuzda, güvenilir yetkilendirme sunucularınızı
authorization_servers dizisinde bildiren geçerli bir /.well-known/oauth-protected-resource JSON dosyası barındırın.
|
OAuth yetkilendirme sunucusu meta verileri eksik veya geçersiz |
"/.well-known/oauth-authorization-server dosyası OAuth sunucusunda yok" veya "geçersiz ya da eksik bir JSON içeriyor" |
OAuth sunucunuz /.well-known/oauth-authorization-server adresinde geçerli bir RFC 8414 meta veri belgesi göstermiyor. |
/.well-known/oauth-authorization-server (veya /.well-known/openid-configuration) adresinde authorization_endpoint ve token_endpoint içeren geçerli bir RFC 8414 keşif belgesi barındırın.- Alternatif olarak, Kimlik bilgileri bölümünde Özel yetkilendirme uç noktası ve Özel jeton uç noktası URL'lerinizi manuel olarak girin.
|
Alan doğrulaması başarısız oluyor |
Alan sertifikası, bir ipucu mesajıyla (HTTP 404, yönlendirmeye izin verilmiyor veya jeton uyuşmazlığı gibi) "Doğrulanamadı" veya "Doğrulama başarısız oldu" ifadesini gösterir. |
Google, https://<domain>/.well-known/google-connected-apps adresindeki sınama jetonunuzu doğrulayamadı. |
- Dosya bulunamadı (HTTP 404): İndirilen
google-connected-apps.json içeriğinin https://<domain>/.well-known/google-connected-apps adresinde (URL yolunda .json uzantısı olmadan) yayınlandığından emin olun.
- Yönlendirmelere izin verilmez: Doğrulama yükünü doğrudan
HTTP 200 OK ile yayınlayın; /.well-known/google-connected-apps adresini başka bir URL'ye yönlendirmeyin.
- Jeton uyuşmazlığı: JSON yanıtının, geliştirici hesabınız için oluşturulan jetonun aynısını içeren
"verification_tokens": ["<YOUR_TOKEN>"] değerini içerdiğini doğrulayın.
|
Dynamic Client Registration (DCR) veya CIMD hatası |
"Dynamic Client Registration (RFC 7591) başarısız oldu", "OAuth sunucusu, Dynamic Client Registration'ı (RFC 7591) desteklemiyor" veya "İstemci Kimliği Meta Veri Belgesi (CIMD) kaydı başarısız oldu" |
Otomatik OAuth istemci kaydı başarısız oldu veya OAuth sağlayıcınız tarafından desteklenmiyor ya da Google'ın yönlendirme URI'leri reddedildi. |
- OAuth sunucunuzun, Sunucu kimlik doğrulama bilgileri (
https://oauth-redirect.googleusercontent.com/r/<app-id>-<sanitized-domain> vb.) bölümünde gösterilen uygulamaya özel altı Google yönlendirme URI'sinin tümünü izin verilenler listesine eklediğinden emin olun. Birçok OAuth 2.1 sunucusunun joker karakter (*) yönlendirme URI'lerini reddettiğini unutmayın.
- OAuth sağlayıcınız CIMD veya RFC 7591 DCR'yi desteklemiyorsa Erişim kimlik bilgileri bölümünde Ön kayıtlı (kullanıcı tarafından yetkilendirilmiş OAuth için) veya Makineler arası (OAuth İstemcisi Kimlik Bilgileri)'ni seçin ve statik bir İstemci kimliği ve İstemci gizli anahtarı sağlayın.
|
OAuth giriş pop-up'ı engellendi veya boş |
"Kimlik doğrulama pop-up'ı tarayıcınız tarafından engellendi" veya OAuth giriş penceresi, araç senkronizasyonu ya da test sırasında düzgün şekilde görüntülenmiyor. |
Tarayıcı pop-up engelleyicileri veya giriş sayfanızdaki katı X-Frame-Options / Content-Security-Policy başlıkları, pop-up akışını engelledi. |
- Tarayıcınızda konsol için pop-up'lara izin verip tekrar deneyin.
- Geliştirici kimlik bilgilerinizle kimlik doğrulayın bölümündeki Erişim kimlik bilgileri'nde, Pop-up aracılığıyla kimlik doğrulama'dan Yönlendirme aracılığıyla kimlik doğrulama (yedek)'ya geçin. Böylece kimlik doğrulama akışı aynı sekmede tam ekran olarak açılır.
|
MCP sunucusu talimatları eksik |
Uyarı mesajı: "MCP sunucunuzda talimat yok. Sunucu şemanıza talimat eklemenizi öneririz." |
MCP sunucunuz, initialize yanıtında instructions alanı döndürmedi. |
- MCP sunucunuzu başlatırken sistem talimatlarını açıkça tanımlayın (sunucu tanımınızdaki
instructions parametresi).
- Durum bilgisiz veya özel HTTP uygulamaları için
instructions alanının, initialize yöntemine ait JSON-RPC yanıt yüküne dahil edildiğinden emin olun, ardından Araçları yeniden senkronize et'i seçin.
|
Kullanıcı arayüzü kaynağı boyut sınırı veya desteklenmeyen MIME türü |
Getirme ile ilgili sorunlar hata kartı: "Toplam kaynak boyutu en fazla 100 MB olabilir." veya "'<uri>' kaynağı için desteklenmeyen MIME türü '<type>'." |
MCP sunucunuz, toplam boyutu sınırı aşan veya desteklenmeyen bir MIME türü kullanan kullanıcı arayüzü kaynakları döndürdü. |
- Sunucunuz tarafından döndürülen tüm manifest kullanıcı arayüzü kaynaklarının toplam boyutunu, sınırı aşmayacak şekilde azaltın.
- Tüm kullanıcı arayüzü kaynaklarının, desteklenen MIME türlerinden birini kullandığından emin olun:
text/html, text/html;profile=mcp-app, text/javascript veya text/css.
|
Simge yükleme işlemi takılıp kalıyor veya "Beklenmeyen Hata" mesajı gösteriliyor |
Uygulama ayrıntıları bölümünde uygulama simgesi yüklenirken yükleme işlemi takılıp kalıyor veya "Beklenmeyen bir hata oluştu. Lütfen tekrar deneyin" (genellikle 4E696748 koduyla birlikte). |
Bu durum genellikle eski bir tarayıcı oturumu, çakışan tarayıcı uzantıları veya önbelleğe alınmış kimlik doğrulama durumundan kaynaklanır. |
Aşağıdaki adımları sırayla deneyin:
- Yeni bir tarayıcı profili kullanın: Temiz bir tarayıcı profili kullanarak yeni bir pencere açın.
- Gizli modu kullanın: Google Connected Console'da gizli tarama penceresinde oturum açın ve simgeyi yükleyin.
- Önbelleği temizleyin: Yeniden denemeden önce tarayıcınızın önbelleğini ve çerezlerini temizleyin. Ayrıca simgenizin 1 MB'tan küçük, geçerli bir 512 piksel × 512 piksel PNG veya JPEG dosyası olduğunu doğrulayın.
|
