Ringkasan Model Context Protocol

Dokumen ini memberikan ringkasan dukungan Model Context Protocol (MCP) di Gateway API.

API Gateway dapat bertindak sebagai server MCP jarak jauh, sehingga Anda dapat mengekspos REST API yang ada ke agen AI dan LLM tanpa menulis ulang layanan backend.

Latar belakang

Model Context Protocol (MCP) adalah standar terbuka yang memungkinkan Anda membangun agen AI langsung terhadap infrastruktur yang sudah ada. Alih-alih menulis kode integrasi kustom untuk setiap alat atau API, MCP menyediakan cara standar bagi model AI untuk menemukan dan memanggil fungsi di lingkungan Anda.

Saat dikonfigurasi sebagai server MCP, Gateway API bertindak sebagai proxy. Layanan ini menerjemahkan pesan protokol JSON-RPC MCP standar yang dikirim dari sistem berbasis agen menjadi permintaan HTTP REST standar ke backend yang ada.

Fitur yang didukung

Selama Pratinjau Publik, Gateway API mendukung fitur MCP berikut:

  • Server MCP jarak jauh: Gateway API bertindak sebagai server jarak jauh, yang menerima permintaan MCP melalui HTTP (POST).
  • Integrasi OpenAPI 3.x: Konfigurasi MCP berasal langsung dari spesifikasi OpenAPI 3.x Anda menggunakan ekstensi kustom.
  • Metode siklus proses MCP yang didukung:
    • initialize: Menetapkan versi dan kemampuan protokol.
    • notifications/initialized: Mengonfirmasi handshake.
    • tools/list: Memungkinkan klien menemukan alat yang tersedia dan skemanya.
    • tools/call: Memungkinkan klien memanggil alat dengan argumen.

Batasan

Batasan berikut berlaku untuk dukungan MCP di Gateway API:

  • Sumber (resources/*) dan Perintah (prompts/*) tidak didukung.
  • Transportasi Stdio tidak didukung.
  • OpenAPI 2.0 tidak didukung.
  • Panggilan alat streaming atau yang berjalan lama tidak didukung.
  • Pengecualian Bersama Perutean Model: Anda tidak dapat mengaktifkan MCP dan Perutean Model dalam konfigurasi API yang sama. Jika x-google-api-management.mcp diaktifkan, x-google-model-router tidak dapat digunakan.

Untuk mengetahui daftar lengkap batasan teknis, lihat Batasan fitur OpenAPI 3.x.

Kasus penggunaan

  • Mengekspos REST API yang ada sebagai alat MCP: Ubah API yang ada menjadi alat yang siap AI tanpa mengubah kode backend.
  • Pilih alat per operasi: Pilih secara eksplisit jalur dan metode API yang diekspos ke agen.
  • Lindungi permukaan alat: Terapkan kebijakan keamanan Gateway API yang ada (seperti kunci API atau OAuth) ke endpoint MCP Anda.

Alur permintaan

Jalur kanonis untuk permintaan MCP adalah <basepath>/mcp, dengan <basepath> berasal dari URL gateway atau konfigurasi x-google-endpoint Anda.

Diagram berikut menunjukkan alur permintaan untuk permintaan MCP tools/call:

  1. Klien MCP (misalnya, agen AI) mengirim permintaan JSON-RPC ke endpoint MCP gateway (misalnya, POST /mcp atau POST /v1/mcp jika awalan versi digunakan).
  2. Gateway memvalidasi permintaan dan memeriksa autentikasi.
  3. Gateway memeriksa payload untuk menentukan alat mana yang sedang dipanggil.
  4. Gateway menerjemahkan payload MCP menjadi permintaan HTTP standar (jalur, parameter, isi) berdasarkan pemetaan yang ditentukan dalam konfigurasi API.
  5. Gateway meneruskan permintaan ke layanan backend.
  6. Backend menampilkan respons HTTP standar.
  7. Gateway menerjemahkan respons HTTP kembali menjadi respons MCP JSON-RPC dan menampilkannya kepada klien.

Penemuan melalui API Hub dan Agent Registry

Jika Anda mengintegrasikan gateway dengan hub API, gateway yang mendukung MCP akan dipublikasikan ke hub API sebagai server MCP dengan metadata khusus MCP tambahan, dan juga akan muncul di Agent Registry secara otomatis.

Untuk gateway tanpa MCP yang diaktifkan, metadata API standar akan dipublikasikan. Hanya gateway yang mengaktifkan MCP yang akan menampilkan konfigurasi MCP tambahan ini di hub API.

Tidak diperlukan langkah pendaftaran terpisah. Agen kemudian dapat menemukan server dan alatnya melalui salah satu katalog.

Untuk membuat kueri Agent Registry, aktifkan API-nya di project Anda:

gcloud services enable agentregistry.googleapis.com

Langkah berikutnya