Google utiliza tecnología de IA para traducir contenido a tu idioma preferido. Las traducciones realizadas con IA pueden contener errores.

Permite que los agentes de IA realicen búsquedas en Workspace con el servidor de MCP de Búsqueda universal para Workspace

El servidor de MCP de búsqueda universal para Google Workspace usa el estándar del Protocolo de contexto del modelo (MCP) para permitir que los agentes de IA busquen en tus artefactos de Workspace. Este servidor ofrece una forma de buscar en varios productos de Google Workspace, incluidos mensajes de Gmail, archivos de Google Drive, eventos de Calendario de Google y espacios y mensajes de Google Chat, con una sola herramienta.

El servidor de MCP de búsqueda universal proporciona una forma estandarizada para que los agentes de IA busquen información en toda tu cuenta de Google Workspace sin necesidad de llamar a herramientas individuales específicas del producto.

Requisitos previos

Un proyecto de Google Cloud, para crear un proyecto, consulta Crea un proyecto.
Un cliente de MCP, como Google Antigravity.
Para ejecutar los comandos de esta página, configura la CLI de gcloud en uno de los siguientes entornos de desarrollo:
Cloud Shell
Para usar una terminal en línea con la CLI de gcloud ya configurada, activa Cloud Shell.

Activa Cloud Shell
Shell local
Para usar un entorno de desarrollo local, sigue estos pasos:
1. Instala Google Cloud CLI. Si ya instalaste la CLI de gcloud, ejecuta gcloud components update para asegurarte de tener la versión más reciente.
2. Si usas un proveedor de identidad (IdP) externo, accede a gcloud CLI con tu identidad federada. Para obtener más información, consulta Accede a la gcloud CLI con tu identidad federada.
3. Inicializa gcloud CLI.

Configura el servidor de MCP de búsqueda universal

Para usar el servidor de MCP de búsqueda universal, debes habilitarlo en tu proyecto de Google Cloud y, luego, configurar tu cliente de MCP para que se conecte a él.

Habilita las APIs

Para usar el servidor de MCP de búsqueda universal, habilita la API de Google Workspace MCP y las APIs de los productos en los que deseas buscar en tu proyecto de Google Cloud:

API de Gmail
API de Google Drive
API de Calendario de Google
API de Google Chat
API de 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

Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud.

Console

Habilita las API en la consola de Google Cloud:

Habilitar las API

El servidor de MCP de búsqueda universal usa OAuth 2.0 para la autenticación y autorización. Debes configurar la pantalla de consentimiento de OAuth antes de poder crear un ID de cliente de OAuth.

Si ya configuraste la pantalla de consentimiento de OAuth para otros servidores de MCP, asegúrate de haber agregado los alcances necesarios para el servidor de MCP de búsqueda universal.

Cuando te autenticas con el servidor de MCP de búsqueda universal, puedes elegir autenticar todos los alcances solicitados o solo un subconjunto de ellos. El servidor respeta estas opciones y solo busca en los productos para los que se otorgó acceso.

Por ejemplo, si te autenticas con todos los siguientes alcances:

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

El servidor de MCP de búsqueda universal buscará en Gmail, Google Drive, Calendario de Google y Google Chat.

Sin embargo, si solo otorgas acceso a https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly y https://www.googleapis.com/auth/chat.messages.readonly (y omites https://www.googleapis.com/auth/gmail.readonly), la búsqueda universal solo muestra resultados de Google Drive, Calendario de Google y Google Chat. No busca en tu correo electrónico ni muestra resultados de Gmail.

En la consola de Google Cloud, ve a Google Auth Platform > Data Access.
Haz clic en Agregar o quitar permisos.
Agrega uno o más de los siguientes alcances:
- 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
Haz clic en Actualizar y, luego, en Guardar.

Para obtener instrucciones detalladas sobre cómo configurar la pantalla de consentimiento, consulta Configura los servidores de MCP de Google Workspace.

Configura tu cliente de MCP

Para agregar el servidor de MCP de búsqueda universal a tu cliente de MCP, sigue las instrucciones de tu cliente.

Antigravity

Para agregar el servidor de MCP de búsqueda universal a Antigravity, agrega la configuración del servidor a tu archivo mcp_config.json. Estas instrucciones admiten Antigravity 2.0, IDE de Antigravity y la CLI de Antigravity.

Crea un ID de cliente y un secreto de OAuth 2.0 de tipo Aplicación web. En la URIs de redireccionamiento autorizados sección, haz clic en + Agregar URI y, luego, agrega https://antigravity.google/oauth-callback en el campo URIs. Para obtener instrucciones detalladas, consulta Configura los servidores de MCP de Google Workspace.
Abre o crea el archivo de configuración ~/.gemini/config/mcp_config.json.

Agrega la configuración workspace-universal a mcp_config.json:

{
  "mcpServers": {
    "workspace-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

Reemplaza lo siguiente:

OAUTH_CLIENT_ID: Es el ID de cliente que creaste.
OAUTH_CLIENT_SECRET: Es el secreto de cliente que creaste.

Guarda mcp_config.json.
Autentica el servidor de MCP. Puedes autenticarte con la configuración de la GUI o la CLI:
- Para el IDE o la GUI de Antigravity (Antigravity 2.0):
  1. Abre la pantalla de configuración (p.ej., haz clic en Configuración en la parte inferior izquierda o abre Configuración de usuario de Antigravity).
  2. Navega a Personalizaciones.
  3. En Servidores de MCP instalados, haz clic en Actualizar.
  4. Busca workspace-universal en la lista, haz clic en Autenticar, accede a tu Cuenta de Google, copia el código de autorización, pégalo en el diálogo de entrada y haz clic en Enviar.
- Para la CLI de Antigravity:
  1. Inicia la CLI de Antigravity:
```
agy
```
  2. Para abrir el panel interactivo de administración de MCP, ejecuta lo siguiente:
```
/mcp
```
  3. Usa las teclas de flecha para seleccionar workspace-universal, ve a la acción Autenticar y presiona Intro. Completa el flujo de acceso en tu navegador, copia el código de autorización, pégalo en el mensaje de la terminal y presiona Intro.
Verifica que el servidor esté configurado y en ejecución correctamente:
- Para el IDE de Antigravity o la GUI: Se muestra un botón de Salir junto a workspace-universal en Personalizaciones > Servidores de MCP instalados.
- Para la CLI de Antigravity: Abre el panel /mcp para ver tus servidores de MCP configurados. Los servidores verificados y autenticados muestran Autenticado junto a sus nombres dentro del panel interactivo de TUI. Puedes seleccionar el servidor workspace-universal en la vista del panel para inspeccionar su estado y enumerar todas las herramientas disponibles.

Claude

Para agregar el servidor de MCP de búsqueda universal a Claude, configura un conector personalizado.

Crea un ID de cliente y un secreto de OAuth 2.0 de tipo Aplicación web. Para obtener instrucciones detalladas, consulta Configura los servidores de MCP de Google Workspace.
En la configuración de Claude, agrega un conector personalizado:
- Nombre del servidor: Universal Search MCP Server
- URL del servidor de MCP remoto: https://workspacemcp.googleapis.com/mcp/v1
- ID de cliente de OAuth y secreto de cliente de OAuth: Ingresa tus credenciales.
- Alcances: Incluye https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly y https://www.googleapis.com/auth/chat.messages.readonly.

Prueba el servidor de MCP de búsqueda universal

Intenta hacerle preguntas a tu cliente de MCP que requieran buscar en diferentes productos:

"Encuentra todo lo relacionado con el Proyecto X en mi correo electrónico, documentos y mensajes de chat"
"¿Cuándo es mi próxima reunión sobre el plan de marketing y cuáles son las notas y los mensajes de chat más recientes al respecto?"

Si las herramientas se ejecutan correctamente y recibes respuestas relevantes de varios productos, tu servidor de MCP de búsqueda universal está configurado correctamente.

Herramientas compatibles

El servidor de MCP de búsqueda universal ofrece la siguiente herramienta:

search_corpus: Realiza una búsqueda en varios productos de Google Workspace (Google Drive, Gmail, Calendario de Google y Google Chat) según la consulta proporcionada.