| Masalah |
Pesan Error |
Penyebab |
Langkah-Langkah Perbaikan/Pemecahan Masalah |
Kegagalan "Alat pengambilan" yang tidak ditentukan |
"Gagal mengambil detail server MCP. Harap coba lagi." (atau tombol Fetch tools gagal tanpa pesan error tertentu). |
Konsol Terhubung tidak dapat menyelesaikan permintaan ke endpoint MCP Anda karena URL tidak valid, server offline, atau error jaringan. |
Verifikasi hal berikut:
- Periksa kembali apakah URL endpoint MCP Anda sudah akurat dan menggunakan
https://.
- Pastikan server MCP Anda berjalan.
- Pastikan server MCP Anda dapat diakses dari internet publik (Google tidak dapat menjangkau
localhost atau alamat intranet pribadi).
|
Server MCP tidak dapat dijangkau |
"Server MCP tidak dapat dijangkau" |
Backend Google tidak dapat membuat koneksi ke endpoint MCP Anda. |
Penyebab dan perbaikan umum meliputi:
- Pembatasan firewall: Pastikan firewall atau WAF Anda tidak memblokir rentang IP keluar Google.
- Aturan gateway API: Pastikan gateway API Anda menerima permintaan
POST dan tidak menolak clientInfo Google selama handshake initialize MCP.
- Subdomain tidak cocok: Jika Anda menggunakan subdomain khusus (seperti
gemini.mcp.company.com), pastikan metadata /.well-known/oauth-protected-resource-nya cocok dengan subdomain tersebut, bukan mengarah ke domain dasar yang berbeda (mcp.company.com).
|
Transport MCP tidak didukung (HTTP 405) |
"Server MCP menolak permintaan (HTTP 405 Method Not Allowed). Pastikan URL mengarah ke endpoint HTTP yang Dapat Di-streaming dan menerima permintaan POST, bukan endpoint SSE lama." |
URL endpoint mengarah ke endpoint HTTP+SSE lama yang hanya menerima permintaan GET atau menolak permintaan POST JSON-RPC. |
Perbarui URL endpoint dan server MCP Anda untuk menggunakan transpor HTTP yang Dapat Di-streaming MCP yang menerima permintaan POST untuk initialize dan tools/list.
|
File Resource yang Dilindungi OAuth tidak ada |
"File /.well-known/oauth-protected-resource tidak ada di server MCP" |
Google mencoba penemuan Metadata Resource yang Dilindungi OAuth 2.0 (RFC 9728), tetapi gagal. |
- Jika server MCP Anda TIDAK memerlukan autentikasi: Error ini biasanya terjadi jika URL endpoint MCP memiliki kesalahan ketik atau segmen jalur yang tidak ada (misalnya,
https://mcp.example.com, bukan https://mcp.example.com/mcp) dan menampilkan HTTP 404 atau 500, sehingga menyebabkan klien beralih ke penemuan OAuth. Pastikan jalur endpoint MCP Anda yang tepat menampilkan HTTP 200 OK ke permintaan POST initialize dan tools/list yang tidak diautentikasi, lalu pilih Tidak di bagian Apakah server Anda memerlukan otorisasi? di Kredensial akses.
- Jika server MCP Anda memerlukan autentikasi: Hosting file JSON
/.well-known/oauth-protected-resource yang valid di server MCP Anda yang mengiklankan server otorisasi tepercaya Anda dalam array authorization_servers.
|
Metadata Server Otorisasi OAuth tidak ada atau tidak valid |
"File /.well-known/oauth-authorization-server tidak ada di server OAuth" atau "berisi JSON yang tidak valid atau tidak lengkap" |
Server OAuth Anda tidak mengekspos dokumen metadata RFC 8414 yang valid di /.well-known/oauth-authorization-server. |
- Hosting dokumen discovery RFC 8414 yang valid di
/.well-known/oauth-authorization-server (atau /.well-known/openid-configuration) yang berisi authorization_endpoint dan token_endpoint.
- Atau, di bagian Kredensial, masukkan URL Endpoint otorisasi kustom dan Endpoint token kustom secara manual.
|
Verifikasi domain gagal |
Sertifikat domain menampilkan "Gagal memverifikasi" atau "Verifikasi gagal" dengan pesan tooltip (seperti HTTP 404, pengalihan tidak diizinkan, atau ketidakcocokan token). |
Google tidak dapat memverifikasi token verifikasi Anda di https://<domain>/.well-known/google-connected-apps. |
- File tidak ditemukan (HTTP 404): Pastikan konten
google-connected-apps.json yang didownload dipublikasikan di https://<domain>/.well-known/google-connected-apps (tanpa ekstensi .json di jalur URL).
- Pengalihan tidak diizinkan: Tayangkan payload verifikasi secara langsung dengan
HTTP 200 OK; jangan alihkan /.well-known/google-connected-apps ke URL lain.
- Token tidak cocok: Pastikan respons JSON berisi
"verification_tokens": ["<YOUR_TOKEN>"] dengan token yang sama persis dengan yang dibuat untuk akun developer Anda.
|
Kegagalan Dynamic Client Registration (DCR) atau CIMD |
"Dynamic Client Registration (RFC 7591) gagal", "Server OAuth tidak mendukung Dynamic Client Registration (RFC 7591)", atau "Pendaftaran Client ID Metadata Document (CIMD) gagal" |
Pendaftaran klien OAuth otomatis gagal atau tidak didukung oleh penyedia OAuth Anda, atau URI Pengalihan Google ditolak. |
- Pastikan server OAuth Anda mengizinkan keenam URI Pengalihan Google khusus aplikasi yang ditampilkan di bagian Server auth credentials (
https://oauth-redirect.googleusercontent.com/r/<app-id>-<sanitized-domain>, dll.). Perhatikan bahwa banyak server OAuth 2.1 menolak URI pengalihan karakter pengganti (*).
- Jika penyedia OAuth Anda tidak mendukung CIMD atau RFC 7591 DCR, pilih Pradaftar (untuk OAuth yang didelegasikan pengguna) atau Machine-to-machine (OAuth Client Credentials) di Access credentials, lalu berikan Client ID dan rahasia klien statis.
|
Pop-up login OAuth diblokir atau kosong |
"Pop-up autentikasi diblokir oleh browser Anda" atau jendela login OAuth gagal ditampilkan dengan benar selama sinkronisasi atau pengujian alat. |
Pemblokir pop-up browser atau header X-Frame-Options/Content-Security-Policy yang ketat di halaman login Anda mencegah alur pop-up. |
- Izinkan pop-up untuk konsol di browser Anda, lalu coba lagi.
- Di Access credentials di bagian Authenticate with your developer credentials, beralihlah dari Authenticate via Pop up ke Authenticate via Redirect (fallback) agar alur autentikasi terbuka dalam mode layar penuh di tab yang sama.
|
Petunjuk server MCP tidak ada |
Pesan peringatan: "Server MCP Anda tidak memiliki petunjuk. Sebaiknya tambahkan petunjuk ke skema server Anda." |
Server MCP Anda tidak menampilkan kolom instructions dalam respons initialize-nya. |
- Tentukan petunjuk sistem secara eksplisit saat melakukan inisialisasi server MCP Anda (parameter
instructions dalam definisi server Anda).
- Untuk implementasi HTTP stateless atau kustom, pastikan kolom
instructions disertakan dalam payload respons JSON-RPC untuk metode initialize, lalu pilih Sinkronkan ulang alat.
|
Batas ukuran resource UI atau jenis MIME yang tidak didukung |
Kartu error Masalah terkait pengambilan: "Ukuran resource kumulatif tidak boleh melebihi 100 MB." atau "Jenis MIME '<type>' tidak didukung untuk resource '<uri>'." |
Server MCP Anda menampilkan resource UI yang ukuran totalnya melebihi batas atau yang menggunakan jenis MIME yang tidak didukung. |
- Kurangi ukuran kumulatif semua resource UI manifes yang ditampilkan oleh server Anda agar tidak melebihi batas.
- Pastikan semua resource UI menggunakan salah satu jenis MIME yang didukung:
text/html, text/html;profile=mcp-app, text/javascript, atau text/css.
|
Upload ikon macet atau "Error Tidak Terduga" |
Saat mengupload ikon aplikasi di Detail aplikasi, upload berhenti di indikator berputar atau menampilkan "Terjadi error yang tidak terduga. Coba lagi" (sering kali dengan kode 4E696748). |
Biasanya disebabkan oleh sesi browser yang sudah tidak berlaku, ekstensi browser yang bertentangan, atau status autentikasi yang di-cache. |
Coba langkah-langkah berikut secara berurutan:
- Gunakan profil browser baru: Buka jendela baru menggunakan profil browser yang bersih.
- Gunakan mode samaran/pribadi: Login ke Konsol Terhubung Google di jendela penjelajahan rahasia dan upload ikon.
- Hapus cache: Hapus cache dan cookie browser Anda sebelum mencoba lagi, dan pastikan ikon Anda adalah PNG atau JPEG 512 px × 512 px yang valid dan berukuran kurang dari 1 MB.
|
