Mit Agent Registry können Sie MCP-Server (Model Context Protocol) und die spezifischen Tools, die sie bereitstellen, ermitteln und verwalten.
Offizielle Google- und Google Cloud Remote-MCP-Server werden automatisch registriert und in die Agent Registry aufgenommen, wenn Sie die unterstützte Google CloudAPI in Ihrem Projekt aktivieren. Sie können auch andere externe MCP-Server manuell registrieren. Weitere Informationen finden Sie unter MCP-Server registrieren.
In diesem Dokument wird beschrieben, wie Sie registrierte MCP-Server und ‑Tools ermitteln und Ihre Tooldefinitionen ändern.
Hinweis
Bevor Sie MCP-Server und ‑Tools verwalten können, müssen Sie MCP-Server in der Agent Registry registrieren. Außerdem benötigen Sie Ihre 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 folgenden IAM-Rollen für das Projekt zuzuweisen, damit Sie die nötigen Berechtigungen zum Verwalten von MCP-Servern und -Tools in der Agent Registry haben:
-
Verfügbare MCP-Server und ‑Tools ermitteln:
Agent Registry API Viewer (
roles/agentregistry.viewer) -
Tool-Definitionen aktualisieren:
Agent Registry API Editor (
roles/agentregistry.editor)
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.
Verfügbare MCP-Server und ‑Tools finden
Nach der Registrierung von MCP-Servern können Sie sie erkennen, um sie an Ihre Agents zu binden.
Alle verfügbaren MCP-Server auflisten
Sie können alle in Ihrer Umgebung registrierten MCP-Server auflisten und ihre detaillierten Konfigurationen aufrufen, z. B. ihre Endpunkte und zugehörigen Metadaten:
Console
Rufen Sie in der Google Cloud Console die Agent Registry auf:
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.
Auf der Seite wird eine Liste aller registrierten MCP-Server und ihrer Details angezeigt, z. B. Name, Kennung, Beschreibung, Laufzeit und Standort.
Wenn Sie alle Details eines Servers aufrufen möchten, klicken Sie auf den Namen des Servers.
gcloud
Verwenden Sie den Befehl mcp-servers list, um alle MCP-Server an einem bestimmten Standort aufzulisten:
gcloud agent-registry mcp-servers list \
--project=PROJECT_ID \
--location=REGION
Ersetzen Sie Folgendes:
PROJECT_ID: die Projekt-IDREGION: Die Registry-Region.
Registrierte MCP-Server filtern
Wenn Sie mehrere Server haben oder die Registrierung eines bestimmten Servers bestätigen möchten, können Sie die Liste nach den Metadaten des Servers filtern:
Console
Rufen Sie in der Google Cloud Console die Agent Registry auf:
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.
Auf der Seite wird eine Liste aller registrierten MCP-Server und ihrer Details angezeigt, z. B. Name, Kennung, Beschreibung, Laufzeit und Standort.
Wenn Sie nach Standort filtern möchten, klicken Sie auf das Menü Standort, wählen Sie die gewünschten Standorte aus und klicken Sie auf Übernehmen.
Auf der Seite wird eine gefilterte Liste der registrierten MCP-Server für die ausgewählten Bedingungen angezeigt.
gcloud
Filtern Sie die Liste mit dem Flag --filter, um nur Ressourcen zurückzugeben, die bestimmten Metadaten entsprechen:
gcloud agent-registry mcp-servers list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
Ersetzen Sie FILTER_EXPRESSION durch den Filterausdruck für die MCP-Server, die Sie filtern möchten. Sie können beispielsweise die folgenden Filter verwenden:
- Wenn Sie nach Anzeigenamen filtern möchten, verwenden Sie
displayName='DISPLAY_NAME'. - Wenn Sie nach der global eindeutigen Kennung (URN) suchen möchten, verwenden Sie
mcpServerId='urn:mcp:SERVER_URN'.
Terraform
Wenn Sie einen bestimmten registrierten MCP-Server abrufen möchten, indem Sie nach seinen Metadaten filtern, konfigurieren Sie die Datenquelle google_agent_registry_mcp_server mit dem Argument filter:
data "google_agent_registry_mcp_server" "filtered_mcp_server" {
location = "REGION"
filter = "displayName=\"DISPLAY_NAME\""
}
Ersetzen Sie Folgendes:
REGION: Die Registry-Region.DISPLAY_NAME: Der für Menschen lesbare Name des MCP-Servers, nach dem gefiltert werden soll, z. B.Custom MCP Server.
Details zu einem MCP-Server ansehen
Details zu einem bestimmten MCP-Server ansehen, z. B. die zugehörigen Tools:
Console
Rufen Sie in der Google Cloud Console die Agent Registry auf:
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.
Auf der Seite wird eine Liste aller registrierten MCP-Server und ihrer Details angezeigt, z. B. Name, Kennung, Beschreibung, Laufzeit und Standort.
Klicken Sie auf den Namen des MCP-Servers, den Sie aufrufen möchten.
Die Detailseite enthält Tabs für die MCP-Serverdetails.
Klicken Sie auf den entsprechenden Tab, um bestimmte MCP-Serverdetails aufzurufen:
- Übersicht: Wichtige Details vom MCP-Server, darunter der Name, die Kennung, der Standort und die Beschreibung des Servers. In der Übersicht wird auch ein Code-Snippet angezeigt, mit dem Sie Ihre KI-Agenten mit dem Agent Development Kit (ADK) erstellen können.
- Beobachtbarkeit: Einblicke in den Betriebsstatus und die Nutzung des MCP-Servers. Es werden anwendungsbezogene Messwerte wie Latenz, Traffic, Fehler und Token-Ausgaben angezeigt. Auf diesem Tab sind Echtzeit-Leistungsmesswerte und die Auslastung auf Systemebene zu sehen, die Ihnen helfen, Kosten zu verwalten, Fehler zu beheben und die Nutzerfreundlichkeit zu verfolgen. Die Daten werden über Google Cloud Observability bereitgestellt. Weitere Informationen finden Sie in der Übersicht zur Beobachtbarkeit.
- Tools: Der Katalog der vom Server bereitgestellten Funktionen. Auf diesem Tab werden die spezifischen Funktionen aufgeführt, die von einem MCP-Server bereitgestellt werden und die von KI-Agenten aufgerufen werden können, um bestimmte Aktionen auszuführen. Für jedes Tool wird in der Benutzeroberfläche das Schema angezeigt, einschließlich Name, Beschreibung und wichtiger Verhaltensanmerkungen, die angeben, wie ein Orchestrierungs-Agent damit interagieren sollte. Klicken Sie auf den Namen eines Tools, um ein Code-Snippet aufzurufen, mit dem Sie Ihre KI-Agenten mit dem ADK erstellen können.
gcloud
Wenn Sie die detaillierten Metadaten eines bestimmten MCP-Servers aufrufen möchten, verwenden Sie den Befehl mcp-servers describe:
gcloud agent-registry mcp-servers describe SERVER_NAME \
--project=PROJECT_ID \
--location=REGION
Ersetzen Sie SERVER_NAME durch den Namen Ihres MCP-Servers, z. B. custom-mcp-server.
Terraform
Wenn Sie Details zu einem bestimmten registrierten MCP-Server anhand seiner ID abrufen möchten, konfigurieren Sie die Datenquelle google_agent_registry_mcp_server:
data "google_agent_registry_mcp_server" "my_mcp_server" {
location = "REGION"
mcp_server_id = "SERVER_NAME"
}
output "server_create_time" {
description = "The timestamp when the MCP server was registered."
value = data.google_agent_registry_mcp_server.my_mcp_server.create_time
}
output "server_update_time" {
description = "The timestamp when the MCP server was last updated."
value = data.google_agent_registry_mcp_server.my_mcp_server.update_time
}
Ersetzen Sie Folgendes:
REGION: Die Registry-Region.SERVER_NAME: Die eindeutige Kennung Ihres MCP-Servers, z. B.custom-mcp-server.
Serverdetails und Tooldefinitionen aktualisieren
Wenn auf Ihrem MCP-Server neue Tools hinzugefügt oder vorhandene Schemas geändert werden, müssen Sie die Registry entsprechend aktualisieren. Da die Registry MCP-Server nicht automatisch untersucht, müssen Sie die aktualisierte Tool-Spezifikation manuell hochladen. Die von Ihnen hochgeladenen Inhalte ersetzen die vorhandenen Tooldefinitionen für diesen Server.
Für die Agent Registry API werden McpServer-Ressourcen für die Ermittlung verwendet. Daher müssen Sie die registrierte Service-Ressource direkt aktualisieren.
Console
So aktualisieren Sie die verfügbaren Serverdetails über die Google Cloud -Konsole:
Rufen Sie in der Google Cloud Console die Agent Registry auf:
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.
Auf der Seite wird eine Liste aller registrierten MCP-Server und ihrer Details angezeigt, z. B. Name, Kennung, Beschreibung, Laufzeit und Standort.
Klicken Sie auf den Namen des Servers, den Sie aktualisieren möchten.
Klicken Sie auf dem Tab Übersicht des Servers auf Bearbeiten.
Geben Sie im Bereich Dienst bearbeiten die aktualisierten Informationen zu Ihrem Server ein, z. B. den neuen Namen oder die neue Beschreibung.
Klicken Sie auf Speichern.
gcloud
Bereiten Sie die Spezifikation für Ihr neues Tool vor. Aktualisieren Sie dann Ihre JSON-Datei mit den neuesten Tool-Definitionen:
gcloud agent-registry services update SERVER_NAME \
--project=PROJECT_ID \
--location=REGION \
--mcp-server-spec-content=TOOL_SPEC
Ersetzen Sie Folgendes:
SERVER_NAME: Der Name Ihres MCP-Servers, z. B.custom-mcp-server.PROJECT_ID: die Projekt-IDREGION: Die Registry-Region.TOOL_SPEC: Der Name der neuen Toolspezifikation, z. B.new-toolspec.json. Die maximale Dateigröße für die Spezifikationsdatei beträgt 10 KB.
Terraform
Terraform unterstützt nur den Typ NO_SPEC für MCP-Server. Sie können die Toolspezifikationen nicht inline konfigurieren. Verwenden Sie die Google Cloud Console, die gcloud CLI oder die Agent Registry API, um die Tool-Definitionen Ihres MCP-Servers zu aktualisieren.
MCP-Server entfernen
Wenn Sie MCP-Server löschen möchten, die automatisch in der Agent Registry registriert wurden, müssen Sie den zugrunde liegenden MCP-Server löschen oder die Google Cloud API des MCP-Servers in Ihrem Projekt deaktivieren. Der Server wird dann automatisch aus der Registrierung entfernt.
Wenn Sie einen manuell registrierten MCP-Server aus der Registry entfernen möchten, müssen Sie die zugrunde liegende Service-Ressource löschen. Durch diesen Vorgang wird der MCP-Server aus den Suchergebnissen entfernt und ist für andere Tools nicht mehr auffindbar:
Console
Rufen Sie in der Google Cloud Console die Agent Registry auf:
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.
Auf der Seite wird eine Liste aller registrierten MCP-Server und ihrer Details angezeigt, z. B. Name, Kennung, Beschreibung, Laufzeit und Standort.
Klicken Sie auf den Namen des Servers, den Sie entfernen möchten.
Klicken Sie auf dem Tab Übersicht des Servers auf Löschen.
Geben Sie im Bestätigungsdialogfeld DELETE ein, um die Aktion zu bestätigen.
Klicken Sie auf Löschen.
gcloud
gcloud agent-registry services delete SERVER_NAME \
--project=PROJECT_ID \
--location=REGION
Ersetzen Sie Folgendes:
SERVER_NAME: Der Name des MCP-Servers, den Sie entfernen möchten, z. B.my-mcp-server.PROJECT_ID: die Projekt-IDREGION: Die Registry-Region.
Terraform
Entfernen Sie die Ressource google_agent_registry_service, die den MCP-Server darstellt, aus Ihrer Terraform-Konfiguration und führen Sie dann terraform apply aus.
Tool-Zugriff verwalten
Implementieren Sie Governance und Sicherheit auf Unternehmensniveau für Ihre MCP-Server und -Tools. Verwenden Sie die Agent Registry als zentralen Katalog und das Agent Gateway für die aktive Richtliniendurchsetzung.
Mit Agent Gateway können Sie Interaktionen zwischen KI-Agenten und Tools sicher verwalten, unabhängig davon, ob die KI-Agenten auf Google Cloud ausgeführt werden oder externe Entwicklertools sind.
Weitere Informationen zum Verwalten des Toolzugriffs finden Sie hier:
- IAM-Richtlinien – Übersicht: Hier können Sie festlegen, wer unter welchen Bedingungen auf bestimmte Tools zugreifen kann.
- Agent Gateway – Übersicht: Hier erfahren Sie, wie das Gateway Sicherheit und Beobachtbarkeit bei allen Interaktionen zwischen Agent und Tool (MCP) erzwingt.
- Sicherheitsergebnisse ansehen: Mit der Gemini Enterprise Agent Platform können Sie Sicherheitsinformationen für Ihr agentisches Ökosystem im Blick behalten und überprüfen.