Serveurs MCP Google Workspace dans Google Antigravity 2.0, IDE et/ou CLI

1. Introduction

Remarque : Vous utilisez toujours Gemini CLI ? Ce guide traite de la CLI Antigravity. Pour en savoir plus sur la transition, consultez cet article de blog officiel sur la CLI Antigravity.

Vous utilisez Gemini Enterprise ? Si votre organisation utilise Gemini Enterprise, les administrateurs des clients éligibles peuvent gérer et ajouter à la liste d'autorisation les serveurs MCP approuvés de manière centralisée. Pour en savoir plus, consultez l'article de blog sur Antigravity Enterprise et notre atelier de programmation sur les serveurs MCP Google Workspace avec Antigravity dans Gemini Enterprise.

Dans cet atelier de programmation, vous allez apprendre à utiliser le protocole MCP (Model Context Protocol) pour connecter vos données Google Workspace à Antigravity 2.0, l'IDE et/ou la CLI. Le MCP est une norme ouverte qui permet aux modèles d'IA d'utiliser de manière sécurisée des outils fournis par des serveurs distants. Vous allez configurer Antigravity pour interagir avec Gmail, Google Drive, Google Docs, Google Sheets, Google Slides, Google Agenda, Google Chat et l'API People sans écrire de code.

Objectifs de l'atelier

• Activez les services MCP Google Workspace dans votre projet Google Cloud.
• Configurez Antigravity pour accéder à ces services MCP.
• Testez l'intégration avec des prompts amusants et utiles qui interagissent avec vos données Google Workspace.

Prérequis

• Un navigateur Web (par exemple, Chrome)
• Un projet Google Cloud inscrit au programme Preview développeur Google Workspace
• Un compte Google Workspace
• Antigravity 2.0, un IDE et/ou une CLI installés sur votre machine locale. Pour en savoir plus et obtenir des instructions d'installation, consultez le site Web officiel.

Accès facile à cet atelier de programmation

2. Avant de commencer

Programme Preview développeur Google Workspace : l'accès aux serveurs MCP Google Workspace fait partie du programme Preview développeur publique. Si vous ne l'avez pas encore fait, veuillez vous inscrire et vous assurer que votre compte est accepté dans le programme sur https://developers.google.com/workspace/preview.

Prérequis pour Enterprise : pour les clients éligibles, si votre organisation applique des règles Gemini Enterprise, votre administrateur doit d'abord activer les Outils pour les développeurs IA et ajouter les points de terminaison du serveur MCP Google Workspace à la liste d'autorisation dans la console Cloud avant que vous puissiez vous connecter. Pour en savoir plus, consultez l'article de blog sur Antigravity Enterprise et notre atelier de programmation sur les serveurs MCP Google Workspace avec Antigravity dans Gemini Enterprise.

Créer ou sélectionner un projet Google Cloud

Dans la console Google Cloud, sélectionnez ou créez un projet Google Cloud.

Activer les API

Pour utiliser les serveurs MCP Google Workspace, vous devez activer les API Google Workspace standards.

Activer les API

Activer les services MCP

Ensuite, activez les services MCP Google Workspace.

Activer les services MCP

Configurer l'application Chat

Pour utiliser le serveur MCP Google Chat, vous devez configurer une application Chat dans votre projet Google Cloud.

1. Dans la console Google Cloud, recherchez API Google Chat, puis cliquez sur API Google Chat > Gérer > Configuration.

Accéder à l'API Google Chat

2. Configurez l'application Chat :
   • Dans le champ Nom de l'application, saisissez Chat MCP.
   • Dans le champ URL de l'avatar, saisissez https://developers.google.com/chat/images/quickstart-app-avatar.png.
   • Dans le champ Description, saisissez Chat MCP server.
   • Sous Fonctionnalités, désactivez l'option Activer les fonctionnalités interactives.
   • Sous Journaux, sélectionnez Consigner les erreurs dans Logging.
3. Cliquez sur Enregistrer.

3. Configurer le consentement et le client OAuth

Remarque pour les entreprises : Dans un environnement Google Workspace d'entreprise, votre administrateur Cloud ou Gemini Enterprise provisionne généralement l'écran de consentement OAuth et l'ID client de manière centralisée. Si votre administrateur vous a déjà fourni un ID client approuvé, vous pouvez ignorer cette étape et passer directement à Configurer Antigravity.

Les serveurs MCP Google Workspace utilisent OAuth 2.0 pour l'authentification et l'autorisation sécurisées. Vous devez configurer un écran de consentement OAuth et créer un client d'application Web.

Configurer l'écran de consentement OAuth

Vous devez d'abord configurer l'écran de consentement.

1. Dans la console Google Cloud, accédez à Google Auth Platform > Branding. Cliquez sur Premiers pas si l'API n'est pas configurée.
2. Configurez les informations sur l'application :
   • Nom de l'application : Google Workspace MCP Servers
   • Adresse e-mail d'assistance utilisateur : sélectionnez votre adresse e-mail.
3. Configurez l'audience : sélectionnez Interne (ou Externe si l'option "Interne" n'est pas disponible).
4. Configurez les coordonnées : saisissez votre adresse e-mail.
5. Lisez et acceptez le règlement sur les données utilisateur, puis cliquez sur Créer.
6. Si vous avez sélectionné Externe, accédez à Audience et ajoutez votre adresse e-mail sous Utilisateurs de test.
7. Accédez à Accès aux données > Ajouter ou supprimer des niveaux d'accès. Sous Ajouter des niveaux d'accès manuellement, ajoutez les éléments suivants pour les serveurs que vous souhaitez utiliser :
   • Universel : https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, https://www.googleapis.com/auth/chat.messages.readonly
   • Gmail : https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • Google Drive : https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Google Docs : https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/documents.readonly, https://www.googleapis.com/auth/documents
   • Google Sheets : https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/spreadsheets.readonly, https://www.googleapis.com/auth/spreadsheets
   • Google Slides : https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file, https://www.googleapis.com/auth/presentations.readonly, https://www.googleapis.com/auth/presentations
   • Google Agenda : https://www.googleapis.com/auth/calendar.calendarlist.readonly, https://www.googleapis.com/auth/calendar.events.freebusy, https://www.googleapis.com/auth/calendar.events.readonly
   • Google Chat : https://www.googleapis.com/auth/chat.spaces.readonly, https://www.googleapis.com/auth/chat.memberships.readonly, https://www.googleapis.com/auth/chat.messages.readonly, https://www.googleapis.com/auth/chat.messages.create, https://www.googleapis.com/auth/chat.users.readstate.readonly
   • API People : https://www.googleapis.com/auth/directory.readonly, https://www.googleapis.com/auth/userinfo.profile, https://www.googleapis.com/auth/contacts.readonly
8. Cliquez sur Ajouter au tableau, puis sur Mettre à jour et enfin sur Enregistrer.

Créer un ID client OAuth

1. Accédez à Google Auth Platform > Clients > Créer un client.
2. Sélectionnez Application Web comme type d'application.
3. Nommez-le Antigravity.
4. Sous URI de redirection autorisés, cliquez sur + Ajouter un URI, puis saisissez https://antigravity.google/oauth-callback.
5. Sélectionnez Utiliser ce client pour un agent basé sur l'IA.
6. Cliquez sur Créer, puis copiez l'ID client et le code secret du client. Vous en aurez besoin à l'étape suivante.

4. Configurer Antigravity

Configurons maintenant Antigravity pour qu'il utilise ces points de terminaison. Si Antigravity 2.0, l'IDE et/ou la CLI ne sont pas installés, suivez les instructions sur le site Web d'Antigravity.

Ajouter des serveurs MCP personnalisés

Antigravity 2.0, l'IDE et la CLI partagent une configuration MCP centrale dans le fichier ~/.gemini/config/mcp_config.json.

1. Ouvrez-le dans l'éditeur de texte de votre choix.

   Remarque : Si vous avez installé l'IDE Antigravity, vous pouvez accéder au fichier directement depuis celui-ci en procédant comme suit :

   1. Ouvrez Serveurs MCP via le menu déroulant ... en haut du panneau de l'agent de l'éditeur.
   2. Cliquez sur Gérer les serveurs MCP, puis sur Afficher la configuration brute.
2. Modifiez-le avec la configuration de serveur MCP personnalisée suivante. Avant cela, remplacez les espaces réservés <YOUR_CLIENT_ID> et <YOUR_CLIENT_SECRET> par l'ID client et le code secret OAuth que vous avez créés lors des étapes précédentes.
3. Enregistrez ce plan.

{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

Authentifier des serveurs MCP personnalisés

Tous les serveurs MCP que vous avez configurés doivent s'afficher comme installés dans Antigravity : gws-universal, gws-gmail, gws-drive, gws-docs, gws-sheets, gws-slides, gws-calendar, gws-chat et gws-people. Vous devez authentifier chacun d'eux pour chaque surface Antigravity, car les jetons OAuth ne sont pas centralisés.

Résoudre les erreurs de règles d'entreprise : si un serveur MCP affiche Unauthorized / Blocked by Admin Policy lorsque vous cliquez sur Actualiser, cela signifie que ce service n'est pas inclus dans la liste d'autorisation Gemini Enterprise de votre organisation. Contactez votre administrateur pour ajouter le point de terminaison du service et partagez avec lui l'atelier de programmation Gemini Enterprise pour les administrateurs pour obtenir des conseils de configuration.

Antigravity 2.0

1. Cliquez sur Paramètres en bas à gauche.
2. Accédez à Personnalisations.
3. Sous Serveurs MCP installés, cliquez sur Actualiser.

4. Pour chaque serveur MCP installé listé :
   1. Cliquez sur Authentifier.
   
   2. Suivez le flux d'authentification dans la nouvelle fenêtre de navigateur qui s'ouvre.
   3. Une fois l'opération terminée, cliquez sur Copier dans le presse-papiers.
   
   4. Collez le code d'authentification que vous venez de copier dans le champ de texte qui s'affiche dans les paramètres d'Antigravity 2.0, puis cliquez sur Submit (Envoyer).
   
   5. Un bouton Se déconnecter s'affiche désormais à la place de S'authentifier.
   

IDE Antigravity

1. Ouvrez Antigravity User Settings (Paramètres utilisateur Antigravity) via le menu déroulant Editor-Specific settings (Paramètres spécifiques à l'éditeur) en haut de la fenêtre.

2. Accédez à Personnalisations.
3. Sous Serveurs MCP installés, cliquez sur Actualiser.

4. Pour chaque serveur MCP installé listé :
   1. Cliquez sur Authentifier.
   
   2. Suivez le flux d'authentification dans la nouvelle fenêtre de navigateur qui s'ouvre.
   3. Une fois l'opération terminée, cliquez sur Copier dans le presse-papiers.
   
   4. Collez le code d'authentification que vous venez de copier dans le champ de texte qui s'affiche dans les paramètres de l'IDE Antigravity, puis cliquez sur Envoyer.
   
   5. Un bouton Se déconnecter s'affiche désormais à la place de S'authentifier.
   

CLI Antigravity

1. Saisissez /mcp et appuyez sur Entrée.

2. Pour chaque serveur MCP listé :
   1. Sélectionnez-le à l'aide des flèches vers le haut et vers le bas, puis appuyez sur Entrée.
   2. Sélectionnez S'authentifier à l'aide des touches fléchées gauche et droite, puis appuyez sur Entrée.
   
   3. Ouvrez l'URL affichée dans une nouvelle fenêtre de navigateur et suivez le processus d'authentification.
   
   4. Une fois l'opération terminée, cliquez sur Copier dans le presse-papiers.
   
   5. Collez le code d'authentification que vous venez de copier dans le champ de texte qui s'affiche dans votre terminal avec la CLI Antigravity en cours d'exécution, puis appuyez sur Entrée.
   
   6. L'état Autorisé s'affiche désormais à la place de Autorisation requise.
   

5. Outils de test

Vous pouvez désormais interagir avec vos données Google Workspace en langage naturel. Voici quelques exemples de prompts pour chaque service.

Remarque : Remplacez les espaces réservés entre crochets dans les prompts ci-dessous (par exemple, [NAME], [FILE_NAME]) par les valeurs réelles de vos propres données Google Workspace.

Universel

Essayez de rechercher dans différents produits :

• "Résume en quelques phrases ce qui s'est passé récemment dans mon compte Google Workspace."
• "Trouve tout ce qui concerne [PROJECT_NAME] dans mes e-mails, mes documents et mes messages de chat."
• "Quand a lieu ma prochaine réunion sur le plan marketing, et quels sont les derniers messages de chat et notes à ce sujet ?"

Gmail

Essayez de rechercher ou de gérer vos e-mails :

• "Résume les cinq derniers e-mails que j'ai reçus."
• "Rédige un e-mail à [ADRESSE_E-MAIL] pour demander des nouvelles du projet [NOM_DU_PROJET]."

Google Drive

Essayez de rechercher ou de lire des fichiers :

• "Recherche les fichiers de mon Google Drive qui contiennent [MOT CLÉ]."
• "Liste les documents les plus récents que j'ai modifiés."
• "Lis le contenu de mon document '[FILE_NAME]' et résume les principaux objectifs."

Google Docs, Sheets, Slides

Essayez de rechercher vos ressources Drive :

• "Montre-moi le contenu structurel du document Google Docs [DOCS_TITLE]."
• "Lis la feuille Sheet1 de la feuille de calcul Google Sheets [SHEETS_TITLE]"
• "Montre-moi la mise en page verbalisée de la présentation Google Slides [SLIDES_TITLE]."

Google Agenda

Essayez de rechercher dans votre programmation :

• "Quelles sont mes prochaines réunions cette semaine ?"
• "Est-ce que j'ai du temps libre demain après-midi ?"

Google Chat

Essayez de rechercher des messages :

• "Recherche les messages contenant '[MOT_CLÉ]' dans '[NOM_ESPACE]'"

API People

Essayez de rechercher votre profil ou vos contacts :

• "Quel est mon nom d'après mon profil Google ?"
• "Trouve les coordonnées de [NOM]."

Combiner plusieurs services

La véritable puissance de MCP se révèle lors de l'orchestration de tâches sur plusieurs services. Essayez ces prompts qui illustrent les fonctionnalités interservices :

• "Recherche les fichiers dans Drive liés aux mises à jour des étapes de [NOM_PROJET], résume leur contenu, trouve l'adresse e-mail de [NOM] et crée un brouillon Gmail pour lui envoyer le résumé."

Découvrir d'autres outils

Ce ne sont là que quelques exemples de ce que vous pouvez faire. Pour consulter la liste complète des outils disponibles pour chaque service et les essayer, reportez-vous à la section Produits compatibles de la documentation officielle.

6. Effectuer un nettoyage

Pour nettoyer votre projet sans le supprimer, vous pouvez désactiver les API et les services MCP que vous avez activés :

1. Dans la console Google Cloud, accédez au tableau de bord des API et services.
2. Cliquez sur chacune des API Google Workspace et MCP que vous avez activées (par exemple, Calendar MCP, Chat MCP), puis sur Désactiver l'API.

Supprimez les identifiants du client OAuth dans la console Google Auth Platform si vous ne prévoyez plus de les utiliser.

7. Félicitations

Félicitations ! Vous avez configuré et testé les serveurs MCP Google Workspace officiels à l'aide d'Antigravity.

Documents de référence

• Présentation du protocole MCP (Model Context Protocol)
• Configurer les serveurs MCP Google Workspace
• Configurer le consentement OAuth
• Présentation d'Antigravity Enterprise
• Serveurs MCP Google Workspace avec Antigravity dans l'atelier de programmation Gemini Enterprise
• Antigravity