Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

MCP-Server registrieren

Die Agent Registry fungiert als zentraler Katalog, indem sie MCP-Serverendpunkte (Model Context Protocol) und die spezifischen Tools, die sie bereitstellen, registriert und verwaltet.

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 der Dokumentation zu Google Cloud MCP-Servern unter Unterstützte Produkte 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 können in der Agent Registry erkannt werden. Sie müssen die Tool-Spezifikationen für diese Server nicht manuell konfigurieren oder hochladen.

Externe MCP-Server registrieren

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

Wenn Sie einen MCP-Server manuell registrieren, 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. Die maximale Dateigröße für diese Spezifikationsdatei beträgt 10 KB.

Die 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 gleichzeitig die Tool-Definition hoch:

Console

Rufen Sie in der Google Cloud Console 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 MCP-Serverendpunkt-URL ein und fügen Sie den Inhalt Ihrer toolspec.json-Datei ein.

Optional können Sie in diesem Bereich auf Tools importieren klicken, um die MCP-Tools aus der URL zu importieren. Diese Option funktioniert nur, wenn die Endpunkt-URL Ihres MCP-Servers öffentlich im Internet gehostet wird. Sie können diese Funktion nicht verwenden, um Tools von privat gehosteten MCP-Servern 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 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.

Terraform

Wenn Sie einen MCP-Server registrieren und seine Tools angeben möchten, konfigurieren Sie eine google_agent_registry_service-Ressource mit dem Block mcp_server_spec:

resource "google_agent_registry_service" "mcp_server" {
  location     = "REGION"
  service_id   = "SERVER_NAME"
  display_name = "DISPLAY_NAME"
  description  = "An external MCP server registered using Terraform."

  interfaces {
    url              = "SERVER_URL"
    protocol_binding = "JSONRPC"
  }

  mcp_server_spec {
    type    = "NO_SPEC"
  }
}

output "server_resource_name" {
  description = "The generated read-only Server resource name."
  value       = google_agent_registry_service.mcp_server.registry_resource
}