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 Universal Search para Google Workspace usa el estándar del Protocolo de contexto del modelo (MCP) para permitir que los agentes de IA busquen 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 Universal Search 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 específicas de cada producto.

Requisitos previos

Membresía en el Programa de versión preliminar para desarrolladores de Google Workspace
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 gcloud CLI en uno de los siguientes entornos de desarrollo:
Cloud Shell
Para usar una terminal en línea con gcloud CLI 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 gcloud CLI, 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 gcloud CLI con tu identidad federada.
3. Inicializa gcloud CLI.

Configura el servidor de MCP de Universal Search

Para usar el servidor de MCP de Universal Search, 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 Universal Search, habilita la API de MCP de Google Workspace en tu proyecto de Google Cloud:

CLI

gcloud services enable 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 Universal Search usa OAuth 2.0 para la autenticación y la 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 permisos necesarios para el servidor de MCP de la búsqueda universal.

Cuando te autenticas con el servidor de MCP de Universal Search, puedes elegir autenticar todos los permisos solicitados o solo un subconjunto de ellos. El servidor respeta estas elecciones y solo busca en los productos para los que se otorgó acceso.

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

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 Universal Search 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 devuelve resultados de Google Drive, el Calendario de Google y Google Chat. No busca en tu correo electrónico ni devuelve resultados de Gmail.

En la consola de Google Cloud, ve a Google Auth Platform > Acceso a los datos.
Haz clic en Agregar o quitar permisos.
Agrega uno o más de los siguientes permisos:
- 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 Universal Search a tu cliente de MCP, sigue las instrucciones para tu cliente.

Antigravity

Para agregar el servidor de MCP de Universal Search a Antigravity, agrega la configuración del servidor a tu archivo mcp_config.json. Estas instrucciones son compatibles con Antigravity 2.0, el IDE de Antigravity y la CLI de Antigravity.

Crea un ID de cliente de OAuth 2.0 y un secreto del tipo Aplicación web. En la sección URIs de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, agrega https://antigravity.google/oauth-callback en el campo URIs. Selecciona Usar este cliente para un agente potenciado por IA. Para obtener instrucciones, 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 de 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 del cliente que creaste.

Ahorra 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 del 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. Abre el panel de administración interactivo de MCP ejecutando el siguiente comando:
```
/mcp
```
  3. Usa las teclas de flecha para seleccionar workspace-universal, muévete 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 de forma correcta:
- Para el IDE de Antigravity o la GUI: Se muestra un botón Salir junto a workspace-universal en Personalizaciones > Servidores de MCP instalados.
- Para la CLI de Antigravity: Abre el panel /mcp para ver los servidores de MCP configurados. Los servidores verificados y autenticados muestran Authed junto a sus nombres dentro del panel interactivo de la TUI. Puedes seleccionar el servidor workspace-universal en la vista del panel para inspeccionar su estado y ver una lista de todas sus herramientas disponibles.

Claude

Para agregar el servidor de MCP de Universal Search a Claude, configura un conector personalizado.

Crea un ID de cliente de OAuth 2.0 y un secreto del tipo Aplicación web, y selecciona Usa este cliente para un agente potenciado por IA. Para obtener instrucciones, 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 del cliente de OAuth: Ingresa tus credenciales.
- Permisos: 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:

"Busca 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 pertinentes de varios productos, tu servidor de MCP de Universal Search está configurado de forma correcta.

Herramientas compatibles

El servidor de MCP de la 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.