Mendaftarkan server MCP yang dihosting di Azure Functions di Azure API Center

Setelah menghosting server MCP Anda dari jarak jauh di Azure Functions, daftarkan di Azure API Center. Azure API Center mempertahankan inventarisasi (atau registri) server MCP jarak jauh sehingga mudah ditemukan di seluruh organisasi Anda. Semua server MCP terdaftar muncul di portal PUSAT API untuk tim di organisasi Anda.

Tip

Nama PUSAT API menjadi nama katalog alat privat Anda di filter registri. Pilih nama informatif yang membantu pengguna mengidentifikasi katalog alat organisasi Anda.

Membuat sumber daya

1. Masuk ke portal Microsoft Azure, lalu buat sumber daya Azure API Center, jika Anda belum memilikinya.

2. Buat lingkungan di sumber daya API Center Anda. UntukJenis>, pilih Azure Functions.

Mendaftarkan server MCP

Daftarkan server MCP jarak jauh Anda dengan menambahkannya sebagai API:

1. Di panel navigasi kiri sumber daya PUSAT API, pilih API.

2. Pilih + Daftarkan API. Tabel berikut ini menyediakan nilai contoh untuk pengaturan yang diperlukan. Anda juga dapat mengisi pengaturan opsional seperti deskripsi server MCP, repositori, dokumentasi eksternal, dan informasi lain yang ditampilkan di portal API Center.

   Setting	Nilai
   Judul API	Masukkan nama deskriptif untuk server MCP, seperti Weather MCP Server.
   Identifikasi	Nilai ini dibuat secara otomatis berdasarkan Judul API, tetapi Anda dapat memodifikasinya.
   Tipe API	MCP
   Runtime URL	Masukkan titik akhir server MCP, seperti https://contoso.azurewebsites.net/mcp
   Lingkungan	Pilih lingkungan yang Anda buat sebelumnya.
   Judul versi	Masukkan judul versi pilihan Anda, seperti v1.
   Identifikasi versi	Setelah Anda memasukkan judul sebelumnya, Azure API Center menghasilkan pengidentifikasi ini, yang dapat Anda ambil alih.
   Siklus hidup versi	Pilih nilai yang paling tepat dari menu dropdown, seperti Pengujian atau Produksi.

3. Pilih Buat.

   Anda sekarang akan melihat server MCP terdaftar sebagai API dalam daftar.

Memperbarui definisi server

1. Buat definisi API untuk server MCP jarak jauh dalam format OpenAPI 3.0. Anda memerlukan definisi ini sehingga portal PUSAT API menunjukkan titik akhir URL server MCP. Simpan definisi tempat Anda dapat mengaksesnya. Anda perlu mengunggahnya di langkah berikutnya.

   Contoh definisi API OpenAPI 3.0 untuk server MCP:

   {
       "openapi": "3.0.0",
       "info": {
           "title": "Weather MCP server",
           "description": "MCP server with tools returning weather forecast and alerts.",
           "version": "1.0"
       },
       "servers": [
           {
               "url": "https://my-mcp-server.azurewebsites.net/mcp"
           }
       ]
   }
   

2. Perbarui definisi server:

   a. Di menu sebelah kiri, temukan Aset -> API.

   b. Pilih nama server MCP untuk membuka pendaftaran.

   c. Di menu sebelah kiri, temukan Detil: Versi.

   d. Di bagian "Versi", temukan dan perluas "v1". Kemudian pilih Definisi yang Dapat Dialirkan untuk... untuk membuka definisi.

   d. Pilih Ganti.

   e. Di panel samping yang terbuka, ubah "Versi spesifikasi" menjadi 3.0, lalu unggah definisi dari langkah terakhir.

   f. Pilih Ganti.

Menyiapkan portal API Center

1. Siapkan portal jika Anda belum memilikinya.

2. Setelah portal disiapkan, Anda dapat mengaksesnya di https://<service-name>.portal.<location>.azure-apicenter.ms. Ganti <service-name> dan <location> dengan nama pusat API Anda dan lokasi tempat Anda menyebarkannya. Anda perlu masuk untuk melihat server MCP terdaftar.

3. Saat Anda memilih nama server, panel terbuka yang menampilkan informasi berdasarkan data yang Anda berikan selama pendaftaran server dan definisi API yang diunggah. Pengguna dengan akses ke portal dapat terhubung ke server pilihan mereka dengan menyalin URL titik akhir atau menginstal dalam integrasi Visual Studio Code.

   

Artikel terkait

Tentang server MCP di Azure API Management