Agent Registry consente di scoprire e gestire i server Model Context Protocol (MCP) e gli specifici strumenti che espongono.
I server MCP ufficiali di Google e Google Cloud remoti vengono registrati automaticamente e inseriti in Agent Registry quando abiliti l'API supportata Google Cloud nel tuo progetto. Puoi anche registrare manualmente altri server MCP esterni. Per saperne di più, consulta Registrare i server MCP.
Questo documento descrive come scoprire gli strumenti e i server MCP registrati e come modificare le definizioni degli strumenti.
Prima di iniziare
Prima di poter gestire i server e gli strumenti MCP, registra i server MCP in Agent Registry. Per eseguire queste attività, devi anche avere l'ID progetto.
Per utilizzare i comandi gcloud CLI in questo documento, assicurati di aver configurato l'ambiente Google Cloud CLI.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per gestire i server e gli strumenti MCP in Agent Registry, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:
-
Scopri gli strumenti e i server MCP disponibili:
Agent Registry API Viewer (
roles/agentregistry.viewer) -
Aggiorna le definizioni degli strumenti:
Agent Registry API Editor (
roles/agentregistry.editor)
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Scopri gli strumenti e i server MCP disponibili
Dopo aver registrato i server MCP, puoi scoprirli per associarli ai tuoi agenti.
Elenca tutti i server MCP disponibili
Puoi elencare tutti i server MCP registrati nel tuo ambiente e visualizzarne le configurazioni dettagliate, ad esempio gli endpoint e i metadati associati:
Console
Nella Google Cloud console, vai a Agent Registry:
Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.
Seleziona la scheda Server MCP.
La pagina mostra un elenco di tutti i server MCP registrati e i relativi dettagli, come nome, identificatore, descrizione, runtime e località.
Per visualizzare i dettagli completi di un server, fai clic sul nome del server.
gcloud
Per elencare tutti i server MCP in una località specifica, utilizza il comando mcp-servers list:
gcloud agent-registry mcp-servers list \
--project=PROJECT_ID \
--location=REGION
Sostituisci quanto segue:
PROJECT_ID: l'ID progetto.REGION: la regione del registro.
Filtra i server MCP registrati
Se hai più server o se vuoi confermare la registrazione di un server specifico, puoi filtrare l'elenco in base ai metadati del server:
Console
Nella Google Cloud console, vai a Agent Registry:
Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.
Seleziona la scheda Server MCP.
La pagina mostra un elenco di tutti i server MCP registrati e i relativi dettagli, come nome, identificatore, descrizione, runtime e località.
Per filtrare in base alla località, fai clic sul menu Località , seleziona le località che vuoi filtrare e fai clic su Applica.
La pagina mostra un elenco filtrato dei server MCP registrati per le condizioni selezionate.
gcloud
Filtra l'elenco in modo da restituire solo le risorse che corrispondono a metadati specifici utilizzando il flag --filter:
gcloud agent-registry mcp-servers list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
Sostituisci FILTER_EXPRESSION con l'espressione di filtro per i server MCP che vuoi filtrare. Ad esempio, puoi utilizzare i seguenti filtri:
Terraform
Per recuperare un server MCP registrato specifico filtrando in base ai relativi metadati, configura l'origine dati google_agent_registry_mcp_server con l'argomento filter:
data "google_agent_registry_mcp_server" "filtered_mcp_server" {
location = "REGION"
filter = "displayName=\"DISPLAY_NAME\""
}
Sostituisci quanto segue:
REGION: la regione del registro.DISPLAY_NAME: il nome leggibile del server MCP in base al quale filtrare, ad esempioCustom MCP Server.
Visualizza i dettagli di un server MCP
Visualizza i dettagli di un server MCP specifico, ad esempio i relativi strumenti:
Console
Nella Google Cloud console, vai a Agent Registry:
Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.
Seleziona la scheda Server MCP.
La pagina mostra un elenco di tutti i server MCP registrati e i relativi dettagli, come nome, identificatore, descrizione, runtime e località.
Fai clic sul nome del server MCP che vuoi visualizzare.
La pagina dei dettagli include schede per i dettagli del server MCP.
Fai clic sulla scheda corrispondente per visualizzare i dettagli specifici del server MCP:
- Panoramica: dettagli principali del server MCP, inclusi nome, identificatore, località e descrizione del server. La panoramica mostra anche uno snippet di codice che ti consente di creare gli agenti utilizzando Agent Development Kit (ADK).
- Osservabilità: insight sull'integrità operativa e sull'utilizzo di il server MCP. Mostra metriche incentrate sulle applicazioni, come latenza, traffico, errori e spesa per token. Questa scheda si integra con Google Cloud Observability per visualizzare le metriche delle prestazioni in tempo reale e l'utilizzo a livello di sistema per aiutarti a gestire i costi, eseguire il debug dei problemi e monitorare l'esperienza utente. Per saperne di più, consulta la panoramica di Observability.
- Strumenti: il catalogo delle funzionalità fornite dal server. Questa scheda elenca le funzioni specifiche esposte da un server MCP che gli agenti possono richiamare per eseguire azioni specifiche. Per ogni strumento, l'interfaccia mostra lo schema, inclusi nome, descrizione e annotazioni comportamentali critiche che indicano come un agente di orchestrazione deve interagire con lo strumento. Fai clic sul nome di uno strumento per visualizzare uno snippet di codice che ti consente di creare gli agenti utilizzando il ADK.
gcloud
Per visualizzare i metadati dettagliati di un server MCP specifico, utilizza il comando mcp-servers describe:
gcloud agent-registry mcp-servers describe SERVER_NAME \
--project=PROJECT_ID \
--location=REGION
Sostituisci SERVER_NAME con il nome del server MCP, ad esempio custom-mcp-server.
Terraform
Per recuperare i dettagli di un server MCP registrato specifico utilizzando il relativo ID, configura l'origine dati 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
}
Sostituisci quanto segue:
REGION: la regione del registro.SERVER_NAME: l'identificatore univoco del server MCP, ad esempiocustom-mcp-server.
Aggiorna i dettagli del server e le definizioni degli strumenti
Se il server MCP aggiunge nuovi strumenti o modifica gli schemi esistenti, devi aggiornare il registro per riflettere queste modifiche. Poiché il registro non esegue automaticamente l'introspezione dei server MCP, devi caricare manualmente la specifica dello strumento aggiornata. I contenuti che carichi sostituiscono le definizioni degli strumenti esistenti per questo server.
Per l'API Agent Registry, le risorse McpServer vengono utilizzate per la scoperta. Pertanto, devi aggiornare direttamente la risorsa Service registrata.
Console
Aggiorna i dettagli del server disponibili dalla Google Cloud console:
Nella Google Cloud console, vai a Agent Registry:
Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.
Seleziona la scheda Server MCP.
La pagina mostra un elenco di tutti i server MCP registrati e i relativi dettagli, come nome, identificatore, descrizione, runtime e località.
Fai clic sul nome del server che vuoi aggiornare.
Nella scheda Panoramica del server, fai clic su Modifica.
Nel riquadro Modifica servizio, inserisci le informazioni aggiornate del server, ad esempio il nuovo nome o la nuova descrizione.
Fai clic su Salva.
gcloud
Prepara la nuova specifica dello strumento. Poi, aggiorna il file JSON con le definizioni degli strumenti più recenti:
gcloud agent-registry services update SERVER_NAME \
--project=PROJECT_ID \
--location=REGION \
--mcp-server-spec-content=TOOL_SPEC
Sostituisci quanto segue:
SERVER_NAME: il nome del server MCP, ad esempiocustom-mcp-server.PROJECT_ID: l'ID progetto.REGION: la regione del registro.TOOL_SPEC: il nome della nuova specifica dello strumento, ad esempionew-toolspec.json. La dimensione massima del file di specifica è 10 kB.
Terraform
Terraform supporta solo il tipo NO_SPEC per i server MCP. Non puoi configurare le specifiche degli strumenti in linea. Per aggiornare le definizioni degli strumenti del tuo
server MCP, utilizza la Google Cloud console, gcloud CLI o l'
API Agent Registry.
Rimuovi un server MCP
Per eliminare i server MCP registrati automaticamente in Agent Registry, devi eliminare il server MCP sottostante o disabilitare l' Google Cloud API del server MCP nel tuo progetto. Il server viene quindi rimosso automaticamente dal registro.
Per rimuovere un server MCP registrato manualmente dal registro, devi eliminare la risorsa Service sottostante. Questa azione rimuove il server MCP dai risultati di ricerca e lo rende non rilevabile da altri strumenti:
Console
Nella Google Cloud console, vai a Agent Registry:
Nel selettore di progetti, seleziona il Google Cloud progetto in cui hai configurato Agent Registry.
Seleziona la scheda Server MCP.
La pagina mostra un elenco di tutti i server MCP registrati e i relativi dettagli, come nome, identificatore, descrizione, runtime e località.
Fai clic sul nome del server che vuoi rimuovere.
Nella scheda Panoramica del server, fai clic Elimina.
Nella finestra di dialogo di conferma, digita DELETE per confermare l'azione.
Fai clic su Elimina.
gcloud
gcloud agent-registry services delete SERVER_NAME \
--project=PROJECT_ID \
--location=REGION
Sostituisci quanto segue:
SERVER_NAME: il nome del server MCP che vuoi rimuovere, ad esempiomy-mcp-server.PROJECT_ID: l'ID progetto.REGION: la regione del registro.
Terraform
Rimuovi la risorsa google_agent_registry_service che rappresenta il server MCP dalla configurazione di Terraform, quindi esegui terraform apply.
Controlla l'accesso agli strumenti
Implementa la governance e la sicurezza di livello aziendale per i server e gli strumenti MCP. Utilizza Agent Registry come catalogo centralizzato e Agent Gateway per l'applicazione attiva delle policy.
Agent Gateway ti consente di controllare in modo sicuro le interazioni tra agenti e strumenti, indipendentemente dal fatto che gli agenti siano in esecuzione su Google Cloud o siano strumenti di sviluppo esterni.
Per saperne di più sul controllo dell'accesso agli strumenti, consulta:
- Panoramica dei criteri IAM: definisci chi può accedere a strumenti specifici e in quali condizioni.
- Panoramica di Agent Gateway: Scopri come il gateway applica la sicurezza e l'osservabilità a tutte le interazioni da agente a strumento (MCP).
- Visualizza i risultati di sicurezza: monitora ed esamina gli insight sulla sicurezza per il tuo ecosistema di agenti utilizzando Gemini Enterprise Agent Platform.