Configura el servidor de MCP de Chat

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

El servidor de MCP de Google Chat proporciona una forma estandarizada para que los agentes de IA realicen las siguientes acciones:

  • Leer datos: Enumera y busca conversaciones, y lee mensajes.
  • 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 Google Chat

Para usar el servidor de MCP de Google Chat, 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 Google Chat, debes habilitar las siguientes APIs en tu proyecto de Google Cloud:

  • API de Google Chat

CLI

gcloud services enable chat.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 Google Chat, debes habilitar el siguiente servicio en tu proyecto de Google Cloud:

  • API de MCP de Google Chat

CLI

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

Configura la app de Chat

Para usar el servidor de MCP de Google Chat y realizar operaciones de solo lectura, como buscar conversaciones, debes habilitar la API y crear un cliente de OAuth. No se requiere una app de Chat configurada.

Para realizar operaciones de escritura, como enviar mensajes, debes configurar una app de Chat en tu proyecto de Google Cloud.

  1. En la consola de Google Cloud, busca API de Google Chat y haz clic en API de Google Chat > Administrar > Configuración.

    Ir a la API de Google Chat

  2. Configura la app de Chat:

    1. En el campo Nombre de la app, ingresa Chat MCP.
    2. En el campo URL del avatar, ingresa https://developers.google.com/chat/images/quickstart-app-avatar.png.
    3. En Descripción, ingresa Chat MCP server.
    4. En Funcionalidad, desactiva las funciones interactivas con el botón de activación Habilitar funciones interactivas.
    5. En Registros, selecciona Registrar errores en Logging.

  3. Haz clic en Guardar.

Para obtener más información sobre cómo compilar una app de Chat, consulta Elige una arquitectura de app de Google Chat.

El servidor de MCP de Google Chat 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 la Plataforma de autenticación de Google, 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 Chat 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 las APIs de Google y, si estás de acuerdo, selecciona Acepto la Política de Datos del Usuario de los Servicios de las 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 Google Chat:

      • https://www.googleapis.com/auth/chat.spaces.readonly
      • https://www.googleapis.com/auth/chat.memberships.readonly
      • https://www.googleapis.com/auth/chat.messages.readonly
      • https://www.googleapis.com/auth/chat.messages.create
      • https://www.googleapis.com/auth/chat.users.readstate
      • https://www.googleapis.com/auth/chat.users.spacesettings

    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 cliente de MCP

Para agregar el servidor de MCP remoto de Google Chat a tu cliente de MCP, sigue las instrucciones para tu cliente.

Antigravity

Para agregar el servidor de MCP remoto de Google Chat 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": {
    "chat": {
      "serverUrl": "https://chatmcp.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 Antigravity User Settings).
      2. Navega a Personalizaciones.
      3. En Servidores de MCP instalados, haz clic en Actualizar.
      4. Busca chat 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 chat, 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 Google Chat con Claude.ai o Claude Desktop, debes tener el plan Claude Enterprise, Pro, Max o Team.

Para agregar el servidor de MCP remoto de Google Chat 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 (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 Google Chat:
      • Nombre del servidor: Google Chat.
      • URL del servidor de MCP remoto: https://chatmcp.googleapis.com/mcp/v1
    4. En Configuración avanzada, ingresa tu ID de cliente de OAuth y el secreto del 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 Google Chat, ingresa lo siguiente:

  • Nombre del servidor: chat

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

  • Transporte: HTTP transmisible

  • Autenticación: El servidor de MCP remoto de Google Chat 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 obtener más detalles sobre cómo conectar diferentes tipos de clientes, consulta Configura MCP en una aplicación de IA.

Prueba el servidor de MCP de Google Chat

Después de configurar el cliente de MCP, puedes verificar la conexión ejecutando algunas instrucciones de prueba.

Prueba hacerle las siguientes preguntas a tu cliente de MCP:

  • "¿Cuál fue el último mensaje en el espacio 'Proyecto X'?"

    El cliente encuentra el espacio con search_conversations y, luego, recupera los mensajes con list_messages.

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

Solución de problemas

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

Si se rechazan tus solicitudes al servidor de MCP, verifica que tu cliente de OAuth 2.0 tenga seleccionada la opción Usa este cliente para un agente potenciado por IA en Google Auth Platform > Clientes. Si no puedes cambiar este parámetro de configuración en un cliente de OAuth 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. Si se usa un cliente de OAuth existente para las funciones de agente de IA y las 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 cliente de MCP y Administra clientes de OAuth.

Si se te solicita que vuelvas a acceder cada hora, tu cliente de MCP no recibe un token de actualización. El servidor de autorización de Google emite tokens de actualización solo cuando la solicitud de autorización incluye access_type=offline; solicitar solo el permiso offline_access de OIDC no es suficiente. Si tu cliente de MCP admite parámetros de autorización personalizados, agrega access_type=offline a la solicitud de autorización. Para obtener un nuevo token de actualización para un usuario que ya otorgó acceso, agrega también prompt=consent.

Referencia de la herramienta

Las siguientes herramientas están disponibles para el servidor de MCP de Google Chat:

  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
  • get_notification_settings
  • update_notification_settings

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 indirecto. Debido a que los hosts de MCP, como Google Antigravity, tienen acceso a herramientas y APIs potentes a través del servidor de MCP de Google Chat, 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 acepten ese riesgo. Para obtener más información, consulta Configura la seguridad de los servidores de MCP de Google Workspace.

Sigue las prácticas recomendadas a continuación:

  • Usa solo herramientas de confianza. Nunca conectes el servidor de MCP de Google Chat a aplicaciones que no sean de confianza o no estén verificadas.
  • Ten cuidado con las entradas que no son de confianza. Evita pedirle a tu cliente de MCP que procese mensajes o cualquier otro recurso de fuentes no verificadas. Estas entradas pueden contener instrucciones ocultas que pueden apropiarse de tu sesión, lo que permite que un atacante modifique, robe o borre tus datos.
  • Revisa todas las acciones. Revisa siempre con atención las acciones que realiza tu cliente de IA en tu nombre para asegurarte de que sean correctas y se alineen con tus intenciones.