Configurer le serveur MCP Docs

Google Docs propose un serveur Model Context Protocol (MCP) distant qui permet aux agents IA d'interagir de manière sécurisée avec les données Google Docs. En configurant le serveur MCP Google Docs, vous permettez aux applications d'IA comme Google Antigravity et Claude d'effectuer des actions dans Google Docs.

Le serveur MCP Google Docs permet aux agents IA d'effectuer les actions suivantes de manière standardisée :

  • Lire les données : lire les informations structurelles et le contenu textuel du document.
  • Passer à l'action : modifiez le style et la structure du document à l'aide de mises à jour groupées.
  • Respect de la sécurité : hérite des mêmes autorisations et contrôles de gouvernance des données que l'utilisateur.

Prérequis

Configurer le serveur MCP Google Docs

Pour utiliser le serveur MCP Google Docs, vous devez l'activer dans votre projet Google Cloud, puis configurer votre client MCP pour qu'il s'y connecte.

Activer les API

Pour utiliser le serveur MCP Google Docs, vous devez activer l'API suivante dans votre projet Google Cloud :

  • API Google Docs

CLI

gcloud services enable docs.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 Google Docs, vous devez activer le service suivant dans votre projet Google Cloud :

  • API Google Docs MCP

CLI

gcloud services enable docsmcp.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

Le serveur MCP Google Docs utilise 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.

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

    Accéder à la page "Branding"

  2. 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 Docs MCP Server.
    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 et, 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 de tout autre utilisateur test autorisé, puis cliquez sur Enregistrer.

  3. Cliquez sur Accès aux données > Ajouter ou supprimer des niveaux d'accès. 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 du serveur MCP 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

    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 Docs à votre client MCP, suivez les instructions de votre client.

Les ID client OAuth 2.0 délégués par l'utilisateur qui appellent le serveur MCP Docs doivent avoir l'option Utiliser ce client pour un agent optimisé par l'IA sélectionnée dans Google Auth Platform > Clients. Pour mettre à jour un ID client OAuth 2.0 existant, sélectionnez ce paramètre dans Google Auth Platform > Clients, comme décrit dans Gérer les clients OAuth. Si vous ne pouvez pas modifier ce paramètre sur un client existant, ou si le client est également compatible avec des fonctionnalités autres que l'agent, créez un ID client OAuth 2.0 pour votre agent IA. Pour les requêtes refusées, les comptes de service avec délégation au niveau du domaine ou Google Apps Script, consultez Dépannage.

Antigravity

Pour ajouter le serveur MCP distant Google Docs à 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.

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

  2. Ouvrez ou créez le fichier de configuration ~/.gemini/config/mcp_config.json.

  3. Ajoutez la configuration mcpServers à mcp_config.json :

    {
  "mcpServers": {
    "docs": {
      "serverUrl": "https://docsmcp.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éé.

  4. Économisez mcp_config.json.

  5. Authentifiez le serveur MCP. Vous pouvez vous authentifier à l'aide des paramètres de l'IUG ou de la CLI :

    • Pour l'IDE Antigravity ou l'IUG (Antigravity 2.0) :

      1. Ouvrez l'écran des paramètres (par exemple, cliquez sur Paramètres en bas à gauche ou ouvrez Paramètres utilisateur Antigravity).
      2. Accédez à Personnalisations.
      3. Sous Serveurs MCP installés, cliquez sur Actualiser.
      4. Recherchez docs dans la liste, cliquez sur 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. Utilisez les touches fléchées pour sélectionner docs, accédez à l'action S'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.

  6. Vérifiez que le serveur est correctement configuré et qu'il est en cours d'exécution :

    • Pour l'IDE Antigravity ou l'IUG : un bouton Se déconnecter s'affiche à côté du 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.

Le serveur MCP distant est prêt à être utilisé dans Antigravity.

Claude

Pour utiliser le serveur MCP distant Google Docs avec Claude.ai ou Claude Desktop, vous devez disposer du forfait Claude Enterprise, Pro, Max ou Team.

Pour ajouter le serveur MCP distant Google Docs à Claude, configurez un connecteur personnalisé avec un ID client et un code secret OAuth.

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

  2. Configurez le serveur MCP dans Claude :

    1. Dans Claude.ai ou Claude Desktop, accédez à Settings (Paramètres) > Connectors (Connecteurs) 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 Docs :
      • Nom du serveur : Google Docs.
      • URL du serveur MCP distant : https://docsmcp.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.

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 le serveur MCP distant Google Docs, saisissez ce qui suit :

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

Tester le serveur MCP Google Docs

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 :

  • "Montre-moi le contenu structurel du document Google Docs abcd123."

    Le client récupère la structure et le contenu du document à l'aide de docs.read_doc.

  • "Insère le titre 'Mon plan marketing' dans le document Google Docs abcd123."

    Le client effectue une requête docs.update_doc pour mettre à jour les éléments structurels et insérer du texte.

Si les outils s'exécutent correctement et que vous recevez des réponses pertinentes, votre serveur MCP Google Docs est correctement configuré.

Dépannage

Utilisez les sections suivantes pour résoudre les problèmes courants d'authentification et de connexion avec le serveur MCP Docs.

Vérifier les événements de journaux OAuth

Si vous rencontrez des problèmes de connexion au serveur MCP, recherchez les erreurs dans les journaux OAuth. Demandez à votre administrateur Google Workspace d'examiner les événements de journaux OAuth dans l'outil d'investigation de sécurité.

Requêtes refusées provenant de clients OAuth délégués par l'utilisateur

Si vos requêtes adressées au serveur MCP sont refusées, vérifiez que l'ID client OAuth 2.0 délégué par l'utilisateur pour votre flux OAuth en trois étapes est sélectionné pour Utiliser ce client pour un agent optimisé par l'IA dans Google Auth Platform > Clients :

  • Le client existant est compatible avec le paramètre : sélectionnez Utiliser ce client pour un agent basé sur l'IA sur votre client OAuth existant.
  • Impossible de mettre à jour le client existant : créez un client OAuth en sélectionnant Utiliser ce client pour un agent optimisé par l'IA, puis mettez à jour votre application pour l'utiliser.
  • Le client existant est également compatible avec les fonctionnalités non liées aux agents : créez un client OAuth distinct pour l'agent IA et conservez le client existant pour vos fonctionnalités non liées aux agents.

Pour obtenir des instructions, consultez Configurer votre client MCP et Gérer les clients OAuth.

Comptes de service avec délégation au niveau du domaine

Si votre application utilise un compte de service avec délégation au niveau du domaine pour OAuth à deux étapes, 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 :

  • Contrôle des accès : les requêtes adressées au serveur MCP à partir de ces comptes de service ne sont pas refusées si le paramètre d'agent est manquant. L'accès est plutôt régi par les paramètres de délégation au niveau du domaine que votre administrateur Google Workspace gère. Pour en savoir plus sur les paramètres d'administrateur, consultez Contrôler l'accès à l'API à l'aide de la délégation au niveau du domaine.
  • Actions sensibles : les serveurs MCP Google Workspace continuent de renvoyer des requêtes d'élicitation de formulaire pour la confirmation human-in-the-loop (avec intervention humaine) des appels d'outils sensibles effectués via l'emprunt d'identité de l'utilisateur par délégation au niveau du domaine.

Requêtes provenant d'Apps Script

Si vous appelez le serveur MCP depuis Apps Script, vous ne pouvez pas sélectionner Utiliser ce client pour un agent optimisé par l'IA sur le client OAuth par défaut qu'Apps Script crée et gère pour votre script. Cela s'applique même si votre script utilise un projet Google Cloud standard.

Pour appeler le serveur MCP depuis Apps Script, procédez comme suit :

  1. 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.
  2. Dans votre script, utilisez la bibliothèque OAuth2 pour Apps Script afin d'autoriser les utilisateurs avec ce client OAuth.
  3. Lorsque vous appelez le serveur 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 de serveurs MCP Google Workspace ne sont pas concernés.

Invites de connexion répétées toutes les heures

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, aucun jeton n'est renvoyé.

Vérifiez si votre client MCP accepte les paramètres d'autorisation personnalisés :

  • Le client 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.
  • Le client n'est pas compatible avec les paramètres d'autorisation personnalisés : connectez-vous à nouveau chaque fois que le jeton d'accès expire.

Pour en savoir plus, consultez Actualiser un jeton d'accès.

Référence de l'outil

Les outils suivants sont disponibles pour le serveur MCP Google Docs :

  • read_doc
  • update_doc

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 hôtes MCP tels que Google Antigravity ont accès à des outils et des API puissants via le serveur MCP Google Docs, ils peuvent lire, modifier et supprimer des données de votre compte Google.

Pour limiter ces risques, vous devez analyser les prompts et les réponses afin de détecter les contenus malveillants ou les attaques par injection de prompt. Vous pouvez utiliser Model Armor fourni par Google ou votre propre solution si vous la documentez afin que les utilisateurs acceptent ce risque. Pour en savoir plus, consultez Configurer la sécurité des serveurs MCP Google Workspace.

Appliquez les bonnes pratiques suivantes :

  • N'utilisez que des outils de confiance. Ne connectez jamais le serveur MCP Google Docs à des applications non fiables ou non validées.
  • Méfiez-vous des entrées non fiables. Évitez de demander à votre client MCP de traiter 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.