Freigeben über

Registrieren und Ermitteln von Remote-MCP-Servern in Ihrem API-Bestand

In diesem Artikel wird beschrieben, wie Sie das Azure API Center verwenden, um ein Inventar (oder eine Registrierung) von MCP-Servern (Remotemodellkontextprotokoll) zu verwalten und Projektbeteiligten dabei zu helfen, sie mithilfe des API Center-Portals zu ermitteln. MCP-Server machen Back-End-APIs oder Datenquellen standardmäßig für KI-Agents und -Modelle verfügbar, die sie nutzen.

Informationen zu MCP-Servern

KI-Agents werden aufgrund erweiterter LLM-Funktionen (Large Language Model) weit verbreitet. Selbst die fortschrittlichsten Modelle sehen sich aufgrund ihrer Isolation von externen Daten jedoch mit Einschränkungen konfrontiert. Jede neue Datenquelle erfordert möglicherweise benutzerdefinierte Implementierungen, um Daten für die Modelle zu extrahieren, vorzubereiten und zugänglich zu machen.

Das Modellkontextprotokoll (MCP) hilft bei der Lösung dieses Problems. MCP ist ein offener Standard zum Verbinden von KI-Modellen und Agents mit externen Datenquellen wie lokalen Datenquellen (Datenbanken oder Computerdateien) oder Remotediensten (Systeme, die über das Internet verfügbar sind, z. B. Remotedatenbanken oder APIs).

MCP-Architektur

MCP folgt einer Clientserverarchitektur, in der eine Hostanwendung eine Verbindung mit mehreren Servern herstellen kann. Wenn Ihr MCP-Host oder -Client ein Tool benötigt, stellt er eine Verbindung mit dem MCP-Server bereit. Der MCP-Server stellt dann eine Verbindung mit einer Datenbank oder einer API bereit. MCP-Hosts und -Server verbinden sich über das MCP-Protokoll miteinander.

Die MCP-Architektur basiert auf JSON-RPC 2.0 für das Messaging. Die Kommunikation zwischen Clients und Servern erfolgt über definierte Transportebenen und unterstützt in erster Linie zwei Betriebsmodi:

  • Remote-MCP-Server – MCP-Clients stellen eine Verbindung mit MCP-Servern über das Internet her, einrichten eine Verbindung mit HTTP- und servergesendeten Ereignissen (SSE) und Autorisieren des MCP-Clientzugriffs auf Ressourcen im Konto des Benutzers mithilfe von OAuth.

  • Lokale MCP-Server MCP-Clients stellen eine Verbindung mit MCP-Servern auf demselben Computer her, wobei die Standardeingabe/Ausgabe als lokale Transportmethode verwendet wird.

Manuelles Registrieren eines MCP-Servers in Ihrem API-Bestand

In den folgenden Abschnitten wird beschrieben, wie Sie einen Remote-MCP-Server manuell in Ihrem API Center inventarisieren.

MCP-API-Typ

Registrieren Sie einen MCP-Server manuell in Ihrem API Center-Bestand, indem Sie ähnlich wie bei der Registrierung anderer APIs vorgehen, und geben Sie als API-Typ MCP an. Informationen zum Registrieren einer API mithilfe des Azure-Portals finden Sie im Lernprogramm: Registrieren von APIs in Ihrem API-Bestand.

Wie in den folgenden Abschnitten beschrieben, können Sie beim Registrieren eines MCP-Servers eine Umgebung, Bereitstellung und Definition angeben.

Tip

Wenn Sie MCP-Server in Azure API Management verwalten, können Sie die automatische Synchronisierung aktivieren, um Ihr API Center mit MCP-Servern und anderen APIs aus Ihrer API-Verwaltungsinstanz auf dem neuesten Stand zu halten. Weitere Informationen finden Sie unter "Synchronisieren von APIs aus azure API Management-Instanz".

Umgebung und Bereitstellung für MCP-Server

Geben Sie im API Center eine Umgebung und eine Bereitstellung für Ihren MCP-Server an. Die Umgebung ist der Speicherort des MCP-Servers, z. B. einer API-Verwaltungsplattform oder eines Computediensts, und die Bereitstellung ist eine Laufzeit-URL für den MCP-Dienst.

Informationen zum Erstellen einer Umgebung und einer Bereitstellung finden Sie im Lernprogramm: Hinzufügen von Umgebungen und Bereitstellungen für APIs.

Definition für Remote-MCP-Server

Fügen Sie optional eine API-Definition für einen McP-Remoteserver im OpenAPI 3.0-Format hinzu. Die API-Definition muss einen URL-Endpunkt für den MCP-Server enthalten. Ein Beispiel zum Hinzufügen einer OpenAPI-Definition finden Sie im Lernprogramm: Registrieren von APIs in Ihrem API-Inventar.

Sie können die folgende einfache OpenAPI 3.0-API-Definition für Ihren MCP-Server verwenden, der einen url Endpunkt für den MCP-Server enthält:

{
  "openapi": "3.0.0",
  "info": {
    "title": "Demo MCP server",
    "description": "Very basic MCP server that exposes mock tools and prompts.",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://my-mcp-server.contoso.com"
    }
  ]
}

Registrieren eines MCP-Servers eines Partners

Das Azure API Center bietet eine kuratierte Liste der MCP-Server von Partnern, die Sie Ihrem API-Bestand hinzufügen können. Diese Liste enthält MCP-Server von Microsoft-Diensten wie Azure Logic Apps, GitHub und anderen.

Registrieren Sie einen oder mehrere MCP-Server von Partnern in Ihrem API-Bestand, um sie Fachkräften in der Entwicklung und anderen Projektbeteiligten in Ihrer Organisation zur Verfügung zu stellen.

Screenshot: MCP-Server von Partnern im Portal

So registrieren Sie einen MCP-Server eines Partners:

  1. Navigieren Sie im Azure-Portal zu Ihrem API Center.
  2. Wählen Sie im Randleistenmenü unter Entdecken die Option MCP (Vorschau) aus.
  3. Durchsuchen Sie die verfügbaren MCP-Server von Partnern. Wählen Sie Registrieren aus, um Ihrem API-Bestand einen MCP-Server hinzuzufügen. Folgen Sie den Anweisungen auf dem Bildschirm, sofern vorhanden, um die Registrierung abzuschließen.

Wenn Sie einen MCP-Server eines Partners hinzufügen, konfiguriert API Center automatisch Folgendes für Sie:

  • Erstellt einen API-Eintrag in Ihrem API-Bestand, wobei der API-Typ auf MCP festgelegt ist.
  • Erstellt eine Umgebung und eine Bereitstellung für den MCP-Server.
  • Fügt eine OpenAPI-Definition für den MCP-Server hinzu, falls diese vom Partner verfügbar ist.

Informationen zum Erstellen und Registrieren eines Logic Apps MCP-Servers finden Sie unter Erstellen und Registrieren eines Logic Apps MCP-Servers.

Ermitteln von MCP-Servern mithilfe des API Center-Portals

Richten Sie Ihr API Center-Portal ein, damit Fachkräfte in der Entwicklung und andere Projektbeteiligte in Ihrer Organisation MCP-Server in Ihrem API-Bestand ermitteln können. Benutzer können MCP-Server im Bestand durchsuchen und filtern und Details anzeigen, z. B. den URL-Endpunkt des MCP-Servers, sofern in der API-Definition des MCP-Servers verfügbar.

Screenshot des MCP-Servers im API Center-Portal.

Note

Der URL-Endpunkt für den MCP-Server ist nur im API Center-Portal sichtbar, wenn eine MCP-Bereitstellung und eine API-Definition für den MCP-Server im API Center konfiguriert sind.

Verwandte Inhalte

  • Last updated on