Mengekspos dan mengatur server MCP yang ada

Artikel ini menunjukkan cara menggunakan API Management untuk mengekspos dan mengatur server Protokol Konteks Model jarak jauh (MCP) yang ada - server alat yang dihosting di luar API Management. Mengekspos dan mengatur alat server melalui API Management sehingga klien MCP dapat memanggilnya dengan menggunakan protokol MCP.

Contoh skenario meliputi:

Server alat Proxy LangChain atau LangServe melalui API Management dengan autentikasi per server dan batas tarif.
Mengekspos alat yang berbasis Azure Logic Apps dengan aman ke copilot dengan menggunakan pemfilteran IP dan OAuth.
Pusatkan alat server MCP dari Azure Functions dan runtime sumber terbuka ke Azure API Center.
Aktifkan GitHub Copilot, Claude by Anthropic, atau ChatGPT untuk berinteraksi dengan aman dengan alat di seluruh perusahaan Anda.

API Management juga mendukung server MCP yang diekspos secara asli di API Management dari REST API terkelola. Untuk informasi selengkapnya, lihat Mengekspos REST API sebagai server MCP.

Pelajari selengkapnya tentang:

Keterbatasan

Server MCP eksternal harus sesuai dengan versi MCP atau yang 2025-06-18 lebih baru. Server dapat mendukung:
- Baik tidak ada otorisasi, atau protokol otorisasi yang mematuhi standar berikut: https://modelcontextprotocol.io/specification/2025-06-18/basic/authorization#standards-compliance.
- Jenis protokol HTTP atau SSE yang dapat dialirkan.
API Management saat ini mendukung alat server MCP, tetapi tidak mendukung sumber daya atau perintah MCP.
API Management saat ini tidak mendukung kemampuan server MCP di ruang kerja.

Prasyarat

Jika Anda belum memiliki instans API Management, selesaikan mulai cepat berikut: Membuat instans Azure API Management. Instans harus berada di salah satu tingkat layanan yang mendukung server MCP.
Akses ke server eksternal yang kompatibel dengan MCP (misalnya, dihosting di Azure Logic Apps, Azure Functions, LangServe, atau platform lainnya).
Kredensial yang sesuai ke server MCP (seperti kredensial klien OAuth 2.0 atau kunci API, tergantung pada server) untuk akses yang aman.
Jika Anda mengaktifkan pembuatan log diagnostik melalui Application Insights atau Azure Monitor di skala global (semua API) untuk instans API Management Anda, atur Jumlah byte payload yang akan di-log untuk Response Frontend ke 0. Pengaturan ini mencegah pengelogan badan respons yang tidak diinginkan di semua API dan membantu memastikan berfungsinya server MCP. Untuk mencatat payload secara selektif untuk API tertentu, konfigurasikan pengaturan satu per satu di cakupan API, memungkinkan kontrol yang ditargetkan atas pengelogan respons.
Untuk menguji server MCP, gunakan Visual Studio Code dengan akses ke GitHub Copilot atau alat seperti MCP Inspector.

Mengekspos server MCP yang ada

Ikuti langkah-langkah ini untuk mengekspos server MCP yang ada di API Management:

Di portal Microsoft Azure, buka instans API Management Anda.
Di menu sebelah kiri, di bawah API, pilih server> MCP+ Buat server MCP.
Pilih Ekspos server MCP yang sudah ada.
Di server MCP Backend:
1. Masukkan URL dasar server MCP yang ada. Misalnya, https://learn.microsoft.com/api/mcp untuk server MCP Microsoft Learn.
2. Dalam Jenis transportasi, HTTP yang Dapat Dialirkan dipilih secara default.
Di server MCP Baru:
1. Masukkan Nama untuk server MCP di API Management.
2. Di Jalur dasar, masukkan awalan rute untuk alat. Contohnya, mytools.
3. Secara opsional, masukkan Deskripsi untuk server MCP.
Pilih Buat.

Cuplikan layar pembuatan server MCP di portal.

Server MCP dibuat dan operasi server jarak jauh diekspos sebagai alat.
Server MCP tercantum di panel Server MCP . Kolom URL Server memperlihatkan URL server MCP untuk memanggil pengujian atau dalam aplikasi klien.

Penting

Saat ini, API Management tidak menampilkan alat dari server MCP yang ada. Anda harus mendaftar dan mengonfigurasi semua alat di server MCP jarak jauh yang ada.

Mengonfigurasi kebijakan untuk server MCP

Konfigurasikan satu atau beberapa kebijakan API Management untuk membantu mengelola server MCP. Kebijakan berlaku untuk semua operasi API yang diekspos sebagai alat di server MCP. Gunakan kebijakan ini untuk mengontrol akses, autentikasi, dan aspek alat lainnya.

Pelajari selengkapnya tentang mengonfigurasi kebijakan:

Perhatian

Jangan mengakses isi respons dengan menggunakan context.Response.Body variabel dalam kebijakan server MCP. Melakukannya memicu buffering respons, yang mengganggu perilaku streaming yang diperlukan oleh server MCP dan dapat menyebabkannya tidak berfungsi.

Untuk mengonfigurasi kebijakan untuk server MCP, ikuti langkah-langkah berikut:

Di portal Microsoft Azure, buka instans API Management Anda.
Di menu sebelah kiri, di bawah API, pilih Server MCP.
Pilih server MCP dari daftar.
Di menu sebelah kiri, di bawah MCP, pilih Kebijakan.

Di editor kebijakan, tambahkan atau edit kebijakan yang ingin Anda terapkan ke alat server MCP. Tentukan kebijakan dalam format XML.

Misalnya, Anda dapat menambahkan kebijakan untuk membatasi panggilan ke alat server MCP (dalam contoh ini, satu panggilan per 60 detik per sesi MCP).

<!-- Rate limit tool calls by Mcp-Session-Id header -->
<set-variable name="body" value="@(context.Request.Body.As<string>(preserveContent: true))" />
<choose>
    <when condition="@(
        Newtonsoft.Json.Linq.JObject.Parse((string)context.Variables["body"])["method"] != null 
        && Newtonsoft.Json.Linq.JObject.Parse((string)context.Variables["body"])["method"].ToString() == "tools/call"
    )">
    <rate-limit-by-key 
        calls="1" 
        renewal-period="60" 
        counter-key="@(
            context.Request.Headers.GetValueOrDefault("Mcp-Session-Id", "unknown")
        )" />
    </when>
</choose>

Nota

API Management mengevaluasi kebijakan yang dikonfigurasi pada cakupan global (semua API) sebelum mengevaluasi kebijakan di cakupan server MCP.

Memvalidasi dan menggunakan server MCP

Gunakan agen LLM yang sesuai (seperti GitHub Copilot, Semantic Kernel, atau Copilot Studio) atau klien pengujian (seperti curl) untuk memanggil titik akhir MCP yang dihosting API Management. Pastikan bahwa permintaan menyertakan header atau token yang sesuai, dan konfirmasikan perutean dan respons yang berhasil dari server MCP.

Petunjuk / Saran

Jika Anda menggunakan Inspektur MCP untuk menguji server MCP yang dikelola oleh API Management, gunakan versi 0.9.0.

Menambahkan server MCP di Visual Studio Code

Di Visual Studio Code, gunakan obrolan GitHub Copilot dalam mode agen untuk menambahkan server MCP dan menggunakan alat. Untuk latar belakang tentang server MCP di Visual Studio Code, lihat Menggunakan Server MCP di VISUAL Code.

Untuk menambahkan server MCP di Visual Studio Code:

Gunakan perintah MCP: Tambahkan Server dari Palet Perintah.
Saat diminta, pilih jenis server: HTTP (HTTP atau Server Sent Events).
Masukkan URL Server server MCP di API Management. Misalnya, https://<apim-service-name>.azure-api.net/<api-name>-mcp/mcp untuk titik akhir MCP.
Masukkan ID Server pilihan Anda.
Pilih apakah akan menyimpan konfigurasi ke pengaturan ruang kerja atau pengaturan pengguna Anda.
- Pengaturan ruang kerja - Konfigurasi server disimpan ke file yang .vscode/mcp.json hanya tersedia di ruang kerja saat ini.
- Pengaturan pengguna - Konfigurasi server ditambahkan ke file global settings.json Anda dan tersedia di semua ruang kerja. Konfigurasi terlihat mirip dengan yang berikut ini:

Tambahkan bidang ke konfigurasi JSON untuk pengaturan seperti header autentikasi. Contoh berikut menunjukkan konfigurasi untuk kunci langganan API Management yang dikirim dalam header sebagai nilai input. Pelajari selengkapnya tentang format konfigurasi

Cuplikan layar konfigurasi header autentikasi untuk server MCP

Menggunakan alat dalam mode agen

Setelah menambahkan server MCP di Visual Studio Code, Anda dapat menggunakan alat dalam mode agen.

Di obrolan GitHub Copilot, pilih Mode agen dan pilih tombol Alat untuk melihat alat yang tersedia.
Pilih satu atau beberapa alat dari server MCP yang akan tersedia di obrolan.
Masukkan perintah di obrolan untuk memanggil alat. Misalnya, jika Anda memilih alat untuk mendapatkan informasi tentang pesanan, Anda dapat bertanya kepada agen tentang pesanan.
```
Get information for order 2
```
Pilih Lanjutkan untuk melihat hasilnya. Agen menggunakan alat untuk memanggil server MCP dan mengembalikan hasilnya dalam obrolan.

Pemecahan masalah dan isu yang diketahui

Masalah	Sebab	Solusi
`401 Unauthorized` kesalahan dari backend	Header otorisasi tidak diteruskan	Jika perlu, gunakan `set-header` kebijakan untuk melampirkan token secara manual
Panggilan API berfungsi di API Management tetapi gagal dalam agen	URL dasar yang salah atau token yang hilang	Periksa kembali kebijakan keamanan dan titik akhir
Streaming server MCP gagal ketika log diagnostik diaktifkan	Pengelogan isi respons atau mengakses isi respons melalui kebijakan mengganggu transportasi MCP	Menonaktifkan pengelogan isi respons di cakupan Semua API - lihat Prasyarat

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-11-19