O Agent Registry permite descobrir e gerenciar servidores do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) e as ferramentas específicas que eles expõem.
Os servidores MCP oficiais do Google e Google Cloud remotos são registrados automaticamente e ingeridos no Agent Registry quando você ativa a API compatível Google Cloudno seu projeto. Também é possível registrar manualmente outros servidores MCP externos. Para mais informações, consulte Registrar servidores MCP.
Este documento descreve como descobrir servidores e ferramentas MCP registrados e como modificar as definições de ferramentas.
Antes de começar
Antes de gerenciar servidores e ferramentas MCP, registre os servidores MCP no Agent Registry. Você também precisa do ID do projeto para realizar essas tarefas.
Para usar os comandos da CLI gcloud neste documento, verifique se você tem configurado o ambiente da Google Cloud CLI.
Funções exigidas
Para receber as permissões necessárias para gerenciar servidores e ferramentas MCP no Agent Registry, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:
-
Descobrir servidores e ferramentas MCP disponíveis:
Leitor da API Agent Registry (
roles/agentregistry.viewer) -
Atualizar definições de ferramentas:
Editor da API Agent Registry (
roles/agentregistry.editor)
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.
Descobrir servidores e ferramentas MCP disponíveis
Depois de registrar os servidores MCP, você pode descobri-los para vinculá-los aos seus agentes.
Listar todos os servidores MCP disponíveis
É possível listar todos os servidores MCP registrados no seu ambiente e conferir as configurações detalhadas deles, como endpoints e metadados associados:
Console
No Google Cloud console, acesse o Agent Registry:
No seletor de projetos, selecione o Google Cloud projeto em que você configurou o Agent Registry.
Selecione a guia Servidores MCP.
A página mostra uma lista de todos os servidores MCP registrados e os detalhes deles, como nome, identificador, descrição, ambiente de execução e local.
Para conferir todos os detalhes de um servidor, clique no nome dele.
gcloud
Para listar todos os servidores MCP em um local específico, use o comando mcp-servers list:
gcloud alpha agent-registry mcp-servers list \
--project=PROJECT_ID \
--location=REGION
Substitua:
PROJECT_ID: o ID do projeto.REGION: a região do registro.
Filtrar servidores MCP registrados
Se você tiver vários servidores ou quiser confirmar o registro de um servidor específico, filtre a lista pelos metadados do servidor:
Console
No Google Cloud console, acesse o Agent Registry:
No seletor de projetos, selecione o Google Cloud projeto em que você configurou o Agent Registry.
Selecione a guia Servidores MCP.
A página mostra uma lista de todos os servidores MCP registrados e os detalhes deles, como nome, identificador, descrição, ambiente de execução e local.
Para filtrar por local, clique no menu Local , selecione os locais que você quer filtrar e clique em Aplicar.
A página mostra uma lista filtrada dos servidores MCP registrados para as condições selecionadas.
gcloud
Filtre a lista para retornar apenas os recursos que correspondem a metadados específicos usando a flag --filter:
gcloud alpha agent-registry mcp-servers list \
--project=PROJECT_ID \
--location=REGION \
--filter="FILTER_EXPRESSION"
Substitua FILTER_EXPRESSION pela expressão de filtro dos servidores MCP que você quer filtrar. Por exemplo, é possível usar os seguintes filtros:
Conferir detalhes de um servidor MCP
Confira detalhes de um servidor MCP específico, por exemplo, as ferramentas dele:
Console
No Google Cloud console, acesse o Agent Registry:
No seletor de projetos, selecione o Google Cloud projeto em que você configurou o Agent Registry.
Selecione a guia Servidores MCP.
A página mostra uma lista de todos os servidores MCP registrados e os detalhes deles, como nome, identificador, descrição, ambiente de execução e local.
Clique no nome do servidor MCP que você quer conferir.
A página de detalhes inclui guias para os detalhes do servidor MCP.
Clique na guia correspondente para conferir detalhes específicos do servidor MCP:
- Visão geral: detalhes principais do servidor MCP, incluindo o nome, identificador, local e a descrição do servidor. A visão geral também mostra um snippet de código para que você possa criar seus agentes usando o Kit de Desenvolvimento de Agente (ADK).
- Observabilidade: insights sobre a integridade operacional e o uso do servidor MCP. Ele mostra métricas centradas no aplicativo, como latência, tráfego, erros e gastos de token. Essa guia se integra ao Google Cloud Observability para mostrar métricas de desempenho em tempo real e utilização no nível do sistema para ajudar você a gerenciar custos, depurar problemas e acompanhar a experiência do usuário. Para mais informações, consulte a Visão geral da observabilidade.
- Ferramentas: o catálogo de recursos fornecidos pelo servidor. Essa guia lista as funções específicas expostas por um servidor MCP que os agentes podem invocar para realizar ações específicas. Para cada ferramenta, a interface mostra o esquema, incluindo o nome, a descrição e as anotações de comportamento críticas que orientam como um agente de orquestração deve interagir com ela. Clique no nome de uma ferramenta para mostrar um snippet de código que permite criar seus agentes usando o ADK.
gcloud
Para conferir os metadados detalhados de um servidor MCP específico, use o comando mcp-servers describe:
gcloud alpha agent-registry mcp-servers describe SERVER_NAME \
--project=PROJECT_ID \
--location=REGION
Substitua SERVER_NAME pelo nome do servidor MCP, por exemplo, custom-mcp-server.
Atualizar definições de ferramentas
Se o servidor MCP adicionar novas ferramentas ou mudar esquemas atuais, atualize o registro para refletir essas mudanças. Como o registro não inspeciona automaticamente os servidores MCP, é necessário fazer o upload manual da especificação de ferramenta atualizada. O conteúdo que você faz o upload substitui as definições de ferramentas atuais desse servidor.
Para a API Agent Registry, os recursos McpServer são usados para descoberta. Portanto, é necessário atualizar o recurso Service registrado diretamente.
Prepare uma nova especificação de ferramenta. Em seguida, atualize o arquivo JSON com as definições de ferramentas mais recentes:
gcloud alpha agent-registry services update SERVER_NAME \
--project=PROJECT_ID \
--location=REGION \
--mcp-server-spec-content=TOOL_SPEC
Substitua:
SERVER_NAME: o nome do servidor MCP, por exemplo,custom-mcp-server.PROJECT_ID: o ID do projeto.REGION: a região do registro.TOOL_SPEC: o nome da nova especificação de ferramenta, por exemplo,new-toolspec.json.
Controlar o acesso a ferramentas
Implemente governança e segurança de nível empresarial para seus servidores e ferramentas MCP. Use o Agent Registry como o catálogo centralizado e o Agent Gateway para aplicação ativa de políticas.
O Agent Gateway permite controlar com segurança as interações entre agentes e ferramentas, independentemente de esses agentes serem executados em Google Cloud ou serem ferramentas de desenvolvedor externas.
Para mais informações sobre como controlar o acesso a ferramentas, consulte o seguinte:
- Visão geral das políticas do IAM: Defina quem pode acessar ferramentas específicas e em quais condições.
- Visão geral do Agent Gateway: entenda como o gateway aplica segurança e observabilidade em todas as interações de agente para ferramenta (MCP).
- Conferir descobertas de segurança: monitore e analise insights de segurança para seu ecossistema agêntico usando a Gemini Enterprise Agent Platform.