Registrieren von MCP-Servern, die in Azure-Funktionen im Azure API Center gehostet werden

Nachdem Sie Ihren MCP-Server remote auf Azure Functions gehostet haben, registrieren Sie ihn im Azure API Center. Das Azure API Center verwaltet ein Inventar (oder eine Registrierung) von Remote-MCP-Servern, sodass sie in Ihrer Organisation leicht auffindbar sind. Alle registrierten MCP-Server werden im API Center-Portal für Teams in Ihrer Organisation angezeigt.

Tipp

Der Name des API Centers wird zum privaten Toolkatalognamen im Registrierungsfilter. Wählen Sie einen informativen Namen aus, der Benutzern hilft, den Toolkatalog Ihrer Organisation zu identifizieren.

Erstellen von Ressourcen

1. Melden Sie sich beim Azure-Portal an, und erstellen Sie dann eine Azure API Center-Ressource, wenn Sie noch keines haben.

2. Erstellen Sie eine Umgebung in Ihrer API Center-Ressource. Wählen Sie für den Servertyp>Azure-Funktionen aus.

MCP-Server registrieren

Registrieren Sie Ihren Remote-MCP-Server, indem Sie ihn als API hinzufügen:

1. Wählen Sie im linken Navigationsbereich der API Center-Ressource APIs aus.

2. Wählen Sie +Registrieren Sie eine API aus. Die folgende Tabelle enthält Beispielwerte für die erforderlichen Einstellungen. Sie können auch die optionalen Einstellungen wie MCP-Serverbeschreibung, Repository, externe Dokumentation und andere Informationen ausfüllen, die im API Center-Portal angezeigt werden.

   Setting	Wert
   API-Titel	Geben Sie einen beschreibenden Namen für den MCP-Server ein, wie z. B. Weather MCP Server.
   Identifizierung	Dieser Wert wird basierend auf dem API-Titel automatisch generiert, Aber Sie können ihn ändern.
   API-Typ	MCP
   URL der Runtime	Geben Sie den MCP-Serverendpunkt ein, z. B. https://contoso.azurewebsites.net/mcp
   Umgebung	Wählen Sie die Umgebung aus, die Sie zuvor erstellt haben.
   Versionstitel	Geben Sie einen Versionstitel Ihrer Wahl ein, wie z. B. v1.
   Versionsidentifikation	Nachdem Sie den vorangehenden Titel eingegeben haben, generiert das Azure API Center diesen Bezeichner, den Sie überschreiben können.
   Versionslebenszyklus	Wählen Sie den am besten geeigneten Wert aus der Dropdownliste aus, z. B. "Testen" oder "Produktion".

3. Wählen Sie "Erstellen" aus.

   Nun sollte der MCP-Server als API in der Liste registriert werden.

Aktualisieren der Serverdefinition

1. Erstellen Sie eine API-Definition für einen Remote-MCP-Server im OpenAPI 3.0-Format. Sie benötigen diese Definition, damit das API Center-Portal den URL-Endpunkt des MCP-Servers anzeigt. Speichern Sie die Definition, in der Sie darauf zugreifen können. Sie müssen sie im nächsten Schritt hochladen.

   Beispiel für die OpenAPI 3.0-API-Definition für den MCP-Server:

   {
       "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. Aktualisieren Sie die Serverdefinition:

   a) Suchen Sie im linken Menü "Assets –> APIs".

   b. Wählen Sie den NAMEN des MCP-Servers aus, um die Registrierung zu öffnen.

   c. Finden Sie im linken Menü "Details –> Versionen".

   d. Suchen Sie unter "Version" nach "v1" und erweitern Sie es. Wählen Sie dann "Streamable Definition" aus, um die Definition zu öffnen.

   d. Wählen Sie "Ersetzen" aus.

   e. Ändern Sie im daraufhin geöffneten Seitenbereich die "Spezifikationsversion" in 3.0, und laden Sie dann die Definition aus dem letzten Schritt hoch.

   f. Wählen Sie "Ersetzen" aus.

Einrichten des API Center-Portals

1. Richten Sie das Portal ein , wenn Sie noch kein Portal haben.

2. Sobald das Portal eingerichtet ist, können Sie darauf zugreifen unter https://<service-name>.portal.<location>.azure-apicenter.ms. Ersetzen Sie <service-name> und <location> durch den Namen Ihres API-Centers und den Speicherort, an dem Sie es bereitgestellt haben. Sie müssen sich anmelden, um registrierte MCP-Server anzuzeigen.

3. Wenn Sie einen Servernamen auswählen, wird ein Bereich geöffnet, in dem Informationen basierend auf Den Daten angezeigt werden, die Sie während der Serverregistrierung und der hochgeladenen API-Definition angeben. Benutzer mit Zugriff auf das Portal können eine Verbindung mit Servern ihrer Wahl herstellen, indem Sie die Endpunkt-URL oder die Installation in der Visual Studio Code-Integration kopieren.

   

Verwandte Artikel

Informationen zu MCP-Servern in Azure API Management