Registrar servidores MCP

O Registro de Agente funciona como um catálogo centralizado, registrando e gerenciando endpoints de servidores do Protocolo de Contexto de Modelo (MCP) e as ferramentas específicas que eles expõem.

Este documento descreve como registrar servidores MCP e como as especificações de ferramentas são gerenciadas no Agent Registry.

Descoberta automática de servidores Google Cloud MCP

Os servidores MCP remotos e oficiais do Google são registrados e ingeridos automaticamente no Agent Registry. Os servidores MCP remotos e disponíveis do Google e do Google Cloud estão listados em Produtos compatíveis na documentação de servidores MCPGoogle Cloud . Google Cloud

Quando você ativa uma API Google Cloud compatível no seu projeto, como a API Compute Engine, o servidor MCP correspondente e as ferramentas dele são registrados imediatamente e disponibilizados para descoberta no Agent Registry. Não é necessário configurar ou fazer upload manual das especificações de ferramentas para esses servidores.

Registrar servidores MCP externos

Para gerenciar e reutilizar ferramentas fornecidas por servidores externos ou APIs personalizadas, é necessário registrar explicitamente o servidor MCP.

Ao registrar um servidor MCP manualmente, o Agent Registry registra o endpoint. No entanto, ele não faz a introspecção automática do servidor para determinar quais ferramentas estão disponíveis. Para permitir que os usuários descubram as ferramentas exatas disponíveis no seu servidor MCP, forneça as especificações delas durante o registro enviando um arquivo toolspec.json.

Antes de começar

Antes de começar, configure o Agent Registry. Você precisa do ID do projeto para realizar essas tarefas.

Para usar os comandos da CLI gcloud neste documento, configure seu ambiente da Google Cloud CLI.

Funções exigidas

Para receber as permissões necessárias para registrar servidores MCP manualmente no Agent Registry, peça ao administrador para conceder a você o papel do IAM de Editor da API Agent Registry (roles/agentregistry.editor) no projeto. 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.

Prepare a especificação da ferramenta

Crie um arquivo toolspec.json que descreva as ferramentas fornecidas pelo servidor. O tamanho máximo do arquivo de especificação é de 10 KB.

O arquivo JSON precisa estar alinhado à especificação do MCP para esquemas de ferramentas, por exemplo:

{
  "tools": [
    {
      "name": "get_customer_info",
      "description": "Retrieves customer details from the database.",
      "annotations": {
        "title": "Get Customer Info",
        "readOnlyHint": true,
        "idempotentHint": true
      }
    },
    {
      "name": "create_support_ticket",
      "description": "Creates a new support ticket in the issue tracking system.",
      "annotations": {
        "title": "Create Support Ticket",
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": true
      }
    }
  ]
}

Para requisitos estruturais detalhados, consulte Esquemas JSON e a referência REST.

Registrar o servidor e as ferramentas

Registre o servidor MCP e faça upload da definição da ferramenta simultaneamente:

Console

  1. No console do Google Cloud , acesse Registro de agentes:

    Acessar o Agent Registry

  2. No seletor de projetos, selecione o projeto Google Cloud em que você configurou o Agent Registry.

  3. Selecione a guia Servidores MCP.

  4. Clique em Adicionar servidor MCP.

  5. No painel Detalhes do servidor MCP, insira o nome de exibição, uma descrição e a região geográfica.

  6. Na seção Especificação da ferramenta, insira o URL do endpoint do servidor MCP e cole o conteúdo do arquivo toolspec.json.

    Se quiser, clique em Importar ferramentas neste painel para importar as ferramentas do MCP do URL. Essa opção só funciona se o URL do endpoint do seu servidor MCP estiver hospedado publicamente na Internet. Não é possível usar esse recurso para importar ferramentas de servidores MCP hospedados de forma privada.

  7. Clique em Próxima.

    O painel Selecionar ferramentas do MCP mostra uma lista de ferramentas com nomes e descrições do seu servidor MCP.

  8. Selecione todas as ferramentas do MCP que você quer incluir. É possível filtrar as ferramentas da lista por nome ou valor.

  9. Clique em Salvar.

gcloud

Registre o servidor MCP com a especificação da ferramenta:

gcloud alpha agent-registry services create SERVER_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --display-name="DISPLAY_NAME" \
  --mcp-server-spec-type=tool-spec \
  --mcp-server-spec-content=toolspec.json \
  --interfaces=url=SERVER_URL,protocolBinding=PROTOCOL

Substitua:

  • SERVER_NAME: o nome que você quer dar ao servidor MCP, por exemplo, custom-mcp-server.
  • PROJECT_ID: o ID do projeto.
  • REGION: a região do registro.
  • DISPLAY_NAME: o nome legível que você quer dar ao servidor, por exemplo, Custom MCP Server.
  • SERVER_URL: o URL do endpoint do servidor MCP, por exemplo, https://api.example.com/mcp.
  • PROTOCOL: a vinculação de protocolo para o endpoint. Os valores válidos são JSONRPC, HTTP_JSON ou GRPC. Para servidores MCP, esse valor geralmente é JSONRPC.

Verificar o registro

Liste, filtre e confira os detalhes do servidor MCP recém-registrado. Para confirmar se o servidor MCP foi registrado, liste os servidores no seu registro.