Menguji, men-debug, dan mengevaluasi di Mode Developer Aplikasi Gemini

Gunakan Mode Developer Aplikasi Gemini untuk menguji server Model Context Protocol (MCP) Anda secara interaktif, mendiagnosis error runtime skema atau runtime, dan mengukur kualitas alat sebelum mengirimkan aplikasi terhubung Anda untuk ditinjau di Konsol Terhubung Google.

Panduan ini mencakup tugas-tugas berikut:

  • Mengaktifkan Mode Developer Aplikasi Gemini di Gemini, membuat aplikasi MCP kustom, dan memverifikasi penemuan alat awal.
  • Men-debug panggilan alat yang gagal, menyinkronkan skema yang diperbarui, dan menguji autentikasi.
  • Simulasikan konteks lingkungan pengguna dan konfigurasikan autentikasi klien.

Untuk pengantar tata letak ruang kerja dan tab inspector, lihat ringkasan Mode Developer Aplikasi Gemini.

Mengaktifkan Mode Developer Aplikasi Gemini

Jika Anda melakukan aktivasi server MCP di Konsol Terhubung Google, aplikasi terdaftar Anda sudah tersedia saat Anda mengaktifkan Mode Developer Aplikasi Gemini, dan Anda dapat melewati Langkah 2. Jika Anda ingin menguji endpoint server MCP HTTPS yang di-deploy langsung di Gemini sebelum mendaftarkannya di konsol, ikuti kedua langkah untuk mengaktifkan Mode Developer Aplikasi Gemini dan menghubungkan server Anda sebagai aplikasi MCP kustom.

Langkah 1: Aktifkan Mode Developer Aplikasi Gemini

  1. Buka Gemini di browser web Anda.
  2. Klik Setelan > Mode Developer Aplikasi Gemini (atau buka langsung gemini.google.com/devmode).

(Opsional) Langkah 2: Buat dan uji aplikasi MCP kustom

Untuk menghubungkan server MCP Anda sebagai aplikasi kustom di Mode Developer Aplikasi Gemini, lakukan hal berikut:

  1. Dalam dialog Choose an app, klik + Create new.
  2. Dalam dialog Connect to an MCP server, masukkan endpoint HTTPS publik server Anda di MCP Server URL (pastikan URL Anda diawali dengan https://, misalnya, https://your-app-link.com/mcp).
  3. Jika server Anda memerlukan kredensial OAuth yang telah didaftarkan sebelumnya, klik Additional settings > Show more untuk memasukkan Client ID dan Client secret OAuth Anda, lalu klik Next.
  4. Dalam dialog konfirmasi keamanan dan privasi, tinjau cara Gemini berinteraksi dengan server MCP kustom Anda:
    • Eksekusi alat: Gemini menjalankan alat server MCP Anda untuk memicu dan menjalankan fungsi yang tersedia guna menangani permintaan Anda.
    • Pengambilan dan pembagian data: Gemini mengambil dan mengelola resource, skema, dan konteks yang diekspos oleh endpoint server MCP Anda, dan dapat membagikan informasi yang dapat diaksesnya berdasarkan setelan Akun Google Anda atau saat berinteraksi dengan aplikasi lain yang terhubung.
    • Kepercayaan dan penghentian koneksi: Pastikan Anda memercayai server MCP dan meninjau kebijakan privasinya sebelum melanjutkan. Anda dapat berhenti menghubungkan server kapan saja dari halaman Aplikasi Terhubung atau menghapus linknya dari koneksi Akun Google Anda.
  5. Pilih Saya memahami serta menerima risiko keamanan dan privasi saat menghubungkan aplikasi kustom ini. Kemudian, klik Hubungkan.
  6. Dalam dialog Save your custom app, masukkan nama tampilan untuk aplikasi kustom Anda, pastikan alat server Anda muncul di daftar Available actions, lalu klik Connect.
  7. Di panel samping Mode Developer Aplikasi Gemini, pilih tab Tool schemas untuk meninjau informasi tentang setiap alat di aplikasi yang terhubung, termasuk definisi parameter, badge keamanan (Read-only, Destructive, Auth-required), Raw schema, dan Response structure.
  8. Di panel chat sebelah kiri, masukkan perintah bahasa alami atau @mention (misalnya, @MyApp show my profile), dan pantau tab log peristiwa untuk melihat cara kerja alat Anda.

Men-debug panggilan alat

Jika panggilan alat gagal atau menghasilkan argumen yang tidak terduga, Anda dapat memeriksa telemetri diagnostik, mengupdate server MCP backend, dan memuat ulang skema secara langsung tanpa menghapus histori percakapan.

Untuk men-debug panggilan alat yang gagal, lakukan hal berikut:

  1. Di panel kanan, pilih tab Log Peristiwa.
  2. Klik peristiwa yang gagal dalam daftar Telemetri untuk meluaskan detailnya dan memeriksa payload permintaan Tool call dan respons Tool result:
    • Error koneksi dan jaringan: Periksa pesan error dan latensi untuk memverifikasi bahwa endpoint Anda dapat dijangkau.
    • Error autentikasi: Jika peristiwa menampilkan 401 atau 403, verifikasi status token OAuth atau kredensial klien Anda di tab Authentication.
    • Ketidakcocokan validasi skema: Jika server menampilkan error parameter tidak valid MCP (-32602), bandingkan argumen JSON yang dihasilkan model di Tool call dengan jenis parameter, properti yang diperlukan, dan petunjuk format di tab Tool Schemas.
    • Pengecualian runtime server: Periksa kode error dan pesan JSON-RPC di Tool result untuk mendiagnosis pengecualian backend.
  3. Untuk mengatasi masalah ini, perbarui implementasi server MCP Anda, atau perbaiki deskripsi alat dan parameter Anda. Untuk panduan tentang cara menulis skema alat dan respons error yang jelas, lihat Standar integrasi aplikasi Terhubung MCP.
  4. Di tab Tool Schemas, klik Sync schema. Gemini mengambil ulang tools/list dari server MCP Anda dan memperbarui definisi alat yang aktif sambil mempertahankan rangkaian percakapan saat ini.
  5. Coba lagi kueri Anda. Di tab Log Peristiwa, pastikan panggilan alat yang diputar ulang menampilkan 200 OK dan merender respons yang diharapkan di pratinjau chat.

Menyimulasikan konteks lingkungan dan autentikasi

Anda dapat menguji respons alat MCP terhadap berbagai lokasi pengguna, zona waktu, lokalitas, dan metode autentikasi langsung di panel inspector.

Mengganti konteks lingkungan

Untuk menyimulasikan konteks pengguna untuk alat yang sensitif terhadap tanggal, waktu, atau lokalitas, lakukan hal berikut:

  1. Di panel kanan, pilih tab Environment.
  2. Di bagian Date and Time, pilih Simulated Date dan Simulated Time untuk menguji ekspresi waktu relatif (seperti "besok pagi" atau "Sabtu sore ini").
  3. Di bagian Preferences, pilih Language untuk menyimulasikan lokalitas pengguna (misalnya, en-US).
  4. Jalankan perintah pengujian di panel chat untuk mengevaluasi alat Anda dengan konteks yang disimulasikan.
  5. Untuk memulihkan setelan lingkungan default, klik Reset.

Mengonfigurasi autentikasi klien

Untuk mengonfigurasi atau beralih metode autentikasi yang digunakan selama sesi Mode Developer Aplikasi Gemini, lakukan hal berikut:

  1. Di panel kanan, pilih tab Authentication.
  2. Di bagian Client Authentication Configuration, pilih salah satu mode autentikasi berikut:
    • Dynamic Client Registration: Menggunakan alur OAuth untuk menegosiasikan kredensial secara otomatis dengan server otorisasi Anda. Untuk informasi selengkapnya, lihat panduan penerapan OAuth 2.1. Jika ada, masukkan endpoint Anda di Tambahkan link aplikasi kustom.
    • Manual Client Registration: Memungkinkan Anda memberikan Client ID dan Client Secret yang telah didaftarkan sebelumnya secara manual. Luaskan Advanced Settings untuk mengonfigurasi penggantian alur tambahan.
  3. Klik Save, dan tunggu hingga pesan Saved muncul. Kemudian, jalankan perintah pengujian untuk memverifikasi bahwa alat yang diautentikasi berhasil.

Referensi lainnya