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

1. Introduction

Remarque : Utilisez-vous toujours la Gemini CLI ? Ce guide couvre la CLI Antigravity. Pour en savoir plus sur la transition, consultez cet article de blog officiel.

Dans cet atelier de programmation, vous apprendrez à utiliser le protocole MCP (Model Context Protocol) pour connecter vos données Google Workspace à Antigravity 2.0, IDE et/ou CLI. MCP est une norme ouverte qui permet aux modèles d'IA d'utiliser en toute sécurité les outils fournis par des serveurs distants. Vous configurerez Antigravity pour interagir avec Gmail, Google Drive, 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 requêtes amusantes et utiles qui interagissent avec vos données Google Workspace.

Ce dont vous avez besoin

• Un navigateur Web (par exemple, Chrome)
• Un projet Google Cloud
• Un compte Google Workspace
• Antigravity 2.0, IDE et/ou 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 public. Si ce n'est pas déjà fait, veuillez vous inscrire et vous assurer que votre compte est accepté dans le programme sur la page https://developers.google.com/workspace/preview.

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. Bien que certains serveurs MCP fonctionnent indépendamment, d'autres nécessitent toujours que l'API standard sous-jacente soit activée :

• Gmail et Chat nécessitent toujours leurs API standards.
• Drive nécessite l'API standard pour certains outils.
• Agenda ne nécessite pas l'activation de l'API standard.
• L'API People gère à la fois l'accès standard et la fonctionnalité MCP. Elle ne dispose donc pas d'un service MCP distinct à activer.

Activer les API

Activer les services MCP

Ensuite, activez les services MCP dédiés aux produits.

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 Enregistrer les erreurs dans Logging.
3. Cliquez sur Enregistrer.

3. Configurer le consentement et le client OAuth

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

Configurer l'écran de consentement OAuth

Les serveurs MCP Google Workspace utilisent OAuth 2.0 pour l'authentification. Vous devez d'abord configurer l'écran de consentement.

1. Dans la console Google Cloud, accédez à Google Auth Platform > Branding. Cliquez sur Commencer si la configuration n'est pas effectué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. Consultez 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 testeurs.
7. Accédez à Accès aux données > Ajouter ou supprimer des champs d'application. Sous Ajouter manuellement des champs d'application, ajoutez les éléments suivants pour les serveurs que vous souhaitez utiliser :
   • 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.users.readstate.readonly
   • Google Drive: https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/drive.file
   • Gmail: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/gmail.compose
   • 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. 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

Nous allons maintenant configurer Antigravity pour utiliser ces points de terminaison. Si vous n'avez pas installé Antigravity 2.0, IDE et/ou CLI, suivez les instructions sur le site Web Antigravity.

Ajouter des serveurs MCP personnalisés

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

1. Ouvrez-le dans votre éditeur de texte préféré.

   Remarque : Vous pouvez accéder directement au fichier depuis Antigravity IDE si vous l'avez installé 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 la configuration du serveur MCP personnalisé suivante. Avant de commencer, remplacez les espaces réservés <YOUR_CLIENT_ID> et <YOUR_CLIENT_SECRET> par l'ID client OAuth et le code secret que vous avez créés lors des étapes précédentes :

{
  "mcpServers": {
    "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-drive": {
      "serverUrl": "https://drivemcp.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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

3. Enregistrez ce plan.

Authentifier les serveurs MCP personnalisés

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

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 affiché dans les paramètres d'Antigravity 2.0, puis cliquez sur Envoyer.
   
   5. Un bouton Se déconnecter s'affiche à la place du bouton Authentifier.
   

IDE Antigravity

1. Ouvrez les paramètres utilisateur Antigravity via le menu déroulant 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 affiché dans les paramètres d'Antigravity IDE, puis cliquez sur Envoyer.
   
   5. Un bouton Se déconnecter s'affiche à la place du bouton 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 haut et bas , puis appuyez sur Entrée.
   2. Sélectionnez Authentifier à l'aide des flèches gauche et droite , puis appuyez sur Entrée.
   
   3. Ouvrez l'URL affichée dans une nouvelle fenêtre de navigateur et suivez le flux 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 affiché dans votre terminal avec la CLI Antigravity en cours d'exécution, puis appuyez sur Entrée.
   
   6. L'état Authentifié s'affiche à la place de Authentification requise.
   

5. Outils de test

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

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

Google Agenda

Essayez de rechercher dans votre agenda :

• "Quelles sont mes prochaines réunions cette semaine ?"
• "Ai-je du temps libre demain après-midi ?"

Antigravity 2.0

IDE Antigravity

CLI Antigravity

Google Chat

Essayez de rechercher des messages :

• "Rechercher les messages contenant '[KEYWORD]' dans '[SPACE_NAME]'"

Google Drive

Essayez de rechercher ou de lire des fichiers :

• "Rechercher les fichiers de mon Google Drive contenant ‘[KEYWORD]'."
• "Lister les documents les plus récents que j'ai modifiés"
• "Lire le contenu de mon document ‘[FILE_NAME]' et résumer les principaux objectifs"

Gmail

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

• "Résumer les cinq derniers e-mails que j'ai reçus"
• "Rédiger un e-mail à '[EMAIL_ADDRESS]' pour demander une mise à jour sur le projet '[PROJECT_NAME]'"

API People

Essayez de rechercher votre profil ou vos contacts :

• "Selon mon profil Google, quel est mon nom ?"
• "Trouver les coordonnées de '[NAME]'"

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 requêtes qui illustrent les fonctionnalités interservices :

• "Rechercher les fichiers dans Drive liés aux 'mises à jour de l'étape clé [PROJECT_NAME]', résumer leur contenu, trouver l'adresse e-mail de '[NAME]' et créer un brouillon Gmail à leur envoyer avec le résumé"

Découvrir d'autres outils

Ce ne sont 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. Libérer de l'espace

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 API et services.
2. Cliquez sur chacune des API Google Workspace et MCP que vous avez activées (par exemple, Agenda MCP, Chat MCP), puis cliquez sur Désactiver l'API.

Supprimez les identifiants 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

• Introduction au protocole MCP (Model Context Protocol)
• Configurer les serveurs MCP Google Workspace
• Configurer le consentement OAuth
• Antigravity