Premiers pas avec Google Workspace MCP et Gemini CLI

1. Introduction

Remarque : Vous utilisez toujours Gemini CLI ? Consultez cet atelier de programmation pour découvrir comment configurer des serveurs MCP Google Workspace avec la CLI Antigravity. Pour en savoir plus sur la transition, consultez cet article de blog officiel.

Dans cet atelier de programmation, vous allez apprendre à utiliser le protocole MCP (Model Context Protocol) pour connecter Gemini CLI à vos données Google Workspace. 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 utiliser la CLI Gemini comme client 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.
• Configurer la CLI Gemini pour utiliser 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
• Un compte Google Workspace
• Gemini CLI installé sur votre ordinateur local

Cet atelier de programmation vous prendra environ 30 minutes.

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.

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. Certains serveurs MCP fonctionnent de manière indépendante, mais d'autres nécessitent l'activation de l'API standard sous-jacente :

• 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 les fonctionnalités 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 pour les 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 Consigner 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 de bureau.

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 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 :
   • 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

Lorsque vous configurez un client OAuth 2.0 pour les serveurs MCP Google Workspace, vous devez activer le paramètre de classification agentique (is_agentic) en sélectionnant Utiliser ce client pour un agent optimisé par l'IA. Les clients OAuth pour lesquels ce paramètre n'est pas activé ne peuvent pas appeler les points de terminaison MCP Google Workspace.

1. Accédez à Google Auth Platform > Clients > Créer un client (ou API et services > Identifiants > Créer des identifiants > ID client OAuth).
2. Sélectionnez Application de bureau comme type d'application.
3. Nommez-le Gemini CLI.
4. Sélectionnez Utiliser ce client pour un agent basé sur l'IA pour activer l'indicateur de classification is_agentic sur le client OAuth.
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 Gemini CLI

Configurons maintenant Gemini CLI pour qu'il utilise ces points de terminaison. Si Gemini CLI n'est pas installé, suivez les instructions d'installation sur le site Web de Gemini CLI.

Environnement local requis : n'utilisez pas Cloud Shell pour cette étape. Gemini CLI nécessite un navigateur local pour l'authentification OAuth. Veuillez utiliser le terminal de votre machine locale. Pour en savoir plus, consultez Exigences concernant la redirection du navigateur.

Créer le fichier de configuration

Ouvrez ou créez ~/.gemini/settings.json dans votre répertoire d'accueil, puis ajoutez la configuration suivante. Remplacez les espaces réservés par vos identifiants OAuth.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "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"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5. Authentifier et valider les serveurs MCP

Avant de pouvoir utiliser les serveurs MCP, vous devez les authentifier et vérifier qu'ils sont connectés.

Lancer Gemini CLI

Exécutez la commande suivante dans votre terminal pour démarrer la CLI Gemini :

gemini

Authentifier

Authentifiez-vous auprès des services que vous souhaitez tester en exécutant la commande correspondante dans Gemini CLI. Vous n'avez besoin de vous authentifier qu'auprès des services que vous prévoyez d'utiliser dans cet atelier de programmation.

Agenda

/mcp auth calendar

Chat

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

Personnes

/mcp auth people

Suivez les instructions de votre navigateur pour autoriser chaque service.

Vérifier la connexion

Vérifiez que les outils sont chargés et prêts :

/mcp list

Le résultat qui s'affiche doit indiquer que les services sont Ready, avec la liste de leurs outils.

6. Tester les serveurs MCP

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.

Google Agenda

Essayez de demander à Gemini de vous parler de votre planning :

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

Google Chat

Essayez de demander à Gemini de rechercher des messages :

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

Google Drive

Demandez à Gemini de trouver ou de lire des fichiers :

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

Gmail

Demandez à Gemini 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 à l'adresse [EMAIL_ADDRESS] pour demander des nouvelles du projet [PROJECT_NAME]."

API People

Demandez à Gemini des informations sur 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 lorsque Gemini orchestre des tâches sur plusieurs services. Essayez ces prompts qui illustrent les fonctionnalités interservices :

• "Recherche dans Drive les fichiers liés aux mises à jour des étapes du projet [NOM_DU_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.

7. 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 cliquez 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.

8. Félicitations

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

Connaissances acquises

• Comment activer les services MCP Google Workspace dans Google Cloud.
• Comment configurer un client OAuth pour MCP.
• Utiliser la CLI Gemini pour interagir avec les données Google Workspace à l'aide d'outils standards

Documents de référence

• Présentation du protocole MCP (Model Context Protocol)
• Configurer les serveurs MCP Google Workspace
• Configurer le consentement OAuth