Azure API Center'da Azure İşlevleri'nde barındırılan MCP sunucularını kaydetme

MCP sunucunuzu Azure İşlevleri'ne uzaktan barındırdıktan sonra Azure API Center'a kaydedin. Azure API Center, kuruluşunuz genelinde kolayca bulunabilmeleri için uzak MCP sunucularının envanterini (veya kayıt defterini) tutar. Tüm kayıtlı MCP sunucuları, kuruluşunuzdaki ekipler için API Center portalında görünür.

Tip

API Center adı, kayıt defteri filtresindeki özel araç kataloğu adınız olur. Kullanıcıların kuruluşunuzun araç kataloğunu tanımlamasını sağlayan bilgilendirici bir ad seçin.

Kaynaklar oluştur

1. Azure portalında oturum açın, ardından henüz bir Azure API Center kaynağınız yoksa bir Azure API Center kaynağı oluşturun.

2. API Center kaynağınızda bir ortam oluşturun. Sunucu>Türü için Azure İşlevleri'ne tıklayın.

MCP sunucusunu kaydetme

Uzak MCP sunucunuzu API olarak ekleyerek kaydedin:

1. API Center kaynağının sol gezinti bölmesinde API'ler'i seçin.

2. + API kaydet seçin. Aşağıdaki tabloda gerekli ayarlar için örnek değerler verilmiştir. Ayrıca, MCP sunucu açıklaması, depo, harici belgeler ve API Center portalında görüntülenen diğer bilgiler gibi isteğe bağlı ayarları da doldurabilirsiniz.

   Setting	Değer
   API Başlığı	MCP sunucusu için gibi Weather MCP Serveraçıklayıcı bir ad girin.
   Kimlik	Bu değer API Başlığına göre otomatik olarak oluşturulur, ancak değiştirebilirsiniz.
   API türü	MCP
   Çalışma Zamanı URL'si	MCP sunucu uç noktasını girin, örneğin https://contoso.azurewebsites.net/mcp
   Çevre	Daha önce oluşturduğunuz ortamı seçin.
   Sürüm başlığı	tercihinize göre bir sürüm başlığı girin, örneğin v1.
   Sürüm tanımlama	Önceki başlığı girdikten sonra Azure API Center bu tanımlayıcıyı oluşturur ve bu tanımlayıcıyı geçersiz kılabilirsiniz.
   Sürüm yaşam döngüsü	Açılan listeden Test veya Üretim gibi en uygun değeri seçin.

3. Oluştur'i seçin.

   Şimdi listede MCP sunucusunun API olarak kayıtlı olduğunu görmeniz gerekir.

Sunucu tanımını güncelleştirme

1. OpenAPI 3.0 biçiminde uzak bir MCP sunucusu için API tanımı oluşturun. API Center portalının MCP sunucusunun URL uç noktasını göstermesi için bu tanıma ihtiyacınız vardır. Tanımı erişebileceğiniz yere kaydedin. Sonraki adımda yüklemeniz gerekiyor.

   MCP sunucusu için örnek OpenAPI 3.0 API tanımı:

   {
       "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. Sunucu tanımını güncelleştirin:

   a. Sol menüde Varlıklar -> API'ler'i bulun.

   b. Kaydı açmak için MCP sunucu adını seçin.

   c. Sol menüde Ayrıntılar -> Sürümler'i bulun.

   d. "Sürüm" altında "v1" öğesini bulun ve genişletin. Ardından Akış Tanımı'nı seçerek tanımı açın.

   d. Değiştir'i seçin.

   e. Açılan yan bölmede "Belirtim sürümü" öğesini 3.0 olarak değiştirin ve ardından son adımdaki tanımı karşıya yükleyin.

   f. Değiştir'i seçin.

API Center portalını ayarlama

1. Henüz bir portalınız yoksa portalı kurun.

2. Portal ayarlandıktan sonra https://<service-name>.portal.<location>.azure-apicenter.ms adresine erişebilirsiniz. <service-name> değerini API merkezinizin adıyla ve <location> değerini dağıttığınız konumla değiştirin. Kayıtlı MCP sunucularını görmek için oturum açmanız gerekir.

3. Bir sunucu adı seçtiğinizde, sunucu kaydı sırasında sağladığınız verilere ve karşıya yüklenen API tanımına göre bilgileri gösteren bir bölme açılır. Portala erişimi olan kullanıcılar, uç nokta URL'sini veya Visual Studio Code tümleştirmesindeki yüklemeyi kopyalayarak tercih ettikleri sunuculara bağlanabilir.

   

İlgili makaleler

Azure API Management'ta MCP sunucuları hakkında