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) -
Tooldefinitionen 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
Nachdem Sie MCP-Server registriert haben, 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 alpha 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 alpha 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'.
Details eines MCP-Servers ansehen
So rufen Sie Details zu einem bestimmten MCP-Server auf, 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, einschließlich des Namens, der Kennung, des Standorts und der 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 alpha 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.
Tool-Definitionen aktualisieren
Wenn auf Ihrem MCP-Server neue Tools hinzugefügt oder vorhandene Schemas geändert werden, müssen Sie die Registrierung 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.
Bereiten Sie die Spezifikation für Ihr neues Tool vor. Aktualisieren Sie dann Ihre JSON-Datei mit den neuesten Tool-Definitionen:
gcloud alpha 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.
Tool-Zugriff verwalten
Governance und Sicherheit auf Unternehmensniveau für Ihre MCP-Server und ‑Tools implementieren Verwenden Sie Agent Registry als zentralen Katalog und Agent Gateway für die aktive Richtliniendurchsetzung.
Mit Agent Gateway können Sie Interaktionen zwischen Agenten und Tools sicher verwalten, unabhängig davon, ob die 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.