Model Context Protocol (MCP) adalah standar open source untuk menghubungkan aplikasi AI ke sistem eksternal. MCP menetapkan serangkaian entity tertentu dan struktur yang ditentukan, yang bertindak 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 transportasi SSE tidak didukung.
Membuat atau memilih server MCP
Untuk membuat 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. Pertimbangkan untuk mengikuti panduan ini untuk memahami proses secara menyeluruh: Membangun dan Men-deploy Server MCP Jarak Jauh untuk Google Cloud Berjalan dalam Waktu Kurang dari 10 Menit.
Daripada membuat server MCP dari awal, Anda juga dapat menggunakan server MCP yang sudah dibuat, seperti Google Cloud server MCP.
Autentikasi
Alat MCP memiliki opsi autentikasi yang sama dengan alat OpenAPI.
Header kustom
Anda dapat memberikan header HTTP kustom untuk dikirim dalam permintaan ke server MCP. Anda juga dapat menyisipkan variabel dari konteks sesi ke dalam header ini. Untuk mengetahui informasi selengkapnya, lihat Variabel konteks sesi.
Menguji server MCP secara independen
Sebelum menghubungkan agen ke server MCP, sebaiknya uji server MCP secara independen.
Server yang dibuat menggunakan StreamableHttpTransport
diakhiri 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, pertimbangkan untuk menggunakan 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.
Header kustom
Anda dapat menentukan header kustom yang disertakan saat mengirim permintaan HTTP ke server MCP (permintaan daftar alat serta eksekusi alat). Nilai header ini harus diberikan oleh variabel, jadi untuk menentukan header kustom, Anda harus menentukan variabel yang akan berisi nilai header terlebih dahulu. Jika variabel tidak berisi nilai dan tidak ada nilai default saat runtime, header tidak akan disertakan dalam permintaan.
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.
- Anda dapat menentukan header kustom dengan memberikan nama header dan variabel yang digunakan sebagai nilai header.
- Klik Buat.
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 tersebut dapat mengirim permintaan ke server menggunakan identitasnya sendiri.
Sebelum menambahkan alat lain ke agen, sebaiknya uji setidaknya satu alat untuk memastikan informasi autentikasi disiapkan dengan benar.