Ikhtisar#
MCP (Model Context Protocol) adalah protokol terbuka untuk membangun komunikasi terstandardisasi antara aplikasi large language model (LLM) dan sumber data serta alat eksternal. Apidog memiliki MCP Client bawaan yang mendukung debugging dan pengujian MCP Server.MCP Server menyediakan tiga fitur utama, yang semuanya didukung untuk debugging oleh Apidog MCP Client:Tools: Fungsi sisi server yang dapat dieksekusi
Prompts: Templat prompt yang telah ditentukan sebelumnya
Resources: Sumber daya data yang disediakan oleh server
STDIO: Komunikasi melalui standard input/output, sesuai untuk proses lokal
HTTP: Komunikasi melalui Streamable HTTP, sesuai untuk server jarak jauh
Silakan gunakan versi web atau unduh versi terbaru aplikasi desktop dari beranda.
Membuat MCP Client#
Buat endpoint baru dalam proyek HTTP dan pilih MCP.
Menghubungkan ke MCP Server#
Masukkan Alamat Server#
Apidog mendukung beberapa cara untuk memasukkan informasi koneksi MCP Server:Input Perintah atau URL LangsungSaat menempelkan perintah terminal, protokol secara otomatis beralih ke STDIO:Saat menempelkan URL, protokol secara otomatis beralih ke HTTP:https://example-server.modelcontextprotocol.io/mcp
{
"mcpServers": {
"Everything Server": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-everything"],
"env": {}
}
}
}
{
"type": "streamable-http",
"url": "https://example-server.modelcontextprotocol.io/mcp"
}
Membuat Koneksi#
Klik tombol Connect untuk memulai koneksi.Karena eksekusi perintah lokal diperlukan, Apidog akan menampilkan dialog konfirmasi keamanan. Setelah dikonfirmasi, Apidog akan memulai proses lokal dan membuat koneksi.Kirim permintaan koneksi secara langsung ke URL yang ditentukan.Untuk MCP Server dengan autentikasi OAuth 2.0, Apidog akan secara otomatis mengambil konfigurasi autentikasi dan menampilkan jendela autentikasi
Metode autentikasi lain (API Key, Bearer Token, Basic Auth, dll.) juga dapat dikonfigurasi secara manual di tab Auth
Fitur Debugging#
Tools adalah fungsi yang dapat dieksekusi yang disediakan oleh server. Setelah memilih Tool, Anda dapat mengonfigurasi parameter melalui formulir atau editor JSON.Setelah mengonfigurasi parameter, klik Run untuk mengeksekusi. Hasil akan ditampilkan di area respons.Prompts#
Prompts adalah templat prompt yang telah ditentukan sebelumnya. Setelah memilih Prompt, konfigurasikan parameter (jika ada) dan klik Run untuk mendapatkan prompt yang dihasilkan.Resources#
Resources adalah sumber daya data yang disediakan oleh server. Setelah memilih Resource, klik Run untuk mengambil konten sumber daya.
Opsi Konfigurasi#
Lingkungan#
Hanya tersedia untuk mode STDIO. Digunakan untuk mengonfigurasi variabel lingkungan saat memulai proses MCP Server.| Kunci | Nilai |
|---|
| ACCESS_TOKEN | your-token-here |
| NODE_ENV | production |
Auth#
Hanya tersedia untuk mode HTTP. Mendukung beberapa metode autentikasi:Untuk MCP Server yang mendukung OAuth 2.0, Apidog dapat secara otomatis mengambil dan mengisi konfigurasi autentikasi.Hanya tersedia untuk mode HTTP. Digunakan untuk mengonfigurasi header permintaan HTTP khusus.
Melihat Respons#
Setelah mengklik Run, hasil eksekusi alat akan ditampilkan di panel Response. Apidog mengategorikan interaksi menjadi dua jenis: Messages dan Notifications.Messages#
Sebuah Message merepresentasikan interaksi permintaan-respons standar (misalnya, mengeksekusi alat dan menerima hasil).Untuk setiap pesan, Apidog menyediakan tiga mode tampilan untuk membantu Anda memvisualisasikan data. Anda dapat beralih di antaranya menggunakan tab di bagian atas area respons:Content: Tampilan default. Menampilkan output teks yang bersih. Apidog mengurai pesan JSON-RPC dan hanya mengekstrak konten inti yang dikembalikan oleh alat (misalnya, field text), menghapus detail protokol agar lebih mudah dibaca.
Preview: Merender konten kaya yang dikembalikan oleh alat. Jika respons berisi Markdown, gambar, atau sumber daya multimedia lainnya, tab ini secara otomatis merendernya ke dalam format visual (misalnya, teks berformat, bagan, atau gambar Base64 yang didekode). Ini menghilangkan kebutuhan untuk decoding manual atau penguraian teks mentah.
Raw: Menampilkan pesan interaksi JSON-RPC lengkap, termasuk semua detail protokol (seperti struktur jsonrpc, id, dan result). Gunakan mode ini saat melakukan debugging MCP server untuk memverifikasi kepatuhan protokol.
Notifications#
Sebuah Notification merepresentasikan pesan satu arah dari MCP server (misalnya, logging, pembaruan progres, atau perubahan sumber daya) yang tidak memerlukan respons.Notifications dicantumkan secara terpisah dalam linimasa respons.
Notifications biasanya menampilkan level log (misalnya, info, debug, error) dan teks pesan yang menyertainya.
Dukungan Variabel#
Variabel {{variable_name}} didukung di lokasi berikut:Alamat atau perintah server
Nilai variabel lingkungan
Simpan dan Bagikan#
MCP client yang telah dikonfigurasi dapat disimpan ke proyek untuk penggunaan selanjutnya dan kolaborasi tim.Catatan: Pohon direktori MCP (daftar Tools, Prompts, Resources) hanya disimpan secara lokal dan diperbarui secara otomatis pada setiap koneksi.
FAQ#
Koneksi STDIO gagal dengan error "command not found"#
Pastikan runtime yang diperlukan (seperti Node.js) telah diinstal dan periksa bahwa path perintah sudah benar.Koneksi HTTP mengembalikan error 401#
Apidog akan secara otomatis mencoba mengambil konfigurasi OAuth 2.0. Jika gagal, konfigurasikan informasi autentikasi secara manual di tab Auth.Koneksi berhasil tetapi pohon direktori kosong#
Periksa bahwa konfigurasi server sudah benar dan lihat tab Notifications untuk mengonfirmasi apakah server telah mengembalikan daftar alat.Ketidakcocokan tipe parameter#
Saat menggunakan mode formulir, Apidog akan secara otomatis memvalidasi tipe parameter. Dalam mode editor JSON, berhati-hatilah agar tidak menambahkan tanda kutip di sekitar angka dan gunakan true/false untuk nilai boolean.