Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

MCP-Server registrieren

Mit Agent Registry können Sie MCP-Server (Model Context Protocol) automatisch oder manuell registrieren, damit Entwickler und Orchestrator-Agenten standardisierte Tools in Ihrem KI-Ökosystem finden und aufrufen können.

Bei der automatischen Registrierung für benutzerdefinierte MCP-Server, die in Google Kubernetes Engine (GKE) oder Cloud Run bereitgestellt werden, werden nur Ressourcen erkannt, die im Governance-Projekt bereitgestellt wurden, in dem Agent Registry aktiviert ist. Informationen zum Registrieren benutzerdefinierter MCP-Server, die in separaten Google Cloud -Projekten bereitgestellt oder extern gehostet werden, finden Sie unter Externe MCP-Server registrieren.

Automatische Erkennung von MCP-Servern

Remote-MCP-Server von Google und Google Cloud werden automatisch in der Agent Registry registriert und aufgenommen.

Wenn Sie eine Google Cloud -API mit MCP-Unterstützung 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 die Toolspezifikationen für diese Server nicht manuell konfigurieren oder hochladen.

Standort und Bedingungen

Wenn die Agent Registry automatisch einen Google- oder Remote-MCP-Server von Google Cloudregistriert, wird die McpServer-Ressource nur am Standort global erstellt, nicht in einzelnen Regionen wie us-central1. Wenn der Dienst regionale Endpunkte (REPs) bereitstellt, listet die Agent Registry diese regionalen URLs im Feld interfaces dieser einzelnen global-McpServer-Ressource auf.

Da die automatisch registrierte Ressource nur in global vorhanden ist, beachten Sie die folgenden Bedingungen, wenn Sie den Server abfragen oder IAP-Zugriffsrichtlinien (Identity-Aware Proxy) konfigurieren:

global für automatisch registrierte Server verwenden: Geben Sie den Standort global an, wenn Sie den Server in der Agent Registry mit --location=global abfragen oder IAP-Richtlinien mit --region=global darauf anwenden. Wenn Sie eine Region wie us-central1 angeben, gibt der Befehl den Fehler NOT_FOUND zurück, da dort standardmäßig keine regionale McpServer-Ressource vorhanden ist.
Manuell in einer Region für den Datenstandort registrieren: Wenn Sie Registry-Metadaten in einer bestimmten Region speichern müssen, registrieren Sie den MCP-Server und seine regionale Endpunkt-URL manuell in dieser Region und wenden Sie dann Ihre IAP-Richtlinie in derselben Region an.

Weitere Informationen finden Sie unter Governance-Bereich für regionale und globale Standorte und Remote-MCP-Server an einem regionalen Standort nicht gefunden.

Hinweis

Agent Registry einrichten
Rufen Sie die Projekt-ID für das Governance-Projekt ab, in dem die Agent Registry aktiviert ist.
Wenn Sie die Google Cloud CLI-Befehle in diesem Dokument verwenden möchten, richten Sie Ihre gcloud CLI-Umgebung ein.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle Agent Registry API Editor (roles/agentregistry.editor) für das Governance-Projekt zuzuweisen, in dem Agent Registry aktiviert ist, um die Berechtigungen zu erhalten, die Sie zum Registrieren von MCP-Servern in 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.

MCP-Server aus GKE registrieren

Wenn Sie benutzerdefinierte MCP-Server registrieren möchten, die in GKE bereitgestellt werden, fügen Sie Ihrem Bereitstellungsmanifest die erforderlichen Kubernetes-Labels und Annotationen hinzu. Das folgende Beispiel zeigt ein Bereitstellungsmanifest für einen GKE-MCP-Server, das für die automatische Registrierung konfiguriert ist:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-mcp-server
  labels:
    # GKE takes this label and registers the deployment as an MCP server
    registry.gke.io/functional-type: "MCP_SERVER"
  annotations:
    # 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:
      labels:
        app: my-mcp-server
      annotations:
        # Agent Identity annotation for identity and access management
        iam.gke.io/spiffe-identity-type: agent-identity
    spec:
      containers:
      - name: server
        image: gcr.io/PROJECT_ID/my-mcp-server:1.0.0

Ersetzen Sie dabei PROJECT_ID durch die ID Ihres Projekts in Google Cloud .

So konfigurieren Sie das Deployment-Manifest und wenden es an:

Fügen Sie in metadata.labels des Deployment-Manifests das Label registry.gke.io/functional-type: "MCP_SERVER" hinzu.

Hinweis: GKE unterstützt auch die Annotation apphub.cloud.google.com/functional-type: "MCP_SERVER" für die Abwärtskompatibilität. Verwenden Sie jedoch das Label registry.gke.io/functional-type: "MCP_SERVER" für Ihre GKE-Bereitstellungen.
Aktivieren Sie in metadata.annotations Ihres Deployment-Manifests die automatische Erkennung Ihrer MCP-Tools, indem Sie die Annotationen modelcontextprotocol.info/urls und modelcontextprotocol.info/capabilities angeben, um die Endpunkt-URLs und Funktionsdetails des Servers zu deklarieren.
Aktivieren Sie in spec.template.metadata.annotations der Pod-Vorlage die authentifizierte Kommunikation, indem Sie die Agentenidentität mit der Annotation iam.gke.io/spiffe-identity-type: agent-identity konfigurieren.
Wenden Sie das Deployment-Manifest auf Ihren Cluster an.

Wenn Sie das Deployment anwenden, versucht die GKE automatisch, die Toolspezifikation vom Server abzurufen, und registriert den Server und seine Tools direkt in einer schreibgeschützten McpServer-Erkennungsressource in der Agent Registry. Agent Registry verwendet den Bereitstellungsnamen als Anzeigenamen für den MCP-Server.

MCP-Server aus Cloud Run registrieren

Sie können benutzerdefinierte MCP-Server automatisch registrieren, wenn Sie sie als Cloud Run-Dienste bereitstellen. Geben Sie dazu das Flag --functional-type=mcp-server an. Das Flag --functional-type=mcp-server kennzeichnet den Cloud Run-Dienst als MCP-Server und nicht als Standard-Container-Arbeitslast. Dadurch wird Cloud Run angewiesen, den Server bei der Agent Registry zu registrieren. Während der Registrierung fügt Cloud Run den Namen des Servers und den Typ MCP_SERVER automatisch der Registry hinzu.

Sie können auch einen Identitätstyp mit dem Flag --identity-type angeben. Geben Sie beispielsweise eine agent-identity- oder service-account-Identität an. Wenn keine Angabe erfolgt, wird für die Arbeitslast standardmäßig eine Dienstkontoidentität verwendet.

Informationen zum Konfigurieren der automatischen Registrierung für einen neuen oder vorhandenen Cloud Run-Dienst finden Sie unter Gemini Enterprise Agent Platform-Funktionen für Cloud Run konfigurieren. Informationen zum Bereitstellen und Sichern von MCP-Servern in Cloud Run finden Sie unter MCP-Server in Cloud Run hosten und MCP-Server authentifizieren.

Externe MCP-Server registrieren

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

Wenn Sie einen MCP-Server manuell registrieren, registriert die Agent Registry den Endpunkt. Der Server wird jedoch nicht automatisch geprüft, um festzustellen, welche Tools verfügbar sind. Damit Nutzer die genauen Tools auf Ihrem MCP-Server finden können, müssen Sie die Toolspezifikationen bei der Registrierung angeben, indem Sie eine toolspec.json-Datei hochladen.

Toolspezifikation vorbereiten

Erstellen Sie eine toolspec.json-Datei, in der die vom Server bereitgestellten Tools aufgeführt sind. Die maximale Dateigröße für diese Spezifikationsdatei beträgt 10 KB.

Die JSON-Datei muss der MCP-Spezifikation für Toolschemas entsprechen, zum Beispiel:

{
  "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 Tooldefinition hoch:

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 Toolspezifikation die URL des MCP-Serverendpunkts ein und fügen Sie den Inhalt der Datei toolspec.json ein.

Klicken Sie optional in diesem Bereich auf Tools importieren, um die MCP-Tools über die URL zu importieren. Diese Option funktioniert nur, wenn die URL für den MCP-Serverendpunkt ö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 der 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

Die von Ihnen verwendeten Spezifikations-Flags bestimmen, zu welcher Ressourcensammlung Ihre Komponente gehört. Eine vollständige Zuordnung von Flags zu Ressourcensammlungen finden Sie unter [Dienstressourcen und Erkennungsressourcen](/agent-registry/data-model#service-resources).

Registrieren Sie den MCP-Server mit der Toolspezifikation mit dem Befehl gcloud agent-registry services create:

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. Der Name muss 4 bis 63 Zeichen lang sein und darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten.
PROJECT_ID: Projekt-ID.
REGION: die Registry-Region.
DISPLAY_NAME: der menschenlesbare 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. Bei MCP-Servern ist dieser Wert oft jsonrpc.

Terraform

Der von Ihnen konfigurierte Spezifikationsblock bestimmt, zu welcher Ressourcensammlung Ihre Komponente gehört. Eine vollständige Zuordnung von Spezifikationen zu Ressourcensammlungen finden Sie unter [Dienstressourcen und Erkennungsressourcen](/agent-registry/data-model#service-resources).

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    = "TOOL_SPEC"
    content = file("toolspec.json")
  }
}

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