Configura el servidor de MCP de Documentos de Google

Documentos ofrece un servidor remoto del Protocolo de contexto del modelo (MCP) que permite que los agentes de IA interactúen de forma segura con los datos de Documentos. Si configuras el servidor de MCP de Documentos, habilitas las aplicaciones de IA, como Google Antigravity y Claude, para que realicen acciones en Documentos.

El servidor de MCP de Documentos proporciona una forma estandarizada para que los agentes de IA hagan lo siguiente:

  • Leer datos: Lee la información estructural y el contenido de texto del documento.
  • Toma medidas: Actualiza el diseño y la estructura de los documentos con actualizaciones por lotes.
  • Respetar la seguridad: Hereda los mismos permisos y controles de administración de datos que el usuario.

Requisitos previos

Configura el servidor de MCP de Documentos

Para usar el servidor de MCP de Documentos, habilítalo en tu proyecto de Google Cloud y configura tu aplicación de IA para que se conecte a él.

Habilita las APIs

Para usar el servidor de MCP de Documentos, habilita la siguiente API en tu proyecto de Google Cloud:

  • API de Documentos de Google

CLI

gcloud services enable docs.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

Habilita los servicios de MCP

Para habilitar los componentes de MCP para Documentos, habilita el siguiente servicio en tu proyecto de Google Cloud:

  • API de MCP para Documentos

CLI

gcloud services enable docsmcp.googleapis.com --project=PROJECT_ID

Reemplaza PROJECT_ID por el ID del proyecto de Google Cloud.

Console

Habilita los servicios de MCP en la consola de Google Cloud:

Habilita los servicios de MCP

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

  1. En la consola de Google Cloud, ve a Google Auth Platform > Desarrollo de la marca.

    Ir a Información de la marca

  2. Si ya configuraste Google Auth Platform, puedes establecer los siguientes parámetros de configuración de la pantalla de consentimiento de OAuth en Desarrollo de la marca, Público y Acceso a los datos. Si ves un mensaje que indica que Google Auth Platform aún no se configuró, haz clic en Comenzar:

    1. En Información de la app, en Nombre de la app, escribe Docs MCP Server.
    2. En Correo electrónico de asistencia del usuario, selecciona tu dirección de correo electrónico o un Grupo de Google adecuado.
    3. Haz clic en Siguiente.
    4. En Público, selecciona Interno. Si no puedes seleccionar Interno, selecciona Externo.
    5. Haz clic en Siguiente.
    6. En Información de contacto, ingresa una dirección de correo electrónico en la que puedas recibir notificaciones sobre cualquier cambio en tu proyecto.
    7. Haz clic en Siguiente.
    8. En Finalizar, revisa la Política de Datos del Usuario de los Servicios de APIs de Google y, si estás de acuerdo, selecciona Acepto la Política de Datos del Usuario de los Servicios de APIs de Google.
    9. Haz clic en Continuar.
    10. Haz clic en Crear.
    11. Si seleccionaste Externo como tipo de usuario, agrega usuarios de prueba:
      1. Haz clic en Público.
      2. En Usuarios de prueba, haz clic en Agregar usuarios.
      3. Ingresa tu dirección de correo electrónico y los demás usuarios de prueba autorizados, y, luego, haz clic en Guardar.
  3. Haz clic en Acceso a los datos > Agregar o quitar permisos. Aparecerá un panel con una lista de permisos para cada API que hayas habilitado en tu proyecto de Google Cloud.

    1. En Agrega permisos manualmente, pega los permisos para el servidor de MCP de Documentos:

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/drive.file
      • https://www.googleapis.com/auth/documents.readonly
      • https://www.googleapis.com/auth/documents
    2. Haz clic en Agregar a la tabla.

    3. Haz clic en Actualizar.

    4. Después de seleccionar los permisos que requiere tu app, en la página Acceso a los datos, haz clic en Guardar.

Configura tu aplicación de IA

Para agregar el servidor de MCP remoto de Documentos a tu aplicación de IA, sigue las instrucciones de tu aplicación.

Los IDs de cliente de OAuth 2.0 delegados por el usuario que llaman al servidor de MCP de Documentos deben tener seleccionada la opción Usa este cliente para un agente potenciado por IA en Plataforma de autenticación de Google > Clientes. Para actualizar un ID de cliente de OAuth 2.0 existente, selecciona este parámetro de configuración en Google Auth Platform > Clientes, como se describe en Administra clientes de OAuth. Si no puedes cambiar este parámetro de configuración en un cliente existente o si el cliente también admite funciones que no son de agente, crea un ID de cliente de OAuth 2.0 nuevo para tu agente de IA. Para solicitudes rechazadas, cuentas de servicio con delegación de todo el dominio o Google Apps Script, consulta Solución de problemas.

Antigravity

Para agregar el servidor de MCP remoto de Documentos 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.

  1. Crea un ID de cliente y un secreto de OAuth 2.0:

    1. En la consola de Google Cloud, ve a Google Auth Platform > Clientes > Crear cliente.

      Ir a Crear cliente

    2. Selecciona Aplicación web como el tipo de aplicación.

    3. Ingrese un Nombre.

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

    5. Selecciona Usar este cliente para un agente potenciado por IA.

    6. Haz clic en Crear y copia tu ID de cliente y el secreto del cliente.

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

  3. Agrega la configuración de mcpServers a mcp_config.json:

    {
      "mcpServers": {
        "docs": {
          "serverUrl": "https://docsmcp.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 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 docs 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 de administración interactivo de MCP, ejecuta el siguiente comando:

        /mcp
        
      3. Usa las teclas de flecha para seleccionar docs, 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 la terminal y presiona Intro.

  6. 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 al servidor 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 cualquier servidor en la vista del panel para inspeccionar su estado y ver una lista de todas sus herramientas disponibles.

El servidor de MCP remoto está listo para usarse en Antigravity.

Claude

Para usar el servidor de MCP remoto de Documentos con Claude.ai o Claude Desktop, debes tener el plan Claude Enterprise, Pro, Max o Team.

Para agregar el servidor de MCP remoto de Documentos a Claude, configura un conector personalizado con un ID y un secreto de cliente de OAuth.

  1. Crea un ID de cliente y un secreto de OAuth 2.0:

    1. En la consola de Google Cloud, ve a Google Auth Platform > Clientes > Crear cliente.

      Ir a Crear cliente

    2. Selecciona Aplicación web como el tipo de aplicación.

    3. Ingrese un Nombre.

    4. En la sección URIs de redireccionamiento autorizados, haz clic en + Agregar URI y, luego, agrega https://claude.ai/api/mcp/auth_callback en el campo URIs.

    5. Selecciona Usar este cliente para un agente potenciado por IA.

    6. Haz clic en Crear y copia tu ID de cliente y el secreto del cliente.

  2. Configura el servidor de MCP en Claude:

    1. En Claude.ai o Claude Desktop, ve a Configuración > Conectores o Configuración de administrador > Conectores.
    2. Haz clic en Agregar conector personalizado.
    3. Ingresa los detalles de la conexión para el producto de Documentos:
      • Nombre del servidor: Docs.
      • URL del servidor de MCP remoto: https://docsmcp.googleapis.com/mcp/v1
    4. En Configuración avanzada, ingresa tu ID de cliente de OAuth y el secreto de cliente de OAuth.
    5. Haz clic en Agregar.

Otros

Muchas aplicaciones de IA tienen formas de conectarse a un servidor de MCP remoto. Por lo general, debes ingresar detalles sobre el servidor, como su nombre, extremos, protocolo de transporte y método de autenticación. Para el servidor de MCP remoto de Documentos, ingresa lo siguiente:

  • Nombre del servidor: docs

  • URL del servidor: https://docsmcp.googleapis.com/mcp/v1

  • Transport: Streamable HTTP

  • Autenticación: El servidor de MCP remoto de Documentos usa OAuth 2.0. Cuando crees tu cliente de OAuth 2.0, selecciona Usar este cliente para un agente potenciado por IA. Para obtener más detalles, consulta Más información sobre la autenticación y la autorización.

    Para evitar que se muestren cuadros de inicio de sesión cada hora con un cliente de OAuth de aplicación web, configura tu cliente de MCP para que solicite acceso sin conexión con access_type=offline o el permiso offline_access. Para obtener más detalles, consulta Mensajes de acceso repetidos cada hora.

Para obtener más detalles sobre cómo conectar diferentes tipos de aplicaciones de IA, consulta Configura el MCP en una aplicación de IA.

Prueba el servidor de MCP de Documentos

Después de configurar tu aplicación de IA, puedes verificar la conexión ejecutando algunas instrucciones de prueba.

Prueba hacerle las siguientes preguntas a tu aplicación de IA:

  • "Muéstrame el contenido estructural del documento de Google abcd123".

    El cliente recupera la estructura y el contenido del documento con docs.read_doc.

  • "Inserta el título 'Mi plan de marketing' en el documento de Google abcd123".

    El cliente realiza docs.update_doc para actualizar elementos estructurales y, luego, insertar texto.

Si las herramientas se ejecutan correctamente y recibes respuestas pertinentes, significa que tu servidor de MCP de Documentos está configurado de forma correcta.

Solución de problemas

Usa las siguientes secciones para resolver problemas comunes de autenticación y conexión con el servidor de MCP de Documentos.

Verifica los eventos de registro de OAuth

Si tienes problemas para conectarte al servidor de MCP, verifica si hay errores en los registros de OAuth. Pídele al administrador de Google Workspace que revise los eventos de registro de OAuth en la herramienta de investigación de seguridad.

Solicitudes rechazadas de clientes de OAuth delegados por el usuario

Si se rechazan tus solicitudes al servidor de MCP, verifica que el ID de cliente de OAuth 2.0 delegado por el usuario para tu flujo de OAuth de 3 niveles tenga seleccionada la opción Usar este cliente para un agente potenciado por IA en Google Auth Platform > Clientes:

  • El cliente existente admite el parámetro de configuración: Selecciona Usar este cliente para un agente potenciado por IA en tu cliente de OAuth existente.
  • No se puede actualizar el cliente existente: Crea un cliente de OAuth nuevo con la opción Usa este cliente para un agente potenciado por IA seleccionada y actualiza tu app para usarlo.
  • El cliente existente también admite funciones que no son de agente: Crea un cliente de OAuth independiente para el agente de IA y conserva el cliente existente para las funciones que no son de agente.

Para obtener instrucciones, consulta Configura tu aplicación de IA y Administra clientes de OAuth.

Cuentas de servicio con delegación de todo el dominio

Si tu app usa una cuenta de servicio con delegación de todo el dominio para OAuth de 2 segmentos, no puedes seleccionar Usa este cliente para un agente potenciado por IA porque las cuentas de servicio no se administran en Google Auth Platform > Clientes:

  • Control de acceso: Las solicitudes al servidor de MCP desde estas cuentas de servicio no se rechazan por no tener el parámetro de configuración del agente. En cambio, el acceso se rige por la configuración de delegación de todo el dominio que administra tu administrador de Google Workspace. Para obtener detalles sobre la configuración de administrador, consulta Controla el acceso a la API con la delegación en todo el dominio.
  • Acciones sensibles: Los servidores de MCP de Google Workspace siguen devolviendo mensajes de obtención de formularios para la confirmación con intervención humana en las llamadas a la herramienta sensibles que se realizan a través de la identidad temporal de usuarios de la delegación de todo el dominio.

Solicitudes de Apps Script

Si llamas al servidor de MCP desde Apps Script, no puedes seleccionar Usa este cliente para un agente potenciado por IA en el cliente de OAuth predeterminado que Apps Script crea y administra para tu secuencia de comandos. Esto se aplica incluso si tu secuencia de comandos usa un proyecto estándar de Google Cloud.

Para llamar al servidor de MCP desde Apps Script, haz lo siguiente:

  1. En la consola de Google Cloud, ve a Google Auth Platform > Clientes, crea un cliente de OAuth y selecciona Usa este cliente para un agente potenciado por IA.
  2. En tu secuencia de comandos, usa la biblioteca de OAuth2 para Apps Script para autorizar a los usuarios con ese cliente de OAuth.
  3. Cuando llames al servidor de MCP, envía el token de acceso que devuelve la biblioteca en lugar del token de ScriptApp.getOAuthToken.

Los proyectos de Apps Script que no llaman a los servidores de MCP de Google Workspace no se ven afectados.

Mensajes de acceso repetidos cada hora

Si se te solicita que vuelvas a acceder cada hora, tu cliente de MCP no recibe ni usa un token de actualización. Por lo general, esto sucede en las siguientes situaciones:

  • Falta el acceso sin conexión en un cliente de OAuth de aplicación web: A diferencia de los clientes de OAuth de app para computadoras, los clientes de OAuth de aplicación web tienen acceso en línea de forma predeterminada. Para solicitar un token de actualización, incluye access_type=offline o el permiso offline_access de OpenID Connect (OIDC) junto con, al menos, un permiso de la API, y no configures access_type=online.
  • Vuelve a autorizar una app que ya tiene consentimiento: El servidor de OAuth 2.0 de Google emite un token de actualización la primera vez que un usuario otorga acceso sin conexión. Si un usuario ya autorizó tu cliente de OAuth sin acceso sin conexión o si tu cliente de MCP perdió su token de actualización almacenado, es posible que los accesos posteriores no devuelvan un token de actualización nuevo. Incluye prompt=consent en la solicitud de autorización o quita el acceso de la app en Conexiones de la Cuenta de Google y vuelve a acceder.
  • Token del portador estático: Si pasas un token de acceso sin procesar en un encabezado Authorization, como el resultado de gcloud auth print-access-token, el token vence después de una hora, a menos que tu cliente lo actualice.

Para obtener más información, consulta Actualiza un token de acceso.

Referencia de la herramienta

Las siguientes herramientas están disponibles para el servidor de MCP de Documentos. Para conocer los esquemas de entrada y salida, consulta la referencia del MCP de Documentos:

Consideración de seguridad importante: Inyección de instrucciones indirecta

Cuando expones un modelo de lenguaje a datos no confiables, existe el riesgo de que se produzca un ataque de inyección de instrucciones indirecta. Debido a que las aplicaciones de IA, como Google Antigravity, tienen acceso a herramientas y APIs potentes a través del servidor de MCP de Documentos, pueden leer, modificar y borrar datos de tu Cuenta de Google.

Para mitigar estos riesgos, debes analizar las instrucciones y las respuestas en busca de contenido malicioso o ataques de inyección de instrucciones. Puedes usar Model Armor, proporcionado por Google, o tu propia solución si la documentas para que los usuarios puedan aceptar ese riesgo. Para obtener instrucciones, consulta Configura la seguridad de los servidores de MCP de Google Workspace.

Sigue las prácticas recomendadas a continuación:

  • Solo usa herramientas de confianza. Nunca conectes el servidor de MCP de Documentos a aplicaciones no confiables o no verificadas.
  • Ten cuidado con las entradas no confiables. Evita pedirle a tu aplicación de IA que procese documentos o cualquier otro recurso de fuentes no verificadas. Estas entradas pueden contener instrucciones ocultas que pueden apropiarse de tu sesión y permitir que un atacante modifique, robe o borre tus datos.
  • Revisa todas las acciones. Revisa siempre con atención las acciones que realiza la aplicación de IA en tu nombre para asegurarte de que sean precisas y coincidan con tus intenciones.