Integrar com servidores MCP do Google e do Google Cloud

Este documento mostra como configurar o Model Armor para proteger seus dados e conteúdo seguro ao enviar solicitações para serviços Google Cloudque expõem ferramentas e servidores do Protocolo de Contexto de Modelo (MCP).

O Model Armor ajuda a proteger seus aplicativos de IA agêntica ao higienizar chamadas e respostas de ferramentas do MCP. Esse processo reduz riscos como injeção de comandos e divulgação de dados sensíveis.

Limitações

Considere as seguintes limitações ao integrar o Model Armor com servidores do Google e do Google Cloud MCP.

  • A integração do Model Armor e dos servidores do Google e do Google Cloud MCP oferece suporte apenas à proteção de dados sensíveis básica.
  • Se você quiser usar a proteção de dados sensíveis básica do Model Armor com servidores do Google e do Google Cloud MCP e a Gemini Enterprise Agent Platform com proteção de dados sensíveis avançada, use projetos separados para cada serviço funcionar de acordo com diferentes configurações mínimas.
  • A jurisdição define a região geográfica e o limite legal onde seus dados são tratados e armazenados. Isso é fundamental para a residência de dados, garantindo que eles permaneçam em um local escolhido para atender à conformidade regulatória. O Model Armor é um serviço regionalizado, mas não está disponível em todas as regiões Google Cloud em que os serviços compatíveis com servidores do Google e do Google Cloud MCP operam. Se você ativar o Model Armor para um serviço compatível com MCP em uma jurisdição onde o Model Armor não está disponível, seus dados poderão ser enviados para um endpoint do Model Armor em outra jurisdição para triagem de segurança. Essas chamadas entre jurisdições podem afetar os requisitos de residência de dados do serviço compatível com o MCP. Para informações sobre como as chamadas entre jurisdições afetam a residência de dados dos serviços específicos que você usa, consulte a documentação de cada serviço compatível com o MCP.
  • O Model Armor não está integrado a todos os servidores MCP do Google e do Google Cloud. Para uma lista de servidores do Google e do Google Cloud MCP compatíveis, consulte Produtos com suporte do Model Armor. As configurações mínimas do Model Armor não serão aplicadas se você chamar servidores MCP do Google e Google Cloud sem suporte.

Antes de começar

  1. Ative os servidores MCP que você quer usar. Para mais informações, consulte Ativar ou desativar servidores do MCP.
  2. Ative a API Model Armor no seu projeto. Para mais informações, consulte Ativar APIs.
  3. Se você tiver requisitos de residência de dados, configure um coletor de registros para direcionar os registros a um local de armazenamento em conformidade antes de ativar o Cloud Logging no próximo procedimento. Configurar um coletor de registros ajuda a garantir que os registros do Model Armor sejam armazenados em buckets na jurisdição adequada. Para mais informações, consulte Regionalizar seus registros.

Payloads do MCP compatíveis e incompatíveis

O Model Armor higieniza apenas os seguintes payloads da MCP:

O Model Armor permite os seguintes payloads sem higienização:

  • tools/list
  • resources/*
  • notifications/*
  • HTTP/SSE transmissível para MCP
  • Erros do protocolo MCP (por exemplo, todos os erros que não são de execução de ferramentas)

Configurar a proteção para servidores MCP remotos e do Google Google Cloud

Para proteger as chamadas e respostas de ferramentas do MCP, use as configurações mínimas do Model Armor. Uma configuração mínima define os filtros de segurança mínimos que se aplicam a todo o projeto. Essa configuração aplica um conjunto consistente de filtros a todas as chamadas e respostas de ferramentas do MCP no projeto.

Configure uma configuração do Model Armor Floor com a limpeza da MCP ativada. Para mais informações, consulte Configurar configurações mínimas do Model Armor.

Confira o exemplo de comando a seguir:

gcloud model-armor floorsettings update \
--full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
--enable-floor-setting-enforcement=TRUE \
--add-integrated-services=GOOGLE_MCP_SERVER \
--google-mcp-server-enforcement-type=INSPECT_AND_BLOCK \
--enable-google-mcp-server-cloud-logging \
--malicious-uri-filter-settings-enforcement=ENABLED \
--add-rai-settings-filters='[{"confidenceLevel": "MEDIUM_AND_ABOVE", "filterType": "DANGEROUS"}]'

Substitua PROJECT_ID pelo ID do projeto Google Cloud .

Observe as seguintes configurações:

  • INSPECT_AND_BLOCK: o tipo de aplicação que inspeciona o conteúdo do servidor MCP do Google e bloqueia solicitações e respostas que correspondem aos filtros.
  • ENABLED: a configuração que ativa um filtro ou uma restrição.
  • MEDIUM_AND_ABOVE: o nível de confiança das configurações de filtro de IA responsável - perigoso. É possível modificar essa configuração, mas valores mais baixos podem resultar em mais falsos positivos. Para mais informações, consulte Níveis de confiança do Model Armor.

Verificar a proteção do Model Armor

Depois de configurar a proteção do Model Armor para servidores MCP, é possível verificar se ela está funcionando enviando uma solicitação com conteúdo que deve ser bloqueado e verificando se o Model Armor faz isso. As etapas a seguir pressupõem que você ativou o registro em registros do Model Armor, conforme descrito em Configurar a proteção para servidores do Google e do Google Cloud MCP.

  1. No projeto em que você ativou a proteção do Model Armor, chame uma ferramenta MCP com um valor prejudicial em um dos parâmetros. Por exemplo, se você ativou o filtro de URI malicioso, inclua um URL de teste de phishing em um parâmetro, como http://testsafebrowsing.appspot.com/s/phishing.html.
  2. Verifique se a chamada da ferramenta MCP está bloqueada. Dependendo do servidor e do cliente do MCP, você pode receber um erro ou uma resposta vazia, indicando que a solicitação foi bloqueada por uma política de segurança.

  3. No console do Google Cloud , acesse a página Análise de registros.

    Acessar a Análise de registros

  4. No painel Consulta, insira a seguinte consulta:

    resource.type="model-armor_managed_service"
logName="projects/PROJECT_ID/logs/modelarmor.googleapis.com%2Fdetection"

    Substitua PROJECT_ID pela ID do seu projeto.

  5. Clique em Executar consulta.

  6. Analise os resultados na seção Resultados da consulta. Se o Model Armor bloquear a solicitação, uma entrada de registro vai detalhar a ameaça detectada, como MALICIOUS_URI_DETECTED.

Desativar a verificação do tráfego do MCP com o Model Armor

Para impedir que o Model Armor verifique automaticamente o tráfego de e para os servidores do Google MCP com base nas configurações mínimas do projeto, execute o seguinte comando:

gcloud model-armor floorsettings update \
  --full-uri='projects/PROJECT_ID/locations/global/floorSetting' \
  --remove-integrated-services=GOOGLE_MCP_SERVER

Substitua PROJECT_ID pelo Google Cloud ID do projeto. O Model Armor não aplica automaticamente as regras definidas nas configurações de limite mínimo deste projeto ao tráfego de qualquer servidor MCP do Google.

As configurações mínimas e a configuração geral do Model Armor podem afetar mais do que apenas o MCP. Como o Model Armor se integra a serviços como a Gemini Enterprise Agent Platform, as mudanças feitas nas configurações mínimas podem afetar a verificação de tráfego e os comportamentos de segurança em todos os serviços integrados, não apenas no MCP.

A seguir