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

Das folgende Diagramm veranschaulicht die MCP-Architektur:

Diagramm der MCP-Architektur (Model Context Protocol).

Die Architektur umfasst die folgenden Komponenten:

Komponente BESCHREIBUNG
MCP-Hosts LLM-Anwendungen wie Chat-Apps oder KI-Assistenten in Ihren IDEs (z. B. GitHub Copilot in Visual Studio Code), die auf externe Funktionen zugreifen müssen
MCP-Clients Protokollclients innerhalb der Hostanwendung, die 1:1-Verbindungen mit Servern verwalten
MCP-Server Einfache Programme, die jeweils bestimmte Funktionen verfügbar machen und Kontext, Tools und Eingabeaufforderungen für Clients bereitstellen
MCP-Protokoll Transportschicht in der Mitte

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.

Remote- und lokale MCP-Server

MCP verwendet eine Clienthostserverarchitektur, die auf JSON-RPC 2.0 für Messaging basiert. 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.

MCP-Server in Ihrem API-Inventar

In den folgenden Abschnitten wird beschrieben, wie Sie einen REMOTE-MCP-Server in Ihrem API Center inventarisieren und ermitteln.

MCP-API-Typ

Um einen MCP-Server im API Center-Bestand zu registrieren, geben Sie den API-Typ als 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.

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"
    }
  ]
}

Ermitteln von MCP-Servern mithilfe des API Center-Portals

Richten Sie das API Center-Portal ein, damit Entwickler und andere Projektbeteiligte in Ihrer Organisation MCP-Server in Ihrem API-Inventar 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.

Hinweis

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

Verwandte Inhalte