Com o Registro de Agente, é possível descobrir e gerenciar servidores do Protocolo de Contexto de Modelo (MCP) e as ferramentas específicas que eles expõem.
Os servidores oficiais do Google e Google Cloud remotos do MCP são registrados e ingeridos automaticamente no Agent Registry quando você ativa a API Google Cloudcompatível no 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 do MCP registrados e como modificar as definições de ferramentas.
Antes de começar
Antes de gerenciar servidores e ferramentas do MCP, registre os servidores do 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ê configurou seu Google Cloud CLI gcloud.
Funções exigidas
Para receber as permissões necessárias para gerenciar servidores e ferramentas do MCP no Agent Registry, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto:
-
Descubra os servidores e ferramentas do 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 papéis personalizados ou outros papéis predefinidos.
Descobrir servidores e ferramentas do MCP disponíveis
Depois de registrar os servidores MCP, é possível 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 console do Google Cloud , acesse Registro de agentes:
No seletor de projetos, escolha o projeto Google Cloud 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, tempo de execução e local.
Para ver 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 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 dele:
Console
No console do Google Cloud , acesse Registro de agentes:
No seletor de projetos, escolha o projeto Google Cloud 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, tempo 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 sua lista para retornar apenas recursos que correspondam a metadados específicos usando a flag --filter:
gcloud 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:
- Para filtrar por nome de exibição, use
displayName='DISPLAY_NAME'. - Para pesquisar pelo identificador (URN) globalmente exclusivo, use
mcpServerId='urn:mcp:SERVER_URN'.
Terraform
Para recuperar um servidor MCP registrado específico filtrando os metadados dele, configure a fonte de dados google_agent_registry_mcp_server com o argumento filter:
data "google_agent_registry_mcp_server" "filtered_mcp_server" {
location = "REGION"
filter = "displayName=\"DISPLAY_NAME\""
}
Substitua:
REGION: a região do registro.DISPLAY_NAME: o nome legível do servidor MCP para filtrar, por exemplo,Custom MCP Server.
Ver detalhes de um servidor MCP
Confira detalhes de um servidor MCP específico, por exemplo, as ferramentas dele:
Console
No console do Google Cloud , acesse Registro de agentes:
No seletor de projetos, escolha o projeto Google Cloud 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, tempo de execução e local.
Clique no nome do servidor MCP que você quer visualizar.
A página de detalhes inclui guias com os detalhes do servidor MCP.
Clique na guia correspondente para ver detalhes específicos do servidor MCP:
- Visão geral: detalhes principais do servidor MCP, incluindo o nome, o identificador, a localização e a descrição do servidor. A visão geral também mostra um snippet de código para que você possa criar 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 gasto de tokens. 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, ajudando 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 nome, descrição e anotações comportamentais 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 agentes usando o ADK.
gcloud
Para conferir os metadados detalhados de um servidor MCP específico, use o comando
mcp-servers describe:
gcloud 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.
Terraform
Para recuperar detalhes sobre um servidor MCP registrado específico usando o ID dele, configure a fonte de dados 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
}
Substitua:
REGION: a região do registro.SERVER_NAME: o identificador exclusivo do seu servidor MCP, por exemplo,custom-mcp-server.
Atualizar detalhes do servidor e definições de ferramentas
Se o servidor MCP adicionar novas ferramentas ou mudar os esquemas atuais, atualize o registro para refletir essas mudanças. Como o registro não faz a introspecção automática dos servidores MCP, é necessário fazer upload manual da especificação atualizada da ferramenta. O conteúdo enviado substitui as definições de ferramentas atuais para esse servidor.
Para a API Agent Registry, os recursos McpServer são usados para descoberta. Portanto, é necessário atualizar o recurso Service registrado diretamente.
Console
Atualize os detalhes do servidor disponíveis no console Google Cloud :
No console do Google Cloud , acesse Registro de agentes:
No seletor de projetos, escolha o projeto Google Cloud 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, tempo de execução e local.
Clique no nome do servidor que você quer atualizar.
Na guia Visão geral do servidor, clique em Editar.
No painel Editar serviço, insira as informações atualizadas do servidor, como o novo nome ou descrição.
Clique em Salvar.
gcloud
Prepare a especificação da nova ferramenta. Em seguida, atualize o arquivo JSON com as definições de ferramentas mais recentes:
gcloud agent-registry services update SERVER_NAME \
--project=PROJECT_ID \
--location=REGION \
--mcp-server-spec-content=TOOL_SPEC
Substitua:
SERVER_NAME: o nome do seu 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. O tamanho máximo do arquivo de especificação é de 10 KB.
Terraform
O Terraform só aceita o tipo NO_SPEC para servidores MCP. Não é possível configurar especificações de ferramentas inline. Para atualizar as definições de ferramentas do seu
servidor MCP, use o console Google Cloud , a CLI gcloud ou a
API Agent Registry.
Remover um servidor MCP
Para excluir servidores MCP que foram registrados automaticamente no Agent Registry, exclua o servidor MCP subjacente ou desative a API Google Cloud do servidor MCP no seu projeto. Em seguida, o servidor é removido automaticamente do registro.
Para remover um servidor MCP registrado manualmente do registro, é necessário excluir o recurso Service subjacente. Essa ação remove o servidor MCP dos resultados da pesquisa e o torna indetectável para outras ferramentas:
Console
No console do Google Cloud , acesse Registro de agentes:
No seletor de projetos, escolha o projeto Google Cloud 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, tempo de execução e local.
Clique no nome do servidor que você quer remover.
Na guia Visão geral do servidor, clique em Excluir.
Na caixa de diálogo de confirmação, digite EXCLUIR para confirmar a ação.
Clique em Excluir.
gcloud
gcloud agent-registry services delete SERVER_NAME \
--project=PROJECT_ID \
--location=REGION
Substitua:
SERVER_NAME: o nome do servidor MCP que você quer remover. Por exemplo,my-mcp-server.PROJECT_ID: o ID do projeto.REGION: a região do registro.
Terraform
Remova o recurso google_agent_registry_service que representa o servidor
MCP da configuração do Terraform e execute terraform apply.
Controlar o acesso às ferramentas
Implemente governança e segurança de nível empresarial para seus servidores e ferramentas do MCP. Use o Agent Registry como catálogo centralizado e o Agent Gateway para aplicação ativa de políticas.
Com o Agent Gateway, você controla com segurança as interações entre agentes e ferramentas, independentemente de os agentes estarem sendo executados no Google Cloud ou serem ferramentas de desenvolvedores externos.
Para mais informações sobre como controlar o acesso às ferramentas, consulte:
- 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 capacidade de observação em todas as interações entre agente e ferramenta (MCP).
- Ver descobertas de segurança: monitore e analise insights de segurança do seu ecossistema agêntico usando a Gemini Enterprise Agent Platform.