Model Context Protocol – Übersicht

Dieses Dokument bietet einen Überblick über die Unterstützung des Model Context Protocol (MCP) im API Gateway.

API Gateway kann als Remote-MCP-Server fungieren, sodass Sie Ihre vorhandenen REST APIs für KI-Agents und LLMs verfügbar machen können, ohne Ihre Backend-Dienste neu schreiben zu müssen.

Hintergrund

Das Model Context Protocol (MCP) ist ein offener Standard, mit dem Sie KI-Agenten direkt für Ihre vorhandene Infrastruktur erstellen können. Anstatt für jedes Tool oder jede API benutzerdefinierten Integrationscode zu schreiben, bietet MCP eine standardisierte Möglichkeit für KI-Modelle, Funktionen in Ihrer Umgebung zu erkennen und aufzurufen.

Wenn API Gateway als MCP-Server konfiguriert ist, fungiert es als Proxy. Es übersetzt Standard-MCP-JSON-RPC-Protokollnachrichten, die von Agent-Systemen gesendet werden, in Standard-HTTP-REST-Anfragen an Ihre vorhandenen Back-Ends.

Unterstützte Features

Während der öffentlichen Vorschau unterstützt API Gateway die folgenden MCP-Funktionen:

  • Remote-MCP-Server: API Gateway fungiert als Remoteserver und empfängt MCP-Anfragen über HTTP (POST).
  • OpenAPI 3.x-Integration: Die MCP-Konfiguration wird direkt aus Ihrer OpenAPI 3.x-Spezifikation mit benutzerdefinierten Erweiterungen abgeleitet.
  • Unterstützte MCP-Lebenszyklusmethoden:
    • initialize: Legt die Protokollversion und die Funktionen fest.
    • notifications/initialized: Bestätigt den Handshake.
    • tools/list: Ermöglicht es Clients, verfügbare Tools und ihre Schemas zu ermitteln.
    • tools/call: Ermöglicht es Clients, ein Tool mit Argumenten aufzurufen.

Beschränkungen

Für die Unterstützung von MCP in API Gateway gelten die folgenden Einschränkungen:

  • Ressourcen (resources/*) und Prompts (prompts/*) werden nicht unterstützt.
  • Der Stdio-Transport wird nicht unterstützt.
  • OpenAPI 2.0 wird nicht unterstützt.
  • Streaming oder Tool-Aufrufe mit langer Laufzeit werden nicht unterstützt.
  • Gegenseitiger Ausschluss von Modellrouting: Sie können MCP und Modellrouting nicht gleichzeitig in derselben API-Konfiguration aktivieren. Wenn x-google-api-management.mcp aktiviert ist, kann x-google-model-router nicht verwendet werden.

Eine vollständige Liste der technischen Einschränkungen finden Sie unter Einschränkungen der OpenAPI 3.x-Funktionen.

Anwendungsfälle

  • Bestehende REST APIs als MCP-Tools bereitstellen: Sie können Ihre bestehenden APIs in KI-fähige Tools umwandeln, ohne den Backend-Code zu ändern.
  • Tools pro Vorgang auswählen: Wählen Sie explizit aus, welche API-Pfade und ‑Methoden für Agents verfügbar gemacht werden.
  • Tool-Oberfläche schützen: Wenden Sie vorhandene API Gateway-Sicherheitsrichtlinien (z. B. API-Schlüssel oder OAuth) auf Ihren MCP-Endpunkt an.

Anfrageablauf

Der kanonische Pfad für MCP-Anfragen ist <basepath>/mcp, wobei <basepath> aus der URL oder der x-google-endpoint-Konfiguration Ihres Gateways abgeleitet wird.

Das folgende Diagramm zeigt den Anfrageablauf für eine tools/call-Anfrage für ein MCP:

  1. Ein MCP-Client (z.B. ein KI-Agent) sendet eine JSON-RPC-Anfrage an den MCP-Endpunkt des Gateways (z.B. POST /mcp oder POST /v1/mcp, wenn ein Versionspräfix verwendet wird).
  2. Das Gateway validiert die Anfrage und prüft die Authentifizierung.
  3. Das Gateway prüft die Nutzlast, um zu ermitteln, welches Tool aufgerufen wird.
  4. Das Gateway übersetzt die MCP-Nutzlast in eine standardmäßige HTTP-Anfrage (Pfad, Parameter, Text) basierend auf der in der API-Konfiguration definierten Zuordnung.
  5. Das Gateway leitet die Anfrage an den Backend-Dienst weiter.
  6. Das Back-End gibt eine Standard-HTTP-Antwort zurück.
  7. Das Gateway übersetzt die HTTP-Antwort zurück in eine MCP JSON-RPC-Antwort und gibt sie an den Client zurück.

Erkennung über API-Hub und Agent Registry

Wenn Sie Ihr Gateway in den API-Hub einbinden, wird es als MCP-Server mit zusätzlichen MCP-spezifischen Metadaten im API-Hub veröffentlicht und erscheint automatisch in der Agent Registry.

Bei Gateways ohne aktiviertes MCP werden Standard-API-Metadaten veröffentlicht. Diese zusätzlichen MCP-Konfigurationen werden im API-Hub nur für Gateways angezeigt, für die MCP aktiviert ist.

Ein separater Registrierungsschritt ist nicht erforderlich. Agents können den Server und seine Tools dann über einen der beiden Kataloge erkennen.

Wenn Sie die Agent Registry abfragen möchten, aktivieren Sie die API in Ihrem Projekt:

gcloud services enable agentregistry.googleapis.com

Nächste Schritte