Intégrer Model Armor aux serveurs MCP Google et Google Cloud

Ce document explique comment configurer Model Armor pour protéger vos données et sécuriser le contenu lorsque vous envoyez des requêtes à Google Cloud des services qui exposent des outils et des serveurs MCP (Model Context Protocol).

Model Armor vous aide à sécuriser vos applications d'IA agentiques en assainissant les appels et les réponses des outils MCP. Ce processus atténue les risques tels que l'injection de prompts et la divulgation de données sensibles.

Serveurs MCP compatibles

Pour obtenir la liste des serveurs Google et Google Cloud MCP compatibles, consultez la section Produits compatibles avec Model Armor.

Les paramètres de plancher Model Armor ne s'appliquent pas si vous appelez des serveurs Google et Google Cloud MCP non compatibles.

Points à prendre en compte concernant la résidence des données

Vos exigences en matière de résidence des données peuvent être affectées, selon que le service compatible avec MCP utilise le routage interjuridictionnel ou le routage conforme à la résidence des données. Pour en savoir plus, consultez la section Intégration aux serveurs Google et Google Cloud MCP.

Avant de commencer

  1. Activez l'API à laquelle vous souhaitez accéder via MCP. Pour en savoir plus, consultez la section Activer les produits compatibles.
  2. Activez l'API Model Armor dans votre projet. Pour en savoir plus, consultez la section Activer les API.
  3. Si vous avez des exigences en matière de résidence des données, vous devez configurer un récepteur de journaux pour acheminer les journaux vers un emplacement de stockage conforme avant d'activer Cloud Logging dans la procédure suivante. La configuration d'un récepteur de journaux permet de s'assurer que les journaux Model Armor sont stockés dans des buckets situés dans la juridiction appropriée. Pour en savoir plus, consultez la section Régionaliser vos journaux.

Charges utiles MCP compatibles et non compatibles

Model Armor n'assainit que les charges utiles MCP suivantes :

  • Requête et réponse tools/call
  • Requête et réponse prompts/get
  • Erreurs d'exécution des outils MCP (cible d'injection de prompts par des auteurs d'outils MCP malveillants)

Model Armor autorise les charges utiles suivantes sans assainissement :

  • tools/list
  • resources/*
  • notifications/*
  • HTTP/SSE diffusable pour MCP
  • Erreurs de protocole MCP (par exemple, toutes les erreurs autres que les erreurs d'exécution des outils)

Configurer la protection pour les serveurs Google et Google Cloud MCP distants

Pour protéger les appels et les réponses de vos outils MCP, vous pouvez utiliser les paramètres de plancher Model Armor. Un paramètre de plancher définit les filtres de sécurité minimaux qui s'appliquent à l'ensemble du projet. Cette configuration applique un ensemble cohérent de filtres à tous les appels et réponses des outils MCP du projet.

Configurez un paramètre de plancher Model Armor avec l'assainissement MCP activé. Pour en savoir plus, consultez la section Configurer les paramètres de plancher Model Armor settings.

Consultez l'exemple de commande suivant :

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"}]'

Remplacez PROJECT_ID par l'ID du Google Cloud projet.

Notez les paramètres suivants :

  • INSPECT_AND_BLOCK : type d'application qui inspecte le contenu du serveur MCP Google et bloque les prompts et les réponses qui correspondent aux filtres.
  • ENABLED : paramètre qui active un filtre ou une application.
  • MEDIUM_AND_ABOVE : niveau de confiance pour les paramètres de filtre IA responsable - Dangereux. Vous pouvez modifier ce paramètre, mais des valeurs inférieures peuvent entraîner davantage de faux positifs. Pour en savoir plus, consultez la section Niveaux de confiance Model Armor.

Vérifier la protection Model Armor

Une fois que vous avez configuré la protection Model Armor pour les serveurs MCP, vous pouvez vérifier qu'elle fonctionne en envoyant une requête contenant du contenu qui doit être bloqué et en vérifiant que Model Armor le bloque. Les étapes suivantes supposent que vous avez activé la journalisation pour Model Armor, comme décrit dans la section Configurer la protection pour les serveurs Google et Google Cloud MCP.

  1. Dans le projet où vous avez activé la protection Model Armor, appelez un outil MCP avec une valeur nuisible dans l'un de ses paramètres. Par exemple, si vous avez activé le filtre d'URI malveillant, incluez une URL de test de phishing dans un paramètre, tel que http://testsafebrowsing.appspot.com/s/phishing.html.
  2. Vérifiez que l'appel de l'outil MCP est bloqué. Selon le serveur et le client MCP, vous pouvez recevoir une erreur ou une réponse vide, indiquant que la requête a été bloquée par une stratégie de sécurité.

  3. Dans la Google Cloud console, accédez à la page Explorateur de journaux.

    Accéder à l'explorateur de journaux

  4. Dans le volet Requête, saisissez la requête suivante :

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

    Remplacez PROJECT_ID par l'ID du projet.

  5. Cliquez sur Exécuter la requête.

  6. Examinez les résultats dans la section Résultats de la requête. Si Model Armor a bloqué la requête, une entrée de journal s'affiche, détaillant la menace détectée, telle que MALICIOUS_URI_DETECTED.

Désactiver l'analyse du trafic MCP avec Model Armor

Pour empêcher Model Armor d'analyser automatiquement le trafic vers et depuis les serveurs MCP Google en fonction des paramètres de plancher du projet, exécutez la commande suivante :

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

Remplacez PROJECT_ID par l' Google Cloud ID du projet. Model Armor n'applique pas automatiquement les règles définies dans les paramètres de plancher de ce projet au trafic des serveurs MCP Google.

Les paramètres de plancher et la configuration générale de Model Armor peuvent avoir un impact sur plus que le protocole MCP. Étant donné que Model Armor s'intègre à des services tels que Gemini Enterprise Agent Platform, toute modification apportée aux paramètres de plancher peut affecter l'analyse du trafic et les comportements de sécurité dans tous les services intégrés, et pas seulement dans le protocole MCP.

Étape suivante