Model Context Protocol (MCP) adalah standar open source untuk menghubungkan aplikasi AI ke sistem eksternal. MCP menetapkan sekumpulan entitas tertentu dan struktur yang ditentukan, yang berfungsi sebagai cara standar untuk menghubungkan berbagai sumber data dan alat dengan model AI.
Anda dapat menggunakan alat MCP untuk menghubungkan aplikasi agen dengan server MCP yang ada.
Batasan
Batasan berikut berlaku:
- CX Agent Studio hanya mendukung server berbasis StreamableHttpTransport; server transport SSE tidak didukung.
Membangun atau memilih server MCP
Untuk membangun server MCP Anda sendiri, sebaiknya gunakan MCP SDK resmi atau SDK pihak ketiga tepercaya lainnya seperti FastMCP. Setelah server MCP dibuat, deploy ke layanan hosting. Anda dapat menggunakan Cloud Run atau Compute Engine untuk menghosting server MCP. Sebaiknya ikuti panduan ini untuk memahami proses secara menyeluruh: Membangun dan Men-deploy Server MCP Jarak Jauh untuk Google Cloud Dijalankan dalam Waktu Kurang dari 10 Menit.
Daripada membuat server MCP dari awal, Anda juga dapat menggunakan server MCP yang sudah dibuat sebelumnya, seperti server MCPGoogle Cloud .
Autentikasi
Alat MCP memiliki opsi autentikasi yang sama dengan alat OpenAPI.
Menguji server MCP secara independen
Sebelum menghubungkan agen ke server MCP, sebaiknya uji server MCP secara terpisah.
Server yang dibuat menggunakan StreamableHttpTransport
berakhir dengan akhiran (/mcp atau /mcp/).
Misalnya, jika server dihosting di https://example.com,
URL yang benar untuk mengirim permintaan ke server adalah https://example.com/mcp.
Untuk menguji server secara lokal, sebaiknya gunakan curl atau Postman (yang secara native mendukung koneksi MCP). Hal ini memastikan server aktif dan berjalan serta informasi autentikasi yang diperlukan untuk berkomunikasi dengan server dipahami.
Membuat Alat MCP
Untuk membuat alat MCP dari konsol:
- Klik ikon alat di sisi kanan pembuat agen.
- Pilih Alat MCP.
- Berikan nama alat.
- Berikan deskripsi alat.
- Berikan alamat server untuk server MCP.
- Pilih jenis autentikasi.
- Klik Create.
Untuk server yang dihosting di Cloud Run,
opsi autentikasi yang direkomendasikan adalah Token ID Agen Layanan.
Metode ini menggunakan akun layanan CX Agent Studio
(dengan format: service-{PROJECT_NUMBER}@gcp-sa-ces.iam.gserviceaccount.com)
untuk mengirim permintaan
ke tugas Cloud Run.
Berikan
peran Cloud Run Invoker
ke akun layanan CX Agent Studio
, sehingga akun layanan tersebut dapat mengirim permintaan ke server menggunakan identitasnya sendiri.
Sebelum menambahkan alat tambahan ke agen, sebaiknya uji setidaknya satu alat untuk memastikan informasi autentikasi disiapkan dengan benar.