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

Le protocole MCP (Model Context Protocol) vous permet d'intégrer les capacités agentiques de Gemini Cloud Assist et App Design Center directement dans des outils tiers, tels qu'Antigravity, CLI Gemini et Cursor. Cette intégration apporte une expertise en opérations cloud et une assistance en architecture à vos workflows de développement existants. Pour en savoir plus, 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 que les agents puissent les utiliser :

  • ask_cloud_assist : il s'agit de l'interface principale pour l'assistance Google Cloud et pour l'agent Gemini Cloud Assist. Toutes les fonctionnalités de Gemini Cloud Assist sont accessibles via cet outil, qui englobe également les fonctionnalités des autres outils MCP.
  • design_infra : permet de concevoir et d'architecturer des infrastructures 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, exécuter et corriger les résultats de sécurité, ou déployer et résoudre les problèmes).
  • investigate_issue : cela permet de résoudre les problèmes dansGoogle Cloud. Il peut effectuer un dépannage rapide ou plus approfondi à l'aide d'une ressource d'investigation.
  • invoke_operation : prend en charge les workflows de création, de mise à jour et de suppression de ressources dans Google Cloud. Cet outil ne fonctionne 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 : prend en charge les workflows d'analyse, de suivi et d'optimisation des coûts Google Cloud . Il fournit des détails sur les dépenses et identifie les possibilités de réduire les coûts en trouvant 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 modèles d'application disponibles.

Ces outils MCP ne doivent pas être traités comme des API stables ni configurés via des clients 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 les mêmes tâches de manière cohérente. Toutefois, la façon dont les agents interagissent avec Gemini Cloud Assist et l'invoquent à l'aide 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, comme 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 de l'agent client 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 à 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.

Antigravity

Pour ajouter les serveurs MCP distants Gemini Cloud Assist et App Design Center à Antigravity, suivez les instructions de la section Éditeur Antigravity : intégration MCP ou procédez comme suit :

  1. Installez l'extension.

    Dans Antigravity, ouvrez la place de marché 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 et 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.

    Après avoir modifié vos fichiers mcp_config.json et SKILL.md, redémarrez Antigravity. Dans le volet Agent, exécutez 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.

ChatGPT

Vous devez disposer d'un abonnement ChatGPT Business pour utiliser les serveurs Google et Google Cloud MCP avec ChatGPT.

Pour ajouter les serveurs MCP distants Gemini Cloud Assist et App Design Center à ChatGPT, créez un ID client et un code secret client OAuth 2.0, puis ajoutez les serveurs MCP en tant que plug-ins dans ChatGPT :

  1. Créez un ID client et code secret du client OAuth 2.0 :

    1. Dans la console Google Cloud , accédez à Google Auth Platform > Clients > Créer un client.

      Accéder à la page Créer un client

      Vous êtes invité à créer un projet si vous n'en avez pas sélectionné.

    2. Dans la liste Type d'application, sélectionnez Application Web.

    3. Dans le champ Nom, saisissez le nom de votre application.

    4. Dans la section Origines JavaScript autorisées, cliquez sur + Ajouter un URI, puis saisissez https://chatgpt.com dans le champ URI.

    5. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez https://chatgpt.com/connector_platform_oauth_redirect dans le champ URI.

    6. Cliquez sur Créer. Le client est créé.

      La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

    7. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un endroit sûr. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

  2. Connectez-vous à ChatGPT en mode développeur.

  3. Suivez les instructions de la section Créer un plug-in pour ajouter un connecteur personnalisé pour chaque serveur MCP :

    • Pour Gemini Cloud Assist, définissez l'URL du serveur sur https://geminicloudassist.googleapis.com/mcp.
    • Pour App Design Center, définissez l'URL du serveur sur https://designcenter.googleapis.com/mcp.

  4. Sous OAuth ou Paramètres avancés, saisissez votre ID client et votre code secret du client OAuth.

  5. Répondez à l'invite de connexion pour activer les serveurs MCP dans le chat.

Claude.ai

Pour ajouter les serveurs MCP distants Gemini Cloud Assist et App Design Center à Claude.ai, configurez des connecteurs personnalisés avec un ID client et un code secret du client OAuth 2.0 :

  1. Créez un ID client et code secret du client OAuth 2.0 :

    1. Dans la console Google Cloud , accédez à Google Auth Platform > Clients > Créer un client.

      Accéder à la page Créer un client

      Vous êtes invité à créer un projet si vous n'en avez pas sélectionné.

    2. Dans la liste Type d'application, sélectionnez Application Web.

    3. Dans le champ Nom, saisissez le nom de votre application.

    4. Dans la section Origines JavaScript autorisées, cliquez sur + Ajouter un URI, puis saisissez https://claude.ai dans le champ URI.

    5. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez https://claude.ai/api/mcp/auth_callback dans le champ URI.

    6. Cliquez sur Créer. Le client est créé.

      La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

    7. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un endroit sûr. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

  2. Suivez les instructions pour créer un connecteur personnalisé pour chaque serveur MCP :

    • Pour Gemini Cloud Assist, définissez l'URL du serveur sur https://geminicloudassist.googleapis.com/mcp.
    • Pour App Design Center, définissez l'URL du serveur sur https://designcenter.googleapis.com/mcp.

  3. Dans le menu Paramètres avancés, saisissez votre ID client et votre code secret du client OAuth.

  4. Répondez à l'invite de connexion pour activer les serveurs MCP dans le chat.

Claude Code

Pour ajouter les serveurs MCP distants Gemini Cloud Assist et App Design Center à Cloud Code, configurez des connecteurs personnalisés avec un ID client et un code secret du client OAuth 2.0 :

  1. Installez Claude Code.

  2. Créez un ID client et code secret du client OAuth 2.0 :

    1. Dans la console Google Cloud , accédez à Google Auth Platform > Clients > Créer un client.

      Accéder à la page Créer un client

      Vous êtes invité à créer un projet si vous n'en avez pas sélectionné.

    2. Dans la liste Type d'application, sélectionnez Application Web.

    3. Dans le champ Nom, saisissez le nom de votre application.

    4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez https://claude.ai/api/mcp/auth_callback dans le champ URI.

    5. Cliquez sur Créer. Le client est créé.

      La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

    6. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un endroit sûr. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

  3. Suivez les instructions pour créer un connecteur personnalisé pour chaque serveur MCP :

    • Pour Gemini Cloud Assist, définissez l'URL du serveur sur https://geminicloudassist.googleapis.com/mcp.
    • Pour App Design Center, définissez l'URL du serveur sur https://designcenter.googleapis.com/mcp.

  4. Dans le menu Paramètres avancés, saisissez votre ID client et votre code secret du client OAuth.

  5. Répondez à l'invite de connexion pour activer les serveurs MCP dans le chat.

Claude Desktop

Pour ajouter les serveurs MCP distants Gemini Cloud Assist et App Design Center à Claude Desktop, configurez des connecteurs personnalisés avec un ID client et un code secret du client OAuth 2.0 :

  1. Installez Claude Desktop.

  2. Créez un ID client et code secret du client OAuth 2.0 :

    1. Dans la console Google Cloud , accédez à Google Auth Platform > Clients > Créer un client.

      Accéder à la page Créer un client

      Vous êtes invité à créer un projet si vous n'en avez pas sélectionné.

    2. Dans la liste Type d'application, sélectionnez Application Web.

    3. Dans le champ Nom, saisissez le nom de votre application.

    4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez https://claude.ai/api/mcp/auth_callback dans le champ URI.

    5. Cliquez sur Créer. Le client est créé.

      La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

    6. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un endroit sûr. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

  3. Suivez les instructions pour créer un connecteur personnalisé pour chaque serveur MCP :

    • Pour Gemini Cloud Assist, définissez l'URL du serveur sur https://geminicloudassist.googleapis.com/mcp.
    • Pour App Design Center, définissez l'URL du serveur sur https://designcenter.googleapis.com/mcp.

  4. Dans le menu Paramètres avancés, saisissez votre ID client et votre code secret du client OAuth.

  5. Répondez à l'invite de connexion pour activer les serveurs MCP dans le chat.

Codex

Pour ajouter les serveurs MCP distants Gemini Cloud Assist et App Design Center à Codex Enterprise, procédez comme suit :

  1. Dans l'UI Codex Enterprise, ouvrez Settings (Paramètres), sélectionnez MCP Servers (Serveurs MCP), puis cliquez sur View raw config (Afficher la configuration brute) pour ouvrir l'éditeur mcp_config.json.

  2. Ajoutez ou fusionnez le bloc de configuration suivant dans le fichier mcp_config.json. 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"
    }
  }
}

Cursor

Pour ajouter les serveurs MCP distants Gemini Cloud Assist et App Design Center à Cursor, créez un ID client et un code secret du client OAuth 2.0, puis configurez les serveurs MCP avec OAuth statique. Cursor utilise différents URI de redirection selon que vous accédez à Cursor via le Web ou une application de bureau :

  1. Créez un ID client et code secret du client OAuth 2.0 :

    Agents Web ou Cursor

    1. Dans la console Google Cloud , accédez à Google Auth Platform > Clients > Créer un client.

      Accéder à la page Créer un client

      Vous êtes invité à créer un projet si vous n'en avez pas sélectionné.

    2. Dans la liste Type d'application, sélectionnez Application Web.

    3. Dans le champ Nom, saisissez le nom de votre application.

    4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez https://www.cursor.com/agents/mcp/oauth/callback dans le champ URI.

    5. Cliquez sur Créer. Le client est créé.

      La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

    6. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un endroit sûr. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

    Ordinateur

    1. Dans la console Google Cloud , accédez à Google Auth Platform > Clients > Créer un client.

      Accéder à la page Créer un client

      Vous êtes invité à créer un projet si vous n'en avez pas sélectionné.

    2. Dans la liste Type d'application, sélectionnez Application Web.

    3. Dans le champ Nom, saisissez le nom de votre application.

    4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez http://localhost:8787/callback dans le champ URI.

    5. Cliquez sur Créer. Le client est créé.

      La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

    6. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un endroit sûr. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

  2. Suivez les instructions pour configurer le serveur MCP avec OAuth statique, puis ajoutez ou fusionnez le bloc de configuration suivant dans votre configuration Cursor MCP :

    {
  "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"]
      }
    },
    "application_design_center": {
      "url": "https://designcenter.googleapis.com/mcp",
      "auth": {
        "CLIENT_ID": "${env:OAUTH_CLIENT_ID}",
        "CLIENT_SECRET": "${env:OAUTH_CLIENT_SECRET}",
        "scopes": ["https://www.googleapis.com/auth/cloud-platform"]
      }
    }
  }
}

  3. Définissez les variables d'environnement OAUTH_CLIENT_ID et OAUTH_CLIENT_SECRET dans votre environnement.

  4. Utilisez le serveur MCP dans Chat.

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 à l'adresse ~/.gemini/settings.json ou votre fichier de paramètres au niveau 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 depuis 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/

    Remplacez SKILL_NAME par le nom du répertoire de votre skill.

    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.

    Après avoir modifié vos fichiers settings.json et SKILL.md, redémarrez Gemini CLI, puis exécutez les commandes suivantes pour vérifier votre configuration :

    • /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.

Gemini Enterprise

Pour enregistrer les serveurs MCP distants Gemini Cloud Assist et App Design Center dans Gemini Enterprise, un administrateur doit suivre les étapes suivantes :

  1. Créez un ID client et un code secret du client OAuth 2.0 avec l'URI de redirection Gemini Enterprise :

    1. Dans la console Google Cloud , accédez à Google Auth Platform > Clients > Créer un client.

      Accéder à la page Créer un client

      Vous êtes invité à créer un projet si vous n'en avez pas sélectionné.

    2. Dans la liste Type d'application, sélectionnez Application Web.

    3. Dans le champ Nom, saisissez le nom de votre application.

    4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez https://vertexaisearch.cloud.google.com/oauth-redirect dans le champ URI.

    5. Cliquez sur Créer. Le client est créé.

      La boîte de dialogue Client OAuth 2.0 créé s'ouvre.

    6. Dans la section Codes secrets du client, copiez le code secret du client et enregistrez-le dans un endroit sûr. Vous ne pouvez le copier qu'une seule fois. Si vous le perdez, supprimez le code secret et créez-en un autre.

  2. Dans la console Google Cloud , accédez à Gemini Enterprise > Datastores, puis cliquez sur Créer un datastore. Pour en savoir plus, consultez Configurer votre data store de serveur MCP personnalisé.

  3. Sélectionnez Serveur MCP personnalisé comme source de données.

  4. Configurez un datastore de serveur MCP personnalisé pour chaque point de terminaison :

    • Pour Gemini Cloud Assist, saisissez https://geminicloudassist.googleapis.com/mcp.
    • Pour App Design Center, saisissez https://designcenter.googleapis.com/mcp.

  5. Saisissez l'ID client et le code secret du client OAuth, puis enregistrez le datastore. Les outils deviennent disponibles pour les agents Gemini Enterprise.

Compétences de Gemini Cloud Assist

Les outils MCP Gemini Cloud Assist et App Design Center utilisent les compétences d'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 intentions 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 à barre oblique (/) 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 le fichier SKILL.md suivant sur tous les agents configurés avec les outils MCP Gemini Cloud Assist. Ce fichier indique à votre agent comment utiliser les outils de manière appropriée.

Étapes suivantes