Registrar servidores MCP

O Agent Registry funciona como um catálogo centralizado, registrando e gerenciando endpoints de servidor do Protocolo de Contexto de Modelo (MCP, na sigla em inglês) e as ferramentas específicas que eles expõem.

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

Descoberta automática de Google Cloud servidores MCP

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

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

Registrar servidores MCP externos

Para gerenciar e reutilizar ferramentas fornecidas por serviços 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 inspeciona automaticamente o servidor para determinar quais ferramentas estão disponíveis. Para permitir que os usuários descubram as ferramentas exatas disponíveis no servidor MCP, é necessário fornecer as especificações da ferramenta durante o registro, fazendo upload de 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, verifique se você tem configurado o 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 personalizados papéis ou outros predefinidos papéis.

Preparar a especificação da ferramenta

Crie um arquivo toolspec.json que descreva as ferramentas fornecidas pelo servidor. Esse 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

No Google Cloud console, acesse o Agent Registry:

Acessar o Agent Registry
No seletor de projetos, selecione o Google Cloud projeto em que você configurou o Agent Registry.
Selecione a guia Servidores MCP.
Clique em Adicionar servidor MCP.
No painel Detalhes do servidor MCP , insira o nome de exibição, uma descrição e a região geográfica.
Na seção Especificação da ferramenta, insira o URL do endpoint do servidor MCP e cole o conteúdo do arquivo toolspec.json. Você também pode clicar em Importar ferramentas neste painel para importar as ferramentas MCP do URL.
Clique em Próxima.

O painel Selecionar ferramentas MCP mostra uma lista de ferramentas com nomes e descrições do servidor MCP.
Selecione todas as ferramentas MCP que você quer incluir. É possível filtrar ferramentas da lista por nome ou valor.
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, você pode listar os servidores no registro.