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

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

Le serveur MCP de recherche universelle offre aux agents IA un moyen standardisé de rechercher des informations dans l'ensemble de votre compte Google Workspace 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 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 de recherche universelle

Pour utiliser le serveur MCP de recherche universelle, 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 de recherche universelle, activez l'API MCP Google Workspace 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 MCP Google Workspace

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

Le serveur MCP de 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 champs d'application requis pour le serveur MCP de recherche universelle.

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

Par exemple, si vous vous authentifiez avec tous les 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

Le serveur MCP de recherche universelle effectuera 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 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 n'effectue pas de recherche dans vos e-mails ni ne renvoie 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 de recherche universelle à votre client MCP, suivez les instructions de votre client.

Antigravity

Pour ajouter le serveur MCP de 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/config/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. 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 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 d'entrée, puis cliquez sur 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 workspace-universal, accédez à l'action Authentifier, puis appuyez sur Entrée. Effectuez le processus 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 Se déconnecter s'affiche à côté de workspace-universal sous Personnalisations > Serveurs MCP installés.
    • Pour Antigravity CLI : ouvrez le panneau /mcp pour afficher vos 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 le serveur workspace-universal dans la vue du tableau de bord pour inspecter son état et afficher la liste de tous les outils disponibles.

Claude

Pour ajouter le serveur MCP de 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 recherche universelle

Essayez de poser à 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 aura lieu ma prochaine réunion sur le plan marketing, et 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 de recherche universelle 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.