Intégrer Gemini Cloud Assist à des outils tiers à l'aide de MCP

Ce document explique comment intégrer Gemini Cloud Assist et App Design Center à des outils tiers (y compris Antigravity, Gemini CLI et Cursor) à l'aide du protocole MCP (Model Context Protocol).

MCP vous permet d'intégrer les capacités agentiques de Gemini Cloud Assist et d'App Design Center directement dans vos outils tiers préférés et vos workflows personnalisés. Vous pouvez ainsi accéder à l'expertise en opérations cloud exactement là où vous travaillez déjà. Pour en savoir plus sur MCP, consultez Configurer MCP pour votre application d'IA.

Outils MCP Gemini Cloud Assist

Gemini Cloud Assist est un agent accessible via un ensemble d'outils MCP utilisant le modèle d'agents en tant qu'outils. Contrairement aux outils qui récupèrent des données ou effectuent un traitement procédural, les outils Gemini Cloud Assist exposent la fonctionnalité agentique de l'ensemble de Gemini Cloud Assist ou de workflows spécifiques. L'agent appelé par les appels d'outils MCP effectue ses propres appels d'outils en interne versGoogle Cloud. Les outils MCP suivants sont publiés pour les agents :

  • ask_cloud_assist : il s'agit de l'interface principale pour l'assistance Google Cloudet pour l'agent Gemini Cloud Assist. Toutes les fonctionnalités de Gemini Cloud Assist sont accessibles via cet outil, qui englobe celles des autres outils MCP.
  • design_infra : prend en charge les workflows de conception et d'architecture d'infrastructure sur Google Cloud. Il fonctionne avec les outils de serveur MCP App Design Center pour gérer le cycle de vie de la conception de votre infrastructure. Par exemple, il permet d'exécuter et de corriger les problèmes de sécurité, ou de déployer et de résoudre les problèmes.
  • investigate_issue : cela permet de prendre en charge les workflows de dépannage dansGoogle Cloud. Il peut effectuer un dépannage rapide ou plus approfondi à l'aide d'une ressource d'enquête.
  • invoke_operation : prend en charge les workflows de création, de mise à jour et de suppression de ressources dans Google Cloud. Cet outil n'est fonctionnel que lorsque les actions de l'agent sont activées. Les opérations d'écriture dans Gemini Cloud Assist ne peuvent être exécutées que par l'invocation de cet outil.
  • optimize_costs : permet d'analyser, de suivre et d'optimiser les coûts Google Cloud . Il fournit des détails sur les dépenses et identifie les possibilités d'améliorer l'efficacité des coûts en détectant les ressources inactives ou sous-utilisées.

Outils MCP App Design Center

Ces outils, souvent orchestrés par l'outil design_infra de Gemini Cloud Assist, gèrent les cycles de vie des applications d'infrastructure à l'aide d'App Design Center, y compris la gestion des modèles, la conformité et la correction des problèmes de sécurité, ainsi que le déploiement. Voici les outils disponibles :

  • setup_adc : initialise l'environnement App Design Center. Il s'agit d'une étape de configuration unique qui doit être effectuée avant de pouvoir utiliser d'autres outils App Design Center.
  • manage_application : gère le cycle de vie du déploiement d'une application. Utilisez cet outil pour déployer une conception validée à l'aide d'App Design Center ou pour récupérer l'état et les détails d'un déploiement existant. Il s'agit de la dernière étape qui transforme votre conception en infrastructure déployée sur Google Cloud.
  • manage_application_template : gère le contenu Infrastructure as Code (IaC) de la conception de votre infrastructure. Utilisez cette option pour enregistrer la conception en tant que modèle App Design Center, l'exporter en tant que fichiers Terraform ou la mettre à jour. Par exemple, vous pouvez utiliser cet outil pour mettre à jour la conception en modifiant les paramètres des composants et les configurations des paramètres.
  • assess_best_practices : effectue un audit complet de la sécurité et de la configuration de la conception de votre application avant le déploiement. Il valide la conception par rapport aux frameworks et aux contrôles pertinents de Security Command Center, et renvoie un rapport contenant des résultats exploitables pour la correction.
  • list_application_templates : liste tous les designs d'application disponibles.

Ces outils MCP ne doivent pas être traités comme des API stables ni configurés via des clients d'API procéduraux. Les outils de cette liste ou leurs paramètres peuvent être renommés, redéfinis, supprimés ou ajoutés au fil du temps pour tenir compte de l'évolution des fonctionnalités de Gemini Cloud Assist. Les fonctionnalités de Gemini Cloud Assist resteront stables afin que les agents clients puissent exécuter systématiquement les mêmes tâches, mais la façon dont les agents interagissent avec Gemini Cloud Assist et l'invoquent par le biais de ces outils évoluera au fil du temps.

Avant de commencer

  1. Accorder l'accès : pour utiliser MCP, vous devez disposer d'un rôle Identity and Access Management contenant l'autorisation mcp.googleapis.com/tools.call, par exemple l'un des rôles Gemini Cloud Assist suivants :

    • roles/geminicloudassist.user
    • roles/geminicloudassist.editor
    • roles/geminicloudassist.admin

  2. Si vous ne l'avez pas déjà fait, installez la gcloud CLI et ses composants bêta.

  3. Activez le service MCP dans votre projet à l'aide de la commande suivante :

    gcloud beta services mcp enable geminicloudassist.googleapis.com \
    --project=PROJECT_ID

    Remplacez PROJECT_ID par l'ID du projet Google Cloud .

  4. Authentifiez-vous à l'aide des identifiants par défaut de l'application en exécutant la commande suivante :

    gcloud auth application-default login

Configurer MCP pour votre client

La configuration client-agent dépend de l'agent que vous utilisez. Les sections suivantes fournissent des instructions pour configurer MCP pour différents clients.

Pour activer l'intégralité du workflow de conception et de déploiement, vous devez configurer votre client pour qu'il se connecte aux serveurs MCP Gemini Cloud Assist et App Design Center, et inclure le fichier SKILL.md correspondant. Les extraits suivants montrent la configuration combinée.

CLI Gemini

Configurer à l'aide d'une extension

Installez le serveur MCP en tant qu'extension Gemini CLI à l'aide de la commande suivante :

gemini extensions install https://github.com/GoogleCloudPlatform/gemini-cloud-assist-mcp

Configurer manuellement

  1. Configurez les paramètres du serveur MCP.

    Ouvrez votre fichier de paramètres Gemini CLI à portée utilisateur à l'adresse ~/.gemini/settings.json ou votre fichier de paramètres à portée de l'espace de travail à l'adresse .gemini/settings.json. Si le fichier n'existe pas, créez-le. Ajoutez ou fusionnez le bloc de configuration suivant sous la clé mcpServers. Assurez-vous que le fichier utilise un format JSON valide. Cette configuration utilise automatiquement vos Identifiants par défaut de l'application. 

    {
  "mcpServers": {
    "gemini_cloud_assist": {
      "httpUrl": "https://geminicloudassist.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      },
      "timeout": 600000
    },
    "application_design_center": {
      "httpUrl": "https://designcenter.googleapis.com/mcp",
      "authProviderType": "google_credentials",
      "oauth": {
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      },
      "timeout": 600000
    }
  }
}

  2. Créez et remplissez vos fichiers de compétence.

    Créez un fichier SKILL.md dans l'un des répertoires suivants. Copiez et collez le contenu Markdown de la compétence de votre choix à partir de la section Référence des compétences de ce document dans le fichier.

    • Champ d'application de l'espace de travail : .gemini/skills/<skill-name>/
    • Champ d'application utilisateur : ~/.gemini/skills/<skill-name>/

    Voici un exemple de structure de répertoire :

    .gemini/
└── skills/
    ├── design-and-deploy/
    │   └── SKILL.md
    └── google-gemini-cloud-assist/
        └── SKILL.md

  3. Validez vos compétences.

    Une fois que vous avez modifié vos fichiers settings.json et SKILL.md, redémarrez Gemini CLI. Exécutez les commandes suivantes pour vérifier :

    • /skills list : pour vérifier que vos skills locaux ont bien été détectés.
    • /mcp list : pour vérifier que les serveurs MCP Gemini Cloud Assist et App Design Center sont connectés.

Antigravity

  1. Installez l'extension.

    Dans Antigravity, ouvrez le marketplace Extensions. Recherchez l'extension Gemini Cloud Assist, cliquez sur Installer, puis sur Actualiser.

  2. Configurez manuellement les serveurs MCP.

    Ouvrez le volet Gérer les serveurs MCP, puis cliquez sur Afficher la configuration brute pour modifier le fichier mcp_config.json. Ajoutez ou fusionnez le bloc de configuration suivant. Cette configuration utilise vos Identifiants par défaut de l'application pour l'authentification.

    {
  "mcpServers": {
    "gemini_cloud_assist": {
      "serverUrl": "https://geminicloudassist.googleapis.com/mcp",
      "headers": {},
      "authProviderType": "google_credentials"
    },
    "application_design_center": {
      "serverUrl": "https://designcenter.googleapis.com/mcp",
      "headers": {},
      "authProviderType": "google_credentials"
    }
  }
}

  3. Vérifiez votre configuration.

    Une fois que vous avez modifié vos fichiers mcp_config.json et SKILL.md, redémarrez Antigravity. Dans le volet Agent, utilisez les commandes slash suivantes pour vérifier la connexion :

    • /skills list : vérifie que vos compétences locales ont été découvertes.
    • /mcp list : vérifie que les serveurs MCP Gemini Cloud Assist et App Design Center sont connectés.

Cursor

  1. Dans votre projet Google Cloud , créez un ID client OAuth 2.0 pour une application de bureau.

  2. Configurez URI://anysphere.cursor-mcp/oauth/callback comme URL de redirection. Pour en savoir plus, consultez la documentation Cursor.

  3. Ajoutez ou fusionnez le bloc de configuration suivant :

       {
     "mcpServers": {
       "gemini_cloud_assist": {
         "url": "https://geminicloudassist.googleapis.com/mcp",
         "auth": {
           "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
           "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
           "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
         }
       }
     }
   }

Compétences de Gemini Cloud Assist

Les outils MCP Gemini Cloud Assist et App Design Center utilisent les compétences de l'agent pour l'instruire. La compétence guide votre agent pour effectuer les tâches suivantes :

  • Chaînez plusieurs outils dans un flux de travail.
  • Traiter les informations locales pertinentes, telles que le code de déploiement Terraform, pour raisonner sur votre contexte local.
  • Répondez aux invocations explicites lorsque vous faites directement référence à la skill.

Lorsque vous utilisez des agents interactifs tels qu'Antigravity ou Gemini CLI, vous pouvez intégrer les outils MCP Gemini Cloud Assist à d'autres agents et workflows. Étant donné que ces outils offrent de nombreuses fonctionnalités qui peuvent se chevaucher avec vos outils spécialisés existants, utilisez les stratégies suivantes pour optimiser votre environnement et votre cas d'utilisation spécifiques :

  1. Personnalisez la définition de la compétence : mettez à jour le fichier SKILL.md pour spécifier les intents et les cas d'utilisation pour lesquels vous souhaitez appeler Gemini Cloud Assist. Cela garantit que l'agent n'est déclenché que pour les tâches nécessitant son expertise cloud étendue.
  2. Invoquer des compétences de manière explicite : de nombreux agents interactifs vous permettent de contrôler le moment où une compétence est déclenchée. Si votre agent le permet, vous pouvez configurer la compétence pour qu'elle nécessite une invocation manuelle à l'aide de commandes slash (/) ou de mentions (@). Cette approche vous permet de choisir précisément quand utiliser Gemini Cloud Assist plutôt qu'un autre outil spécialisé.

Référence des compétences Gemini Cloud Assist

Nous vous recommandons d'utiliser le fichier SKILL.md sur tous les agents configurés avec les outils MCP Gemini Cloud Assist. Ce fichier guide votre agent sur la manière d'utiliser les outils de manière appropriée.

Étapes suivantes