API Gateway:Manajemen Gerbang MCP

Cara kerja

Manajemen layanan MCP mendukung migrasi lancar dari API RESTful ke layanan MCP, akses melalui protokol SSE (Server-Sent Events) dan Streamable HTTP, serta integrasi autentikasi berbasis identitas konsumen untuk mendukung tata kelola API tingkat enterprise.

MCP mendukung modus proxy langsung, yang berlaku untuk layanan yang secara native mendukung protokol MCP. Modus ini memungkinkan komunikasi streaming yang efisien dan pelestarian konteks, sehingga sangat cocok untuk skenario konkurensi tinggi dan koneksi panjang, seperti inferensi AI dan kolaborasi multi-model.

MCP juga dapat diintegrasikan secara mendalam dengan Pusat Registrasi Nacos. Melalui fungsi MCP Router yang disediakan oleh Nacos, MCP menerapkan registrasi layanan, penemuan layanan, dan konversi protokol otomatis, sehingga mendukung peningkatan “tanpa modifikasi” layanan HTTP yang ada menjadi antarmuka protokol MCP. Dikombinasikan dengan gerbang AI Higress, hal ini memungkinkan administrasi dinamis dan perutean cerdas terhadap layanan.

Buat layanan MCP yang dikelola gateway

1. Pada halaman Instances Konsol AI Gateway, pilih wilayah tempat instans Anda berada.

2. Klik ID instans, lalu pilih MCP Management dari panel navigasi sebelah kiri.

3. Klik Create MCP Service. AI Gateway menyediakan dua protokol layanan berikut untuk membuat layanan MCP:

   • Jika backend adalah MCP Server, pilih MCP Service Direct Proxy.

   • Jika backend adalah HTTP Server, pilih HTTP to MCP.

   MCP Service Direct Proxy

   Pilih konfigurasi protokol layanan MCP:

   1. Backend Services

      1. Pilih Service Name dan pilih Terms of Service sebagai MCP.

      2. Pilih MCP Transport sesuai kebutuhan. Dua protokol transport didukung: SSE dan Streamable HTTP.

      3. Masukkan path, yaitu path akses aktual dari server MCP backend. Misalnya, jika titik akhir akses server MCP backend adalah xxx.com/sse, maka path-nya harus /sse. Jika berupa xxx.com/test/sse, maka path-nya harus /test/sse.

   2. MCP Access Point

      1. Pilih nama domain yang digunakan untuk mengakses layanan MCP. Beberapa nama domain dapat dipilih.

      2. Path titik akhir MCP dibentuk dari penggabungan /mcp-servers, /nama layanan MCP, dan path akses aktual server MCP backend. Setelah pembuatan selesai, buka halaman informasi dasar layanan MCP saat ini. Anda dapat melihat alamat titik akhir akses aktual di area Step 1. Generate URL.

   Setelah berhasil dibuat, indikator proxy langsung akan muncul pada kartu layanan MCP.

   HTTP to MCP

   Pilih konfigurasi protokol layanan HTTP:

   1. Backend Services

      1. Pilih Service Name dan pilih Terms of Service sebagai HTTP. Jika Anda belum membuat layanan, buat layanan baru terlebih dahulu. Disarankan menggunakan layanan seperti FC atau DNS untuk pengujian.

      2. Masukkan deskripsi. Deskripsi wajib diisi dan harus mencerminkan tujuan fungsional tool MCP guna meningkatkan pemahaman API dan akurasi pemrosesan AI.

   2. MCP Access Point

      1. Pilih nama domain yang digunakan untuk mengakses layanan MCP. Beberapa nama domain dapat dipilih.

      2. Path titik akhir MCP (SSE) dibentuk dari penggabungan /mcp-servers, /nama layanan MCP, dan /sse.

      3. Path titik akhir MCP (Streamable HTTP) dibentuk dari penggabungan /mcp-servers dan nama layanan MCP.

   Setelah berhasil dibuat, indikator proxy langsung atau HTTP to MCP akan muncul pada kartu layanan MCP.

   Tambahkan tool ke layanan MCP

   Setelah layanan berhasil dibuat, Anda dapat menambahkan tool ke layanan tersebut dengan langkah-langkah berikut:

   1. Klik kartu layanan target, lalu klik Add Tool.

   2. Layanan MCP saat ini mendukung dua metode untuk menambahkan tool:

      File Swagger (disarankan)

      1. Impor Swagger: Unggah file OpenAPI dari komputer lokal Anda atau tempel definisi API ke dalam kotak edit, lalu klik Generate Now.

      2. Konfirmasi pembaruan: Anda dapat melihat file deskripsi tool MCP yang dihasilkan, lalu mengonfirmasi dan memodifikasi informasinya.

      3. (Opsional) Aktifkan autentikasi layanan backend: Anda dapat menambahkan konfigurasi autentikasi. Tabel berikut menjelaskan berbagai metode autentikasi:

         Parameter	Deskripsi
         Basic	Username dan password dikodekan base64 dalam format username:password dan dikirim dalam bidang Authorization pada Header permintaan HTTP.
         Bearer	Klien terlebih dahulu memperoleh token melalui antarmuka logon, biasanya berupa JWT. Token tersebut disertakan dalam header Authorization untuk setiap permintaan berikutnya. Token biasanya bersifat temporary dan tanggal kedaluwarsa dapat diatur.
         API Key	Server menetapkan string unik kepada klien sebagai kredensial akses. Klien mengirimkan string ini melalui header atau parameter kueri pada setiap permintaan.

      Custom YAML

      1. Anda dapat membuat tool MCP secara manual melalui YAML kustom. Untuk informasi lebih lanjut, lihat Referensi bidang konfigurasi HTTP to MCP.

      2. Klik YAML Example. Anda dapat memodifikasi contoh YAML yang dihasilkan.

      3. (Opsional) Aktifkan autentikasi layanan backend: Anda dapat menambahkan konfigurasi autentikasi. Tabel berikut menjelaskan berbagai metode autentikasi:

         Parameter	Deskripsi
         Basic	Username dan password dikodekan base64 dalam format username:password dan dikirim dalam bidang Authorization pada Header permintaan HTTP.
         Bearer	Klien terlebih dahulu memperoleh token melalui antarmuka logon, biasanya berupa JWT. Token tersebut disertakan dalam header Authorization untuk setiap permintaan berikutnya. Token biasanya bersifat temporary dan tanggal kedaluwarsa dapat diatur.
         API Key	Server menetapkan string unik kepada klien sebagai kredensial akses. Klien mengirimkan string ini melalui header atau parameter kueri pada setiap permintaan.

   3. Klik Confirm. Daftar tool dan informasi deskripsinya akan ditampilkan pada tab Tools.