Permettre aux agents IA d'effectuer des recherches dans Workspace avec le serveur MCP de recherche universelle pour Workspace

Preview développeur : disponible dans le cadre du programme Preview développeur Google Workspace, qui permet d'accéder en avant-première à certaines fonctionnalités.

Le serveur MCP Universal Search pour Google Workspace utilise la norme Model Context Protocol (MCP) pour permettre aux agents d'IA de rechercher vos artefacts Workspace. Ce serveur permet de rechercher des informations dans plusieurs produits Google Workspace, y compris les messages Gmail, les fichiers Google Drive, les événements Google Agenda, ainsi que les espaces et messages Google Chat, à l'aide d'un seul outil.

Le serveur MCP Recherche universelle permet aux agents IA de rechercher des informations dans l'ensemble de votre compte Google Workspace de manière standardisée, sans avoir à appeler des outils spécifiques à chaque produit.

Prérequis

• 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 sur cette page, configurez gcloud CLI dans l'un des environnements de développement suivants :

  Cloud Shell

  Pour utiliser un terminal en ligne avec la gcloud CLI déjà configurée, 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 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.

Configurer le serveur MCP de la recherche universelle

Pour utiliser le serveur MCP Universal Search, 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 Universal Search, activez l'API Google Workspace MCP et les API des produits dans lesquels vous souhaitez effectuer des recherches dans votre projet Google Cloud :

• API Gmail
• API Google Drive
• API Google Agenda
• API Google Chat

• API Google Workspace MCP

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
workspacemcp.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

Configurer l'écran de consentement OAuth

Le serveur MCP de la recherche universelle 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.

Si vous avez déjà configuré l'écran de consentement OAuth pour d'autres serveurs MCP, assurez-vous d'avoir ajouté les niveaux d'accès requis pour le serveur MCP Recherche universelle.

Lorsque vous vous authentifiez auprès du serveur MCP Recherche universelle, vous pouvez choisir d'authentifier tous les niveaux d'accès demandés ou seulement un sous-ensemble d'entre eux. Le serveur respecte ces choix et n'effectue de recherches que dans les produits pour lesquels l'accès a été accordé.

Par exemple, si vous vous authentifiez avec tous les niveaux d'accès suivants :

• https://www.googleapis.com/auth/gmail.readonly
• https://www.googleapis.com/auth/drive.readonly
• https://www.googleapis.com/auth/calendar.readonly
• https://www.googleapis.com/auth/chat.messages.readonly

Le serveur MCP Recherche universelle effectue des recherches dans Gmail, Google Drive, Google Agenda et Google Chat.

Toutefois, si vous n'accordez l'accès qu'à https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly, et https://www.googleapis.com/auth/chat.messages.readonly (et que vous omettez https://www.googleapis.com/auth/gmail.readonly), la recherche universelle ne renvoie que les résultats de Google Drive, Google Agenda et Google Chat. Elle ne recherche pas dans vos e-mails et ne renvoie pas de résultats Gmail.

1. Dans la console Google Cloud, accédez à Google Auth Platform > Accès aux données.
2. Cliquez sur Ajouter ou supprimer des niveaux d'accès.

3. Ajoutez un ou plusieurs des champs d'application suivants :

   • https://www.googleapis.com/auth/gmail.readonly
   • https://www.googleapis.com/auth/drive.readonly
   • https://www.googleapis.com/auth/calendar.readonly
   • https://www.googleapis.com/auth/chat.messages.readonly

4. Cliquez sur Mettre à jour, puis sur Enregistrer.

Pour obtenir des instructions détaillées sur la configuration de l'écran de consentement, consultez Configurer les serveurs MCP Google Workspace.

Configurer votre client MCP

Pour ajouter le serveur MCP Recherche universelle à votre client MCP, suivez les instructions correspondant à votre client.

Antigravity

Pour ajouter le serveur MCP Recherche universelle à 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 de type Application Web. Dans la section URI de redirection autorisés, cliquez sur + Ajouter un URI, puis ajoutez https://antigravity.google/oauth-callback dans le champ URI. Pour obtenir des instructions, consultez Configurer les serveurs MCP Google Workspace.

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

3. Ajoutez la configuration workspace-universal à mcp_config.json :

   {
     "mcpServers": {
       "workspace-universal": {
         "serverUrl": "https://workspacemcp.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'interface utilisateur graphique ou de la CLI :

   • Pour l'IDE ou l'interface utilisateur graphique Antigravity (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 workspace-universal dans la liste, cliquez sur Authentifier, connectez-vous à votre compte Google, copiez le code d'autorisation, collez-le dans la boîte de dialogue, 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 workspace-universal, 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.

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

   • Pour l'IDE ou l'interface utilisateur graphique Antigravity : un bouton Se déconnecter s'affiche à côté de workspace-universal 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 (Authentifié) à côté de leur nom dans le panneau TUI interactif. Vous pouvez sélectionner le serveur workspace-universal dans la vue du tableau de bord pour inspecter son état et lister tous les outils disponibles.

Claude

Pour ajouter le serveur MCP Recherche universelle à Claude, configurez un connecteur personnalisé.

1. Créez un ID client et un code secret OAuth 2.0 de type Application Web. Pour obtenir des instructions, consultez Configurer les serveurs MCP Google Workspace.

2. Dans les paramètres de Claude, ajoutez un connecteur personnalisé :

   • Nom du serveur : Universal Search MCP Server
   • URL du serveur MCP distant : https://workspacemcp.googleapis.com/mcp/v1
   • ID client OAuth et code secret du client OAuth : saisissez vos identifiants.
   • Champs d'application : incluez https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly et https://www.googleapis.com/auth/chat.messages.readonly.

Tester le serveur MCP de la recherche universelle

Posez à votre client MCP des questions qui nécessitent une recherche dans différents produits :

• "Trouve tout ce qui concerne le projet X dans mes e-mails, mes documents et mes messages de chat."
• "Quand a lieu ma prochaine réunion sur le plan marketing ? Quelles sont les dernières notes et les derniers messages de chat à ce sujet ?"

Si les outils s'exécutent correctement et que vous recevez des réponses pertinentes de plusieurs produits, votre serveur MCP Universal Search est correctement configuré.

Outils compatibles

Le serveur MCP de recherche universelle propose l'outil suivant :

• search_corpus : effectue une recherche dans plusieurs produits Google Workspace (Google Drive, Gmail, Google Agenda et Google Chat) en fonction de la requête fournie.