MCP-Server registrieren

Die Agent Registry fungiert als zentraler Katalog, in dem Endpunkte von MCP-Servern (Model Context Protocol) und die spezifischen Tools, die sie bereitstellen, registriert und verwaltet werden.

In diesem Dokument wird beschrieben, wie Sie MCP-Server registrieren und wie ihre Tool-Spezifikationen in der Agent Registry verwaltet werden.

Automatische Erkennung von Google Cloud MCP-Servern

Offizielle Google- und Google Cloud Remote-MCP-Server werden automatisch registriert und in die Agent Registry aufgenommen. Verfügbare Google- und Google Cloud Remote-MCP Server sind in unterstützten Produkten aus der Google Cloud MCP-Server-Dokumentation aufgeführt.

Wenn Sie eine unterstützte Google Cloud API in Ihrem Projekt aktivieren, z. B. die Compute Engine API, werden der entsprechende MCP Server und seine Tools sofort registriert und für die Suche in der Agent Registry verfügbar gemacht. Sie müssen die Tool-Spezifikationen für diese Dienste nicht manuell konfigurieren oder hochladen.

Externe MCP-Server registrieren

Wenn Sie Tools verwalten und wiederverwenden möchten, die von externen Diensten oder benutzerdefinierten APIs bereitgestellt werden, müssen Sie den MCP-Server explizit registrieren.

Bei der manuellen Registrierung eines MCP-Servers registriert die Agent Registry den Endpunkt. Der Server wird jedoch nicht automatisch untersucht, um zu ermitteln, welche Tools verfügbar sind. Damit Nutzer die genauen Tools finden können, die auf Ihrem MCP-Server verfügbar sind, müssen Sie die Tool-Spezifikationen während der Registrierung angeben, indem Sie eine toolspec.json-Datei hochladen.

Hinweis

Richten Sie die Agent Registry ein, bevor Sie beginnen. Sie benötigen die Projekt-ID um diese Aufgaben auszuführen.

Wenn Sie die gcloud CLI-Befehle in diesem Dokument verwenden möchten, müssen Sie Ihre Google Cloud CLI-Umgebung eingerichtet haben.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Registry API Editor (roles/agentregistry.editor) für das Projekt zu erteilen, um die Berechtigungen zu erhalten, die Sie zum manuellen Registrieren von MCP-Servern in der Agent Registry benötigen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.

Tool-Spezifikation vorbereiten

Erstellen Sie eine toolspec.json-Datei, in der die Tools beschrieben werden, die der Server bereitstellt. Diese JSON-Datei muss der MCP-Spezifikation für Tool-Schemas entsprechen, z. B.:

{
  "tools": [
    {
      "name": "get_customer_info",
      "description": "Retrieves customer details from the database.",
      "annotations": {
        "title": "Get Customer Info",
        "readOnlyHint": true,
        "idempotentHint": true
      }
    },
    {
      "name": "create_support_ticket",
      "description": "Creates a new support ticket in the issue tracking system.",
      "annotations": {
        "title": "Create Support Ticket",
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": true
      }
    }
  ]
}

Detaillierte strukturelle Anforderungen finden Sie unter JSON-Schemas und in der REST-Referenz.

Server und Tools registrieren

Registrieren Sie den MCP-Server und laden Sie die Tool-Definition gleichzeitig hoch:

Console

Rufen Sie in der Google Cloud Console die Seite Agent Registry auf:

Zur Agent Registry
Wählen Sie in der Projektauswahl das Google Cloud Projekt aus, in dem Sie die Agent Registry eingerichtet haben.
Wählen Sie den Tab MCP-Server aus.
Klicken Sie auf MCP-Server hinzufügen.
Geben Sie im Bereich MCP-Serverdetails den Anzeigenamen, eine Beschreibung und die geografische Region ein.
Geben Sie im Bereich Tool-Spezifikation die URL des MCP-Serverendpunkts ein und fügen Sie den Inhalt Ihrer toolspec.json-Datei ein. Sie können in diesem Bereich auch auf Tools importieren klicken, um die MCP-Tools von der URL zu importieren.
Klicken Sie auf Weiter.

Im Bereich MCP-Tools auswählen wird eine Liste von Tools mit Namen und Beschreibungen von Ihrem MCP-Server angezeigt.
Wählen Sie alle MCP-Tools aus, die Sie einbeziehen möchten. Sie können Tools in der Liste nach Name oder Wert filtern.
Klicken Sie auf Speichern.

gcloud

Registrieren Sie den MCP-Server mit der Tool-Spezifikation:

gcloud alpha agent-registry services create SERVER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --mcp-server-spec-type=tool-spec \
  --mcp-server-spec-content=@toolspec.json \
  --interfaces=url=SERVER_URL,protocolBinding=PROTOCOL

Ersetzen Sie Folgendes:

SERVER_NAME: Der Name, den Sie Ihrem MCP-Server geben möchten, z. B. custom-mcp-server.
PROJECT_ID: Die Projekt-ID.
REGION: Die Registry-Region.
DISPLAY_NAME: Der für Menschen lesbare Name, den Sie Ihrem Server geben möchten, z. B. Custom MCP Server.
SERVER_URL: Die Endpunkt-URL des MCP-Servers, z. B. https://api.example.com/mcp.
PROTOCOL: Die Protokollbindung für den Endpunkt. Gültige Werte sind JSONRPC, HTTP_JSON oder GRPC. Für MCP-Server ist dieser Wert oft JSONRPC.

Registrierung bestätigen

Listen Sie die Details Ihres neu registrierten MCP-Servers auf, filtern Sie sie und sehen Sie sie sich an. Um zu bestätigen, dass Ihr MCP-Server erfolgreich registriert wurde, können Sie die Server in Ihrer Registry auflisten.