Usar o servidor MCP remoto da API Network Management

Neste documento, mostramos como usar o servidor MCP remoto da API Network Management para criar, visualizar e excluir Testes de conectividade.

O servidor MCP remoto da API Network Management é ativado quando você ativa a API Network Management.

O padrão do Protocolo de Contexto de Modelo (MCP) padroniza como os modelos de linguagem grandes (LLMs) e os aplicativos ou agentes de IA se conectam a fontes de dados externas. Com os servidores MCP, você pode usar as ferramentas, os recursos e os comandos deles para realizar ações e receber dados atualizados do serviço de back-end.

Qual é a diferença entre servidores MCP locais e remotos?

Servidores MCP locais
Normalmente executados na máquina local e usam os fluxos de entrada e saída padrão (stdio) para comunicação entre serviços no mesmo dispositivo.
Servidores MCP remotos
Executar na infraestrutura do serviço e oferecer um endpoint HTTP para aplicativos de IA para comunicação entre o cliente MCP de IA e o servidor MCP. Para mais informações sobre a arquitetura do MCP, consulte Arquitetura do MCP.

Núcleo sem estado

Com a versão 2026-07-28 do MCP, o MCP muda de um protocolo bidirecional com estado para um protocolo sem estado. Cada solicitação do MCP é autodescritiva e pode ser encaminhada usando cabeçalhos. Não é necessário o handshake initialize/initialized ou Mcp-Session-Id porque cada solicitação inclui todas as informações necessárias nos cabeçalhos HTTP ou no parâmetro _meta. Os servidores MCP podem solicitar mais informações necessárias para uma ferramenta usando solicitações de várias viagens de ida e volta (MRTR).

Para ajudar a encaminhar e processar solicitações sem analisar o corpo da solicitação, alguns cabeçalhos do MCP são necessários, incluindo os seguintes:

Para mais informações sobre a arquitetura do MCP, consulte a especificação e as principais mudanças da versão 2026-07-28 do MCP.

Servidores MCP remotos do Google e Google Cloud

Os servidores MCP remotos do Google e do Google Cloud têm os seguintes recursos e benefícios:

  • Descoberta simplificada e centralizada
  • Endpoints HTTP globais ou regionais gerenciados
  • Autorização detalhada
  • Segurança opcional de comandos e respostas com a proteção do Model Armor
  • Geração de registros de auditoria centralizada

Para informações sobre outros servidores MCP e controles de segurança e governança disponíveis para servidores MCP do Google Cloud, consulte Visão geral dos servidores MCP do Google Cloud.

Antes de começar

Verifique se você tem os seguintes papéis do IAM.

Funções exigidas

Para receber as permissões necessárias para usar o servidor MCP da API Network Management, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto em que você quer usar o servidor MCP:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para usar o servidor MCP da API Management de rede. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para usar o servidor MCP da API Network Management:

  • Fazer chamadas de ferramentas do MCP: mcp.tools.call
  • Crie testes de conectividade: networkmanagement.connectivitytests.create
  • Receber um teste de conectividade: networkmanagement.connectivitytests.get
  • Listar testes de conectividade: networkmanagement.connectivitytests.list
  • Excluir um teste de conectividade: networkmanagement.connectivitytests.delete

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para conferir as permissões e os papéis exatos necessários para executar testes de conectividade, consulte Permissões.

Autenticação e autorização

O servidor MCP remoto da API Network Management usa o protocolo OAuth 2.0 com o Identity and Access Management (IAM) para autenticação e autorização. Todas as Google Cloud identidades são compatíveis com a autenticação em servidores MCP.

O servidor MCP remoto da API Network Management não aceita chaves de API.

Recomendamos que você crie uma identidade separada para agentes que usam ferramentas do MCP para que o acesso aos recursos possa ser controlado e monitorado. Para mais informações sobre autenticação, consulte Autenticar em servidores do MCP.

Escopos do OAuth do MCP da API Management de rede

O OAuth 2.0 usa escopos e credenciais para determinar se um principal autenticado está autorizado a realizar uma ação específica em um recurso. Para mais informações sobre os escopos do OAuth 2.0 no Google, leia Como usar o OAuth 2.0 para acessar as APIs do Google.

A API Network Management usa o escopo OAuth https://www.googleapis.com/auth/cloud-platform.

Outros escopos podem ser necessários nos recursos acessados durante uma chamada de ferramenta.

Configurar um cliente do MCP para usar o servidor MCP da API Management da Rede

Aplicativos e agentes de IA, como Claude ou Antigravity, podem instanciar um cliente MCP que se conecta a um único servidor MCP. Um aplicativo de IA pode ter vários clientes que se conectam a diferentes servidores do MCP. Se o aplicativo não estiver listado nas orientações específicas do cliente, use as informações a seguir para se conectar na maioria dos aplicativos.

No seu aplicativo de IA, procure uma maneira de adicionar ou se conectar a um servidor MCP remoto. Para o servidor MCP da API Management de rede, insira as seguintes informações conforme necessário:

  • Nome do servidor: servidor MCP da API Management de rede
  • URL do servidor ou Endpoint: https://networkmanagement.googleapis.com/mcp
  • Transporte: HTTP transmitível
  • Detalhes da autenticação: dependendo de como você quer autenticar, é possível inserir suas Google Cloud credenciais, o ID e a chave secreta do cliente OAuth ou uma identidade e credenciais do agente. Para mais informações sobre autenticação, consulte Autenticar em servidores do MCP.
  • Escopo do OAuth: o escopo do OAuth 2.0 a ser usado ao se conectar ao servidor da API Network Management MCP. Digite https://www.googleapis.com/auth/cloud-platform.

Para orientações específicas sobre como configurar e se conectar ao servidor MCP, consulte Orientações específicas do cliente.

Para orientações mais gerais, consulte os seguintes recursos:

Ferramentas disponíveis

Para conferir detalhes das ferramentas do MCP disponíveis e as descrições delas para o servidor MCP da API Network Management, consulte a referência do MCP da API Network Management.

Ferramentas de lista

Use o inspetor do MCP para listar ferramentas ou envie uma solicitação HTTP tools/list diretamente ao servidor MCP remoto da API Network Management. O método tools/list não exige autenticação.

curl -X POST https://networkmanagement.googleapis.com/TOOLSET_ENDPOINT \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'MCP-Protocol-Version: MCP_PROTOCOL_VERSION' \
    -H 'Mcp-Method: tools/list' \
    -d '{
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/list",
      "params": {
        "_meta": {
          "io.modelcontextprotocol/protocolVersion": "MCP_PROTOCOL_VERSION",
          "io.modelcontextprotocol/clientCapabilities": {
            "extensions": {
              "io.modelcontextprotocol/ui": {
                "mimeTypes": ["text/html;profile=mcp-app"]
              }
            }
          }
        }
      }
    }'

Substitua:

  • TOOLSET_ENDPOINT: o restante do endpoint do MCP depois do nome do serviço. Por exemplo, para a API Management de rede, pode ser mcp/toolset-name.
  • MCP_PROTOCOL_VERSION: a versão do protocolo MCP. Por exemplo, 2026-07-28.

Exemplos de casos de uso

Confira a seguir exemplos de casos de uso do servidor MCP da API Network Management:

  • Criar um teste de conectividade
  • Receber e listar testes de conectividade
  • Excluir 1 teste de conectividade

Exemplo de comando:

Execute um teste de conectividade de vm-1 para vm-2 na porta 22 usando o servidor MCP da API Management de Rede.

Depois de criar o teste, siga as instruções para visualizar e excluir o recurso de teste.

Como interpretar os resultados:

  • Resultado de acessibilidade: um valor de REACHABLE em reachabilityDetails indica que a configuração de rede permite o tráfego.
  • Resultado da sondagem: um valor de REACHABLE em probingDetails confirma que as sondagens ativas enviadas entre os endpoints foram bem-sucedidas.
  • Rastreamentos: analise o rastreamento de salto a salto para ver quais recursos foram incluídos no teste.

Configurações opcionais de segurança

O MCP apresenta novos riscos e considerações de segurança devido à ampla variedade de ações que podem ser realizadas com as ferramentas do MCP. Para minimizar e gerenciar esses riscos, o Google Cloud oferece configurações padrão e políticas personalizáveis para controlar o uso das ferramentas do MCP na sua organização ou projeto do Google Cloud.

Para mais informações sobre segurança e governança do MCP, consulte Segurança e proteção de IA.

A seguir