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 la 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 proporciona una forma de buscar en varios productos de Google Workspace, incluidos los mensajes de Gmail, los archivos de Google Drive, los eventos de Calendario de Google y los 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 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 la 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 la 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 Universal Search, habilita la API de MCP de Google Workspace y las APIs de los productos en los que deseas realizar búsquedas en tu proyecto de Google Cloud:

  • API de Gmail
  • API de Google Drive
  • API de Google Calendar
  • API de Google Chat

  • API de MCP de 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

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 la 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 la Búsqueda universal.

Cuando te autenticas con el servidor de MCP de Universal Search, puedes optar por autenticar todos los permisos solicitados o solo un subconjunto de ellos. El servidor respeta estas elecciones y solo busca en los productos a 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 MCP de Búsqueda universal realizará búsquedas 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 devolverá resultados de Google Drive, Calendario de Google y Google Chat. No busca en tu correo electrónico ni muestra resultados de Gmail.

  1. En la consola de Google Cloud, ve a Google Auth Platform > Acceso a los datos.
  2. Haz clic en Agregar o quitar permisos.

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

  4. Haz clic en Actualizar y, luego, en Guardar.

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

Configura tu cliente de MCP

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

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 son compatibles con Antigravity 2.0, Antigravity IDE y Antigravity CLI.

  1. Crea un ID y un secreto de cliente de OAuth 2.0 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. Para obtener instrucciones, consulta Cómo configurar los servidores MCP de Google Workspace.

  2. Abre o crea el archivo de configuración ~/.gemini/antigravity/mcp_config.json.

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

  4. Ahorra mcp_config.json.

  5. 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 esquina inferior izquierda o abre Configuración del usuario de Antigravity).
      2. Navega a Personalizaciones.
      3. En Installed MCP Servers, haz clic en Refresh.
      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 el siguiente comando:

        /mcp

      3. Usa las teclas de flecha para seleccionar workspace-universal, ve a la acción Authenticate 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.

  6. Verifica que el servidor esté configurado y en ejecución correctamente:

    • Para el IDE o la GUI de Antigravity: Se muestra un botón Sign out junto a workspace-universal en Customizations > Installed MCP Servers.
    • 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 enumerar todas las herramientas disponibles.

Claude

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

  1. Crea un ID y un secreto de cliente de OAuth 2.0 del tipo Aplicación web. Para obtener instrucciones, consulta Cómo configurar los servidores MCP de Google Workspace.

  2. 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 la Búsqueda universal

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

  • “Busca todo lo relacionado con el proyecto X en mis correos electrónicos, 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 sobre el tema?"

Si las herramientas se ejecutan correctamente y recibes respuestas pertinentes de varios productos, significa que tu servidor de MCP de la Búsqueda universal está configurado correctamente.

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 búsqueda proporcionada.