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.

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 Universal Search fournit 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

Ê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 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 que vous disposez de la dernière version en exécutant gcloud components update.
2. Si vous utilisez un fournisseur d'identité externe (IdP), 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 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 de recherche universelle, activez l'API MCP Google Workspace dans votre projet Google Cloud :

CLI

gcloud services enable 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 Universal Search 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 Universal Search, 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 ne recherche que 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 ne recherche pas vos e-mails et ne renvoie pas de résultats Gmail.

Dans la console Google Cloud, accédez à Google Auth Platform > Accès aux données.
Cliquez sur Ajouter ou supprimer des niveaux d'accès.
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
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 Universal Search à votre client MCP, suivez les instructions correspondant à votre client.

Antigravity

Pour ajouter le serveur MCP Universal Search à 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 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. Sélectionnez Utiliser ce client pour un agent basé sur l'IA. Pour en savoir plus, consultez Configurer les serveurs MCP Google Workspace.
Ouvrez ou créez le fichier de configuration ~/.gemini/config/mcp_config.json.

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

Économisez mcp_config.json.
Authentifiez le serveur 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. Recherchez workspace-universal 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 de saisie, puis cliquez sur Submit (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 Authenticate (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.
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é 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 sous la vue du tableau de bord pour inspecter son état et lister tous ses outils disponibles.

Claude

Pour ajouter le serveur MCP Universal Search à Claude, configurez un connecteur personnalisé.

Créez un ID client et un secret OAuth 2.0 de type Application Web, puis sélectionnez Utiliser ce client pour un agent optimisé par l'IA. Pour en savoir plus, consultez Configurer les serveurs MCP Google Workspace.
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 d'effectuer des recherches 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, et quels sont les derniers messages de chat et notes à 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.

Permettre aux agents IA d'effectuer des recherches dans Workspace avec le serveur MCP de recherche universelle pour Workspace Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Prérequis

Cloud Shell

Shell local

Configurer le serveur MCP de recherche universelle

Activer les API

CLI

Console

Configurer l'écran de consentement OAuth

Configurer votre client MCP

Antigravity

Claude

Tester le serveur MCP de recherche universelle

Outils compatibles

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