MCP (Model Context Protocol) adalah protokol sumber terbuka yang dirancang untuk menstandarkan cara aplikasi menyediakan konteks kepada Large Language Models (LLM). Protokol ini berfungsi mirip dengan "antarmuka USB-C" untuk aplikasi AI, memungkinkan model terhubung secara fleksibel dan aman ke berbagai sumber data dan alat. Topik ini menjelaskan cara membuat layanan MCP yang dikelola gerbang.
Ikhtisar
Manajemen layanan MCP mendukung migrasi lancar API RESTful ke layanan MCP, akses melalui protokol SSE (Server-Sent Events) dan Streamable HTTP, serta integrasi autentikasi berbasis identitas konsumen untuk memberikan dukungan teknis bagi tata kelola API tingkat perusahaan.
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, terutama 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, mendukung peningkatan "tanpa modifikasi" layanan HTTP yang ada menjadi antarmuka protokol MCP. Dikombinasikan dengan gerbang AI Higress, MCP memungkinkan administrasi dinamis dan perutean cerdas layanan.
Buat layanan MCP yang dikelola gerbang
Pada halaman Instances Konsol AI Gateway, pilih wilayah tempat instans Anda berada.
Buka halaman instans tujuan dan pilih MCP Management dari panel navigasi sebelah kiri.
Klik Create MCP Service. AI Gateway menyediakan dua protokol layanan berikut untuk membuat layanan MCP:
Jika backend adalah MCP Server, pilih protokol MCP.
Jika backend adalah HTTP Server, pilih protokol HTTP to MCP.
MCP direct proxy
Pilih konfigurasi protokol layanan MCP:
Layanan backend:
Pilih Service Name dan atur Service Protocol sebagai MCP.
Pilih MCP Transport sesuai kebutuhan. Dua protokol transport didukung: SSE dan Streamable HTTP.
Masukkan path, yaitu path akses aktual server MCP backend. Misalnya, jika titik akhir akses server MCP backend adalah xxx.com/sse, maka path-nya harus /sse. Jika xxx.com/test/sse, maka path-nya harus /test/sse.
Titik akhir MCP:
Pilih nama domain yang digunakan untuk mengakses layanan MCP. Beberapa nama domain dapat dipilih.
Path titik akhir MCP disusun dari /mcp-servers, /nama layanan MCP, dan path akses aktual server MCP backend. Setelah pembuatan, 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, identifikasi proxy langsung akan muncul pada kartu layanan MCP.
HTTP to MCP
Pilih konfigurasi protokol layanan HTTP:
Layanan backend:
Pilih Service Name dan atur Service Protocol sebagai HTTP. Jika Anda belum membuat layanan, Anda perlu membuat yang baru. Kami merekomendasikan penggunaan layanan seperti FC atau DNS untuk pengujian.
Masukkan deskripsi. Deskripsi wajib diisi dan menunjukkan tujuan fungsional alat MCP guna meningkatkan pemahaman API dan akurasi pemrosesan AI.
Titik akhir MCP:
Pilih nama domain yang digunakan untuk mengakses layanan MCP. Beberapa nama domain dapat dipilih.
Path titik akhir MCP (SSE) disusun dari /mcp-servers, /nama layanan MCP, dan /sse.
Path titik akhir MCP (Streamable HTTP) disusun dari /mcp-servers dan nama layanan MCP.
Setelah berhasil dibuat, identifikasi proxy langsung atau HTTP to MCP akan muncul pada kartu layanan MCP.
Tambahkan alat ke layanan MCP
Setelah berhasil dibuat, Anda dapat menambahkan alat ke layanan tersebut. Prosedurnya sebagai berikut:
Klik kartu layanan target, lalu klik Add Tool.
Layanan MCP saat ini mendukung dua metode untuk menambahkan alat:
Metode 1:Based On Swagger File (recommended)
Import Swagger To Create Or Incrementally Update MCP Tools: Unggah file OpenAPI dari komputer lokal Anda atau tempel definisi API ke dalam kotak edit, lalu klik Generate Now.
Update And Confirm MCP Tool List: Anda dapat melihat daftar alat MCP yang dihasilkan dan selanjutnya mengonfirmasi serta memodifikasi informasinya.
(Opsional) Aktifkan autentikasi layanan backend: Anda dapat menambahkan konfigurasi autentikasi. Tabel berikut menjelaskan metode autentikasi yang berbeda:
Parameter
Deskripsi
Basic
Username dan password dikodekan base64 dalam format username:password dan dikirim dalam bidang Authorization Header permintaan HTTP.
Bearer
Klien pertama-tama memperoleh token melalui antarmuka login, biasanya berupa JWT. Token tersebut disertakan dalam header Authorization untuk setiap permintaan berikutnya. Token biasanya bersifat sementara dan tanggal kedaluwarsa dapat ditetapkan.
API Key
Server menetapkan string unik kepada klien sebagai kredensial akses. Klien mengirimkan string ini melalui header atau parameter kueri pada setiap permintaan.
Metode 2:Custom YAML
Anda dapat membuat alat MCP secara manual melalui YAML kustom. Untuk informasi lebih lanjut, lihat Referensi bidang konfigurasi HTTP to MCP.
Klik YAML Example. Anda dapat memodifikasi contoh YAML yang dihasilkan.
(Opsional) Aktifkan autentikasi layanan backend: Anda dapat menambahkan konfigurasi autentikasi. Tabel berikut menjelaskan metode autentikasi yang berbeda:
Parameter
Deskripsi
Basic
Username dan password dikodekan base64 dalam format username:password dan dikirim dalam bidang Authorization Header permintaan HTTP.
Bearer
Klien pertama-tama memperoleh token melalui antarmuka login, biasanya berupa JWT. Token tersebut disertakan dalam header Authorization untuk setiap permintaan berikutnya. Token biasanya bersifat sementara dan tanggal kedaluwarsa dapat ditetapkan.
API Key
Server menetapkan string unik kepada klien sebagai kredensial akses. Klien mengirimkan string ini melalui header atau parameter kueri pada setiap permintaan.
Klik Confirm. Anda dapat melihat daftar alat dan informasi deskripsi alat pada tab Tools.