Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Configurer les serveurs MCP Google Workspace

Google Workspace propose des serveurs Model Context Protocol (MCP) distants qui permettent aux agents IA d'interagir de manière sécurisée avec les données Google Workspace. En configurant les serveurs MCP Google Workspace, vous permettez aux applications d'IA comme Google Antigravity et Claude d'effectuer des actions dans les applications Google Workspace telles que Gmail, Google Drive, Google Docs, Google Sheets, Google Slides, Google Agenda, Google Chat et Google Classroom. Chaque produit Google Workspace dispose de son propre serveur MCP dédié.

Les serveurs MCP Google Workspace offrent aux agents IA un moyen standardisé de :

Lire des données : rechercher des e-mails, récupérer des fichiers et lister des événements d'agenda.
Agir : créer des brouillons d'e-mails, importer des fichiers et planifier des réunions.
Respecter la sécurité : hériter des mêmes autorisations et contrôles de gouvernance des données que l'utilisateur.

Prérequis

Être membre du programme Preview développeur Google Workspace.
Un projet Google Cloud. Pour créer un projet, consultez Créer un projet.
Un client MCP, comme Google Antigravity.
Pour exécuter les commandes de cette page, configurez la gcloud CLI dans un environnement de développement local en procédant comme suit :
1. Installez la Google Cloud CLI. Si vous avez déjà installé la gcloud CLI, assurez-vous que vous disposez de la dernière version en exécutant gcloud components update.
2. Si vous utilisez un fournisseur d'identité (IdP) externe, connectez-vous à la gcloud CLI avec votre identité fédérée. Pour en savoir plus, consultez Se connecter à la gcloud CLI avec votre identité fédérée.
3. Initialisez gcloud CLI.
Si vous configurez le serveur MCP Google Classroom, un cours de test Google Classroom avec au moins un compte d'élève de test. Si vous n'avez pas de cours Google Classroom que vous pouvez utiliser pour les tests, créez-en un dans l'interface utilisateur et ajoutez un élève test.

Configurer les serveurs MCP Google Workspace

Pour utiliser les serveurs MCP Google Workspace, vous devez les activer dans votre projet Google Cloud, puis configurer votre client MCP pour qu'il s'y connecte.

Activer les API

Pour utiliser les serveurs MCP Google Workspace, vous devez activer les API suivantes dans votre projet Google Cloud :

API Gmail
API Google Drive
API Google Docs
API Google Sheets
API Google Slides
API Google Agenda
API Google Chat
API People
Google Classroom API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.googleapis.com --project=PROJECT_ID

Remplacez PROJECT_ID par l'ID de votre projet Google Cloud.

Console

Activez les API dans la console Google Cloud :

Activer les API

Activer les services MCP

Pour activer les composants MCP pour chaque produit Google Workspace, vous devez activer les services suivants dans votre projet Google Cloud :

API Gmail MCP
API Google Drive MCP
API MCP Google Docs
API Google Sheets MCP
API Google Slides MCP
API Google Calendar MCP
API Google Chat MCP
API MCP pour les contacts
API MCP Google Classroom

CLI

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com --project=PROJECT_ID

Remplacez PROJECT_ID par l'ID de votre projet Google Cloud.

Console

Activez les services MCP dans la console Google Cloud :

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.

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

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

Pour en savoir plus sur la création d'une application Chat, consultez Choisir une architecture d'application Google Chat.

Les serveurs MCP Google Workspace utilisent OAuth 2.0 pour l'authentification et l'autorisation. Vous devez configurer l'écran de consentement OAuth avant de pouvoir créer un ID client OAuth.

Dans la console Google Cloud, accédez à Google Auth Platform > Branding.

Accéder à la page "Branding"
Si vous avez déjà configuré Google Auth Platform, vous pouvez configurer les paramètres de l'écran de consentement OAuth suivants dans Branding, Audience et Accès aux données. Si le message Google Auth Platform pas encore configuré s'affiche, cliquez sur Premiers pas :
1. Sous Informations sur l'application, dans le champ Nom de l'application, saisissez Workspace MCP Servers.
2. Dans le champ Adresse e-mail d'assistance utilisateur, sélectionnez votre adresse e-mail ou un groupe Google approprié.
3. Cliquez sur Suivant.
4. Sous Audience, sélectionnez Interne. Si vous ne pouvez pas sélectionner Interne, sélectionnez Externe.
5. Cliquez sur Suivant.
6. Sous Coordonnées, saisissez une adresse e-mail à laquelle vous recevrez des notifications en cas de modification de votre projet.
7. Cliquez sur Suivant.
8. Sous Terminer, lisez le Règlement sur les données utilisateur dans les services d'API Google. Si vous l'acceptez, sélectionnez J'accepte le Règlement sur les données utilisateur dans les services d'API Google.
9. Cliquez sur Continuer.
10. Cliquez sur Créer.
11. Si vous avez sélectionné Externe comme type d'utilisateur, ajoutez des utilisateurs de test :
  1. Cliquez sur Audience.
  2. Sous Utilisateurs de test, cliquez sur Ajouter des utilisateurs.
  3. Saisissez votre adresse e-mail et celle des autres utilisateurs de test autorisés, puis cliquez sur Enregistrer.
Cliquez sur Accès aux données > Ajouter ou supprimer des champs d'application. Un panneau s'affiche avec la liste des champs d'application de chaque API que vous avez activée dans votre projet Google Cloud.
1. Sous Ajouter des niveaux d'accès manuellement, collez les niveaux d'accès des serveurs MCP que vous souhaitez utiliser :
  - 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
  - API People :
    - https://www.googleapis.com/auth/directory.readonly
    - https://www.googleapis.com/auth/userinfo.profile
    - https://www.googleapis.com/auth/contacts.readonly
  - Google Classroom :
    - https://www.googleapis.com/auth/classroom.announcements
    - https://www.googleapis.com/auth/classroom.courses.readonly
    - https://www.googleapis.com/auth/classroom.coursework.students
    - https://www.googleapis.com/auth/classroom.courseworkmaterials
    - https://www.googleapis.com/auth/classroom.rosters.readonly
    - https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
    - https://www.googleapis.com/auth/classroom.topics.readonly
2. Cliquez sur Ajouter au tableau.
3. Cliquez sur Mettre à jour.
4. Après avoir sélectionné les champs d'application requis par votre application, sur la page Accès aux données, cliquez sur Enregistrer.

Configurer votre client MCP

Pour ajouter le serveur MCP distant Google Workspace à votre client MCP, suivez les instructions correspondant à votre client.

Antigravity

Pour ajouter les serveurs MCP distants Google Workspace à Antigravity, ajoutez la configuration du serveur à votre fichier mcp_config.json. Ces instructions sont compatibles avec Antigravity 2.0, l'IDE Antigravity et la CLI Antigravity.

Créez un ID client et un code secret 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"
2. Sélectionnez Application Web comme type d'application.
3. Saisissez un nom.
4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis ajoutez https://antigravity.google/oauth-callback dans le champ URI.
5. Sélectionnez Utiliser ce client pour un agent basé sur l'IA.
6. Cliquez sur Créer, puis copiez votre ID client et votre code secret du client.
Ouvrez ou créez le fichier de configuration ~/.gemini/config/mcp_config.json.

Ajoutez la configuration mcpServers à mcp_config.json :

{
  "mcpServers": {
    "gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    },
    "classroom": {
      "serverUrl": "https://classroommcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

Remplacez les éléments suivants :

OAUTH_CLIENT_ID : ID client que vous avez créé.
OAUTH_CLIENT_SECRET : code secret du client que vous avez créé.

Économisez mcp_config.json.
Authentifiez les serveurs MCP. Vous pouvez vous authentifier à l'aide des paramètres de l'IUG ou de la CLI :
- Pour l'IDE ou l'IUG Antigravity (Antigravity 2.0) :
  1. Ouvrez l'écran des paramètres (par exemple, cliquez sur Settings (Paramètres) en bas à gauche ou ouvrez Antigravity User Settings (Paramètres utilisateur Antigravity)).
  2. Accédez à Personnalisations.
  3. Sous Serveurs MCP installés, cliquez sur Actualiser.
  4. Pour chaque serveur listé (gmail, drive, docs, sheets, slides, calendar, chat, people et classroom), cliquez sur S'authentifier, connectez-vous à votre compte Google, copiez le code d'autorisation, collez-le dans la boîte de dialogue de saisie, puis cliquez sur Envoyer.
- Pour la CLI Antigravity :
  1. Démarrez la CLI Antigravity :
```
agy
```
  2. Ouvrez le panneau de gestion MCP interactif en exécutant la commande suivante :
```
/mcp
```
  3. Authentifiez chaque serveur MCP :
    1. Utilisez les touches fléchées pour sélectionner le serveur, accédez à l'action Authentifier, puis appuyez sur Entrée. Suivez la procédure de connexion dans votre navigateur, copiez le code d'autorisation, collez-le dans l'invite du terminal, puis appuyez sur Entrée.
    2. Répétez ces étapes pour chaque serveur que vous avez configuré (gmail, drive, docs, sheets, slides, calendar, chat, people et classroom).
Vérifiez que les serveurs sont correctement configurés et en cours d'exécution :
- Pour l'IDE ou l'IUG Antigravity : un bouton Se déconnecter s'affiche à côté de chaque serveur sous Personnalisations > Serveurs MCP installés.
- Pour la CLI Antigravity : ouvrez le panneau /mcp pour afficher les serveurs MCP configurés. Les serveurs validés et authentifiés affichent Authed à côté de leur nom dans le panneau TUI interactif. Vous pouvez sélectionner n'importe quel serveur dans la vue du tableau de bord pour inspecter son état et lister tous les outils disponibles.

Les serveurs MCP distants sont prêts à être utilisés dans Antigravity.

Claude

Pour utiliser les serveurs MCP distants Google Workspace avec Claude.ai ou Claude Desktop, vous devez disposer du forfait Claude Enterprise, Pro, Max ou Team.

Pour ajouter les serveurs MCP distants Google Workspace à Claude, configurez un connecteur personnalisé avec un ID client et un code secret OAuth.

Créez un ID client et un code secret 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"
2. Sélectionnez Application Web comme type d'application.
3. Saisissez un nom.
4. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis ajoutez https://claude.ai/api/mcp/auth_callback dans le champ URI.
5. Sélectionnez Utiliser ce client pour un agent basé sur l'IA.
6. Cliquez sur Créer, puis copiez votre ID client et votre code secret du client.
Configurez le serveur MCP dans Claude :
1. Dans Claude.ai ou Claude Desktop, accédez à Settings (Paramètres) ou Admin settings (Paramètres d'administration) > Connectors (Connecteurs).
2. Cliquez sur Ajouter un connecteur personnalisé.
3. Saisissez les informations de connexion pour le produit Google Workspace que vous souhaitez ajouter :
  - Nom du serveur : nom du serveur, par exemple Gmail.
  - URL du serveur MCP distant : URL du produit Google Workspace, par exemple l'une des suivantes :
    - Gmail : https://gmailmcp.googleapis.com/mcp/v1
    - Google Drive : https://drivemcp.googleapis.com/mcp/v1
    - Google Docs : https://docsmcp.googleapis.com/mcp/v1
    - Google Sheets : https://sheetsmcp.googleapis.com/mcp/v1
    - Google Slides : https://slidesmcp.googleapis.com/mcp/v1
    - Google Agenda : https://calendarmcp.googleapis.com/mcp/v1
    - Google Chat : https://chatmcp.googleapis.com/mcp/v1
    - API People : https://people.googleapis.com/mcp/v1
    - Google Classroom : https://classroommcp.googleapis.com/mcp/v1
4. Dans Paramètres avancés, saisissez votre ID client OAuth et votre code secret du client OAuth.
5. Cliquez sur Ajouter.
6. Répétez ces étapes pour chaque produit Google Workspace que vous souhaitez ajouter.

Autres

De nombreuses applications d'IA proposent des moyens de se connecter à un serveur MCP distant. Vous devez généralement saisir des informations sur le serveur, telles que son nom, ses points de terminaison, son protocole de transport et sa méthode d'authentification. Pour les serveurs MCP distants Google Workspace, saisissez les informations suivantes :

Nom du serveur : googleworkspace
Serveurs : chaque produit Google Workspace possède sa propre URL de serveur :
- Gmail : https://gmailmcp.googleapis.com/mcp/v1
- Google Drive : https://drivemcp.googleapis.com/mcp/v1
- Google Docs : https://docsmcp.googleapis.com/mcp/v1
- Google Sheets : https://sheetsmcp.googleapis.com/mcp/v1
- Google Slides : https://slidesmcp.googleapis.com/mcp/v1
- Google Agenda : https://calendarmcp.googleapis.com/mcp/v1
- Google Chat : https://chatmcp.googleapis.com/mcp/v1
- API People : https://people.googleapis.com/mcp/v1
- Google Classroom : https://classroommcp.googleapis.com/mcp/v1
Transport : HTTP diffusable en streaming
Authentification : le serveur MCP distant Google Workspace utilise OAuth 2.0. Lorsque vous créez votre client OAuth 2.0, sélectionnez Utiliser ce client pour un agent basé sur l'IA. Pour en savoir plus, consultez En savoir plus sur l'authentification et l'autorisation.

Votre client MCP a besoin d'un jeton d'actualisation pour éviter que les utilisateurs ne doivent se reconnecter toutes les heures environ. Le serveur OAuth 2.0 de Google n'émet un jeton d'actualisation que lorsque la requête d'autorisation inclut access_type=offline. Si vous ne demandez que le champ d'application OpenID Connect (OIDC) offline_access, vous n'en obtiendrez pas. Si votre client MCP accepte les paramètres d'autorisation personnalisés, ajoutez access_type=offline à la requête d'autorisation. Pour obtenir un nouveau jeton d'actualisation pour un utilisateur qui a déjà accordé l'accès, ajoutez également prompt=consent. Si votre client MCP n'accepte pas les paramètres d'autorisation personnalisés, les utilisateurs doivent se reconnecter chaque fois que le jeton d'accès expire. Pour en savoir plus, consultez Actualiser un jeton d'accès.

Pour en savoir plus sur la connexion de différents types de clients, consultez Configurer le MCP dans une application d'IA.

Tester les serveurs MCP Google Workspace

Après avoir configuré le client MCP, vous pouvez vérifier la connexion en exécutant des prompts de test.

Essayez de poser les questions suivantes à votre client MCP :

"Qu'a dit Ariel dans son dernier e-mail sur notre plan marketing ?"

Le client filtre les e-mails d'Ariel à l'aide de gmail.search_threads, récupère le contenu du dernier fil de discussion avec gmail.get_thread, puis le résume pour vous.
"Rédige un e-mail à ariel@example.com pour lui dire que j'approuve le plan marketing."

Le client utilise gmail.create_draft pour créer un e-mail dans votre dossier de brouillons, ce qui vous permet de le vérifier et de l'envoyer depuis Gmail.
"Résume le fichier Plan marketing."

Le client appelle drive.search_files pour localiser "Plan marketing", puis utilise drive.read_file_content pour récupérer et résumer son contenu.
"Affiche-moi le contenu structurel du document Google Docs 'Notes de réunion'."

Le client récupère la structure et le contenu du document à l'aide de docs.read_doc.
"Lis la feuille Feuille1 de la feuille de calcul Google 'Ventes trimestrielles'."

Le client récupère les valeurs de la grille à l'aide de sheets.get_values.
"Montre-moi la mise en page verbalisée de la présentation Google Slides 'Présentation du produit'."

Le client récupère les structures de présentation visuelle à l'aide de slides.read_presentation.
"Quand est ma prochaine réunion avec Ariel ?"

Le client vérifie votre planning à l'aide de calendar.list_events et détaille votre prochaine réunion avec Ariel.
"D'après mon profil Google, comment est-ce que je m'appelle ?"

Le client utilise people.get_user_profile pour récupérer les informations de votre profil Google Workspace.
"Quels cours est-ce que j'enseigne actuellement ?"

Le client vérifie votre emploi du temps à l'aide de classroom.list_course_summaries et résume les cours actifs dans lesquels vous avez le rôle d'enseignant.
"Pour mon cours de géologie, rédige une annonce concernant la prochaine sortie sur le terrain."

Le client utilise classroom.create_announcement pour rédiger l'annonce, que vous pouvez examiner et publier dans l'application Google Classroom.

Si les outils s'exécutent correctement et que vous recevez des réponses pertinentes, vos serveurs MCP Google Workspace sont correctement configurés.

Dépannage

Si vous rencontrez des problèmes de connexion aux serveurs MCP, vous pouvez rechercher les erreurs dans les journaux OAuth. Demandez à votre administrateur de vérifier les événements de journaux OAuth dans l'outil d'investigation de sécurité.

Si vos requêtes adressées aux serveurs MCP sont refusées, vérifiez que l'option Utiliser ce client pour un agent optimisé par l'IA est sélectionnée pour votre client OAuth 2.0 dans Google Auth Platform > Clients. Si vous ne pouvez pas modifier ce paramètre sur un client OAuth existant, créez un client OAuth avec l'option Utiliser ce client pour un agent optimisé par l'IA sélectionnée et mettez à jour votre application pour l'utiliser. Si un client OAuth existant est utilisé à la fois pour les fonctionnalités d'agent IA et les fonctionnalités non liées à l'agent, créez un client OAuth distinct pour l'agent IA et conservez le client existant pour vos fonctionnalités non liées à l'agent. Pour obtenir des instructions, consultez Configurer votre client MCP et Gérer les clients OAuth.

Si votre application utilise un compte de service avec délégation au niveau du domaine, vous ne pouvez pas sélectionner Utiliser ce client pour un agent optimisé par l'IA, car les comptes de service ne sont pas gérés dans Google Auth Platform > Clients. Les requêtes adressées aux serveurs MCP par des comptes de service qui utilisent la délégation au niveau du domaine ne sont pas rejetées pour cette raison. L'accès est contrôlé par les paramètres de délégation au niveau du domaine gérés par votre administrateur Google Workspace. Pour en savoir plus, consultez Contrôler l'accès à l'API à l'aide de la délégation au niveau du domaine.

Si vous appelez les serveurs MCP depuis Google Apps Script, Apps Script crée et gère un client OAuth par défaut pour votre script, mais vous ne pouvez pas sélectionner Utiliser ce client pour un agent optimisé par l'IA pour celui-ci. Cela s'applique même si votre script utilise un projet Google Cloud standard. Procédez plutôt comme suit :

Dans la console Google Cloud, accédez à Google Auth Platform > Clients, créez un client OAuth, puis sélectionnez Utiliser ce client pour un agent optimisé par l'IA.
Dans votre script, utilisez la bibliothèque OAuth2 pour Apps Script afin d'autoriser les utilisateurs avec ce client OAuth.
Lorsque vous appelez les serveurs MCP, envoyez le jeton d'accès renvoyé par la bibliothèque au lieu du jeton de ScriptApp.getOAuthToken.

Les projets Apps Script qui n'appellent pas les serveurs MCP ne sont pas concernés.

Si vous êtes invité à vous reconnecter toutes les heures environ, cela signifie que votre client MCP ne reçoit pas de jeton d'actualisation. Le serveur OAuth 2.0 de Google n'émet un jeton d'actualisation que lorsque la requête d'autorisation inclut access_type=offline. Si vous ne demandez que le champ d'application OpenID Connect (OIDC) offline_access, vous n'en obtiendrez pas. Si votre client MCP accepte les paramètres d'autorisation personnalisés, ajoutez access_type=offline à la requête d'autorisation. Pour obtenir un nouveau jeton d'actualisation pour un utilisateur qui a déjà accordé l'accès, ajoutez également prompt=consent. Si votre client MCP n'accepte pas les paramètres d'autorisation personnalisés, vous devez vous reconnecter chaque fois que le jeton d'accès expire. Pour en savoir plus, consultez Actualiser un jeton d'accès.

Produits compatibles

Les produits Google Workspace suivants sont compatibles avec les serveurs MCP Google Workspace et proposent les outils suivants :

Remarque importante concernant la sécurité : injection de prompt indirecte

Lorsque vous exposez un modèle de langage à des données non fiables, il existe un risque d'attaque par injection de prompt indirecte. Comme les clients MCP tels que Google Antigravity ont accès à des outils et des API puissants via les serveurs MCP Google Workspace, ils peuvent lire, modifier et supprimer des données de votre compte Google.

Pour limiter ces risques, suivez ces bonnes pratiques :

N'utilisez que des outils de confiance. Ne connectez jamais de serveurs MCP Google Workspace à des applications non fiables ou non validées.
Faites attention aux entrées non fiables. Évitez de demander à votre client MCP de traiter des e-mails, des documents ou d'autres ressources provenant de sources non validées. Ces entrées peuvent contenir des instructions cachées qui peuvent détourner votre session, permettant à un pirate informatique de modifier, voler ou supprimer vos données.
Examinez toutes les actions. Examinez toujours attentivement les actions effectuées par votre client IA en votre nom pour vous assurer qu'elles sont correctes et correspondent à vos intentions.

Configurer les serveurs MCP Google Workspace Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Prérequis

Configurer les serveurs MCP Google Workspace

Activer les API

CLI

Console

Activer les services MCP

CLI

Console

Configurer l'application Chat

Configurer l'écran de consentement OAuth

Configurer votre client MCP

Antigravity

Claude

Autres

Tester les serveurs MCP Google Workspace

Dépannage

Produits compatibles

Remarque importante concernant la sécurité : injection de prompt indirecte

Articles associés

Configurer les serveurs MCP Google Workspace