View a markdown version of this page

Gunakan MCP Inspector - Batuan Dasar Amazon AgentCore

Gunakan MCP Inspector

MCP Inspector, tersedia melalui Model Context Protocol (MCP), adalah alat pengembang yang membantu Anda menguji dan men-debug server MCP melalui antarmuka interaktif. Anda dapat menghubungkan AgentCore gateway Anda ke inspektur MCP untuk membantu Anda men-debug target gateway Anda.

Untuk informasi lebih lanjut tentang MCP Inspector, lihat dokumentasi MCP Inspector.

Untuk menghubungkan gateway Anda ke inspektur

  1. Buka terminal dan jalankan npx @modelcontextprotocol/inspector untuk melakukan hal berikut:

    1. Instal inspektur

    2. Mulai inspektur di localhost.

    3. Hasilkan token sesi untuk otentikasi.

    4. Buka browser Anda ke antarmuka inspektur.

  2. Di antarmuka inspektur, konfigurasikan bidang berikut:

    • Jenis Transportasi - Pilih HTTP Streamable

    • URL — Masukkan URL titik akhir gateway yang dikembalikan saat Anda membuat gateway.

    • Perluas Otentikasi. Bagian Custom Header harus diisi sebelumnya dengan satu pasangan kunci-nilai.

      • Nama kuncinya seharusnyaAuthorization.

      • Ganti nilainya dengan kredensi otorisasi masuk gateway Anda.

  3. Pilih Hubungkan. Anda akan terhubung ke gateway Anda. Anda dapat menggunakan MCP Inspector sebagai alat untuk memeriksa dan menguji gateway Anda sebelum mengintegrasikannya dengan agen Anda.

Untuk informasi selengkapnya tentang cara memeriksa server MCP yang terhubung dengan gateway Anda, lihat Ikhtisar fitur di ikhtisar Fitur dalam dokumentasi MCP Inspector.

penting

MCP Inspector adalah alat pengembangan dan tidak boleh digunakan dalam lingkungan produksi. Selalu amankan token akses dan kredenal gateway Anda.

Pemecahan masalah

Jika Anda mengalami masalah saat menggunakan MCP Inspector dengan gateway Anda, periksa hal berikut:

  • Masalah koneksi: Pastikan URL gateway Anda benar dan dapat diakses dari jaringan Anda

  • Masalah otentikasi: Verifikasi bahwa token akses Anda valid dan belum kedaluwarsa

  • Kesalahan pemanggilan alat: Periksa pesan kesalahan dalam respons dan pastikan parameter input Anda cocok dengan skema alat

  • Kesalahan proxy: Jika Anda melihat kesalahan yang terkait dengan koneksi proxy, coba mulai ulang MCP Inspector