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

MCP-Server registrieren

Agent Registry fungiert als zentraler Katalog, indem MCP-Server-Endpunkte (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 werden in der Dokumentation zuGoogle 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 in der Agent Registry zur Erkennung verfügbar gemacht. Sie müssen keine Tool-Spezifikationen für diese Server manuell konfigurieren oder hochladen.

MCP-Server über GKE registrieren

Sie können die automatische Registrierung für benutzerdefinierte MCP-Server konfigurieren, die in Google Kubernetes Engine (GKE) bereitgestellt werden, indem Sie Ihren GKE-Bereitstellungen das Label registry.gke.io/functional-type: "MCP_SERVER" hinzufügen.

Damit die Agent Registry einen Introspektionsscan durchführen und Ihre MCP-Tools erkennen kann, muss Ihre Bereitstellung auch Anmerkungen enthalten, in denen die Endpunkt-URLs und die Funktionsdetails des Servers deklariert werden. Konfigurieren Sie außerdem Workload Identity mit der Annotation iam.gke.io/spiffe-identity-type: agent-identity, um eine sichere authentifizierte Kommunikation zu ermöglichen.

Das folgende Beispiel zeigt ein Manifest für die Bereitstellung eines GKE MCP-Servers mit diesen Konfigurationen.

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-mcp-server
  labels:
    # GKE takes this label and registers the deployment as an MCP server to the registry
    registry.gke.io/functional-type: "MCP_SERVER"
  annotations:
    # A list of endpoint URLs where the GKE controller can access this MCP server
    modelcontextprotocol.info/urls: |
      - https://my-mcp-server.default.svc.cluster.local/mcp
    # Defines structural capabilities for the MCP server card
    modelcontextprotocol.info/capabilities: |
      card:
        endpoint: "/mcp"
        protocol: "HTTP"
spec:
  selector:
    matchLabels:
      app: my-mcp-server
  template:
    metadata:
      annotations:
        # Workload Identity annotation for identity and access management
        iam.gke.io/spiffe-identity-type: agent-identity
      labels:
        app: my-mcp-server
    spec:
      containers:
      - name: server
        image: gcr.io/my-project/my-mcp-server:1.0.0

Wenn Sie die Bereitstellung anwenden, versucht GKE automatisch, die Toolspezifikation vom Server abzurufen, und registriert die Tools direkt im Datenmodell der Agent Registry.

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, wird der Endpunkt in der Agent Registry registriert. Der Server wird jedoch nicht automatisch untersucht, um zu ermitteln, welche Tools verfügbar sind. Damit Nutzer die genauen Tools auf Ihrem MCP-Server finden können, müssen Sie die Tool-Spezifikationen bei der Registrierung durch Hochladen einer toolspec.json-Datei angeben.

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 einrichten.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Registry API Editor (roles/agentregistry.editor) für das Projekt zuzuweisen, damit Sie die Berechtigungen 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.

Toolspezifikation vorbereiten

Erstellen Sie eine toolspec.json-Datei, in der die vom Server bereitgestellten Tools beschrieben werden. 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

MCP-Server registrieren und Tooldefinition gleichzeitig hochladen:

Console

Rufen Sie in der Google Cloud Console die 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 Abschnitt Tool specification (Tool-Spezifikation) die URL für den MCP-Serverendpunkt ein und fügen Sie den Inhalt der Datei toolspec.json ein.

Optional können Sie in diesem Bereich auf Tools importieren klicken, um die MCP-Tools über die 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 die Liste nach Namen 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 und GRPC. Bei MCP-Servern 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 mcp_server_spec-Block:

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
}