Configurer le serveur MCP Docs

Google Docs propose un serveur MCP (Model Context Protocol) 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 telles que Google Antigravity et Claude d'effectuer des actions dans Google Docs.

Le serveur MCP Google Docs fournit un moyen standardisé pour les agents IA de :

  • Lire des données : lire des informations structurelles et du contenu textuel dans un document.
  • Passez à l'action : mettre à jour le style et la structure d'un document à l'aide de mises à jour groupées.
  • Respecter la sécurité : hériter des mêmes autorisations et des mêmes contrôles de gouvernance des données que l'utilisateur.

Prérequis

  • Un projet Google Cloud. Pour créer un projet, consultez la section Créer un projet.

  • Un client MCP, comme Google Antigravity.

  • Pour exécuter les commandes sur cette page, configurez gcloud CLI dans l'un des environnements de développement suivants :

    Cloud Shell

    Pour utiliser un terminal en ligne avec gcloud CLI déjà configuré, activez Cloud Shell :

    Activer Cloud Shell

    Shell local

    Pour utiliser un environnement de développement local, procédez comme suit :

    1. Installez la Google Cloud CLI. Si vous avez déjà installé la gcloud CLI, assurez-vous de disposer de la dernière version en exécutant la commande 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 la page Se connecter à la gcloud CLI avec une identité fédérée.
    3. Initialisez gcloud CLI.

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 MCP Google Docs

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é le 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 Nom de l'application, saisissez Docs MCP Server.
    2. Dans 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, consultez 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 test :
      1. Cliquez sur Audience.
      2. Sous Utilisateurs test, cliquez sur Ajouter des utilisateurs.
      3. Saisissez votre adresse e-mail et celles des autres utilisateurs test autorisés, 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 niveaux d'accès pour chaque API que vous avez activée dans votre projet Google Cloud.

    1. Sous Ajouter manuellement des niveaux d'accès, collez les niveaux d'accès pour le serveur MCP Google Docs :

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/documents.readonly

    2. Cliquez sur Ajouter à la table.

    3. Cliquez sur Mettre à jour.

    4. Après avoir sélectionné les niveaux d'accès requis par votre application, cliquez sur Enregistrer sur la page Accès aux données.

Configurer votre client MCP

Pour ajouter le serveur MCP distant Google Docs à votre client MCP, suivez les instructions de votre client.

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, Antigravity IDE et Antigravity CLI.

  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. 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/antigravity/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. Enregistrez mcp_config.json.

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

    • Pour Antigravity IDE ou l'interface graphique (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 à Customizations (Personnalisations).
      3. Sous Installed MCP Servers (Serveurs MCP installés), cliquez sur Refresh (Actualiser).
      4. Recherchez docs dans la liste, cliquez sur Authenticate (Authentifier), connectez-vous à votre compte Google, copiez le code d'autorisation, collez-le dans la boîte de dialogue d'entrée, puis cliquez sur Submit (Envoyer).

    • Pour Antigravity CLI :

      1. Démarrez Antigravity CLI :

        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 Authenticate (Authentifier), puis appuyez sur Entrée. Effectuez 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 en cours d'exécution :

    • Pour Antigravity IDE ou l'interface graphique : un bouton Sign out (Se déconnecter) s'affiche à côté du serveur sous Customizations (Personnalisations) > Installed MCP Servers (Serveurs MCP installés).
    • Pour Antigravity CLI : ouvrez le panneau /mcp pour afficher les serveurs MCP configurés. Les serveurs validés et authentifiés affichent Authed (Authentifié) à 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 afficher la liste de 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 d'un 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 URI champ.

    5. 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) (ou Admin settings (Paramètres d'administration)) > Connectors (Connecteurs).
    2. Cliquez sur Add custom connector (Ajouter un connecteur personnalisé).
    3. Saisissez les informations de connexion pour le produit Google Docs :
      • Server name (Nom du serveur) : Google Docs.
      • Remote MCP server URL (URL du serveur MCP distant) https://docsmcp.googleapis.com/mcp/v1
    4. Dans Advanced settings (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 peuvent 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 les informations suivantes :

  • Server name (Nom du serveur) : docs

  • Server URL (URL du serveur) : https://docsmcp.googleapis.com/mcp/v1

  • Transport: HTTP

  • Authentication (Authentification) : le serveur MCP distant Google Docs utilise OAuth 2.0. Pour en savoir plus, consultez la section En savoir plus sur l'authentification et l'autorisation.

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

Tester le serveur MCP Google Docs

Une fois que vous avez configuré le client MCP, vous pouvez vérifier la connexion en exécutant quelques requêtes de test.

Essayez de poser les questions suivantes à votre client MCP :

  • "Affiche-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 exécute 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

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

Documentation de référence sur l'outil

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

  • read_doc
  • update_doc

Considération importante concernant la sécurité : injection indirecte de requêtes

Lorsque vous exposez un modèle de langage à des données non fiables, il existe un risque d'attaque par injection indirecte de requêtes . Étant donné que les clients 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 dans votre compte Google.

Pour limiter ces risques, suivez ces bonnes pratiques :

  • N'utilisez que des outils fiables. Ne connectez jamais le serveur MCP Google Docs à des applications non fiables ou non validées.
  • Soyez prudent avec les 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, de voler ou de supprimer vos données.
  • Vérifiez toutes les actions. Vérifiez toujours attentivement les actions effectuées par votre client IA en votre nom pour vous assurer qu'elles sont correctes et qu'elles correspondent à vos intentions.