Rejestrowanie serwerów MCP hostowanych w usłudze Azure Functions w Centrum interfejsu API platformy Azure

Po zdalnym hostaniu serwera MCP w usłudze Azure Functions zarejestruj go w Centrum interfejsów API platformy Azure. Usługa Azure API Center obsługuje spis (lub rejestr) zdalnych serwerów MCP, dzięki czemu można je łatwo odnajdywać w całej organizacji. Wszystkie zarejestrowane serwery MCP są wyświetlane w portalu Centrum interfejsu API dla zespołów w organizacji.

Wskazówka

Nazwa centrum interfejsu API staje się nazwą prywatnego katalogu narzędzi w filtrze rejestru. Wybierz nazwę informacyjną, która ułatwia użytkownikom identyfikowanie katalogu narzędzi organizacji.

Tworzenie zasobów

1. Zaloguj się do witryny Azure Portal, a następnie utwórz zasób centrum interfejsu API platformy Azure, jeśli jeszcze go nie masz.

2. Utwórz środowisko w zasobie centrum interfejsu API. W poluTyp> wybierz pozycję Azure Functions.

Rejestrowanie serwera MCP

Zarejestruj zdalny serwer MCP, dodając go jako interfejs API:

1. W okienku nawigacji po lewej stronie zasobu centrum interfejsów API wybierz pozycję Interfejsy API.

2. Wybierz + Zarejestruj interfejs API. W poniższej tabeli przedstawiono przykładowe wartości wymaganych ustawień. Możesz również wypełnić opcjonalne ustawienia, takie jak opis serwera MCP, repozytorium, dokumentacja zewnętrzna i inne informacje wyświetlane w portalu Centrum interfejsu API.

   Setting	Wartość
   Tytuł interfejsu API	Wprowadź opisową nazwę serwera MCP, na przykład Weather MCP Server.
   Identyfikator	Ta wartość jest generowana automatycznie na podstawie tytułu interfejsu API, ale można ją zmodyfikować.
   Typ interfejsu API	MCP
   Adres URL środowiska uruchomieniowego	Wprowadź punkt końcowy serwera MCP, taki jak https://contoso.azurewebsites.net/mcp
   Środowisko	Wybierz utworzone wcześniej środowisko.
   Tytuł wersji	Wprowadź wybrany tytuł wersji, na przykład v1.
   Identyfikacja wersji	Po wprowadzeniu poprzedniego tytułu centrum interfejsu API platformy Azure generuje ten identyfikator, który można zastąpić.
   Cykl życia wersji	Wybierz najbardziej odpowiednią wartość z listy rozwijanej, na przykład Testowanie lub Produkcja.

3. Wybierz Utwórz.

   Na liście powinien zostać wyświetlony serwer MCP zarejestrowany jako interfejs API.

Aktualizowanie definicji serwera

1. Utwórz definicję interfejsu API dla zdalnego serwera MCP w formacie OpenAPI 3.0. Ta definicja jest potrzebna, aby portal Centrum interfejsu API wyświetlał punkt końcowy adresu URL serwera MCP. Zapisz definicję, w której można uzyskać do niej dostęp. Musisz przekazać go w następnym kroku.

   Przykładowa definicja interfejsu API openAPI 3.0 dla serwera 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. Zaktualizuj definicję serwera:

   a. W menu po lewej stronie znajdź pozycję Zasoby —> interfejsy API.

   b. Wybierz nazwę serwera MCP, aby otworzyć rejestrację.

   c. W menu po lewej stronie znajdź pozycję Szczegóły —> wersje.

   d. W obszarze "Wersja" znajdź i rozwiń "v1". Następnie wybierz pozycję Streamable Definition for... (Definicja z możliwością przesyłania strumieniowego dla...), aby otworzyć definicję.

   d. Wybierz Zamień.

   e. W otwartym okienku bocznym zmień wartość "Wersja specyfikacji" na 3.0, a następnie przekaż definicję z ostatniego kroku.

   f. Wybierz Zamień.

Konfigurowanie portalu centrum interfejsów API

1. Skonfiguruj portal , jeśli jeszcze go nie masz.

2. Po skonfigurowaniu portalu możesz uzyskać do niego dostęp pod adresem https://<service-name>.portal.<location>.azure-apicenter.ms. Zastąp <service-name> i <location> nazwą swojego centrum API oraz lokalizacją, gdzie je wdrożyłeś. Musisz się zalogować, aby wyświetlić zarejestrowane serwery MCP.

3. Po wybraniu nazwy serwera zostanie otwarte okienko zawierające informacje na podstawie danych podanych podczas rejestracji serwera i przekazanej definicji interfejsu API. Użytkownicy z dostępem do portalu mogą łączyć się z wybranymi serwerami, kopiując adres URL punktu końcowego lub korzystając z integracji w Visual Studio Code.

   

Powiązane artykuły

Informacje o serwerach MCP w usłudze Azure API Management