Configura el servidor de MCP de Hojas de cálculo

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

El servidor de MCP de Hojas de cálculo de Google proporciona una forma estandarizada para que los agentes de IA hagan lo siguiente:

  • Leer datos: Recuperar valores de celdas, nombres de hojas, propiedades de cuadrículas y otros metadatos de hojas de cálculo
  • Toma medidas: Actualizar valores de celdas, establecer fórmulas, insertar filas o columnas y ejecutar actualizaciones estructurales por lotes de hojas de cálculo
  • Respetar la seguridad: Heredar los mismos permisos y controles de administración de datos que el usuario

Requisitos previos

  • Un proyecto de Google Cloud, para crear uno, consulta Crea un proyecto.

  • Un host 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 Hojas de cálculo de Google

Para usar el servidor de MCP de Hojas de cálculo de Google, 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 Hojas de cálculo de Google, debes habilitar la siguiente API en tu proyecto de Google Cloud:

  • API de Google Sheets

CLI

gcloud services enable sheets.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 Hojas de cálculo de Google, debes habilitar el siguiente servicio en tu proyecto de Google Cloud:

  • API de MCP de Hojas de cálculo de Google

CLI

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

Habilitar los servicios de MCP

El servidor de MCP de Hojas de cálculo de Google 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.

  1. En la consola de Google Cloud, ve a Google Auth Platform > Información de la marca.

    Ir a Información de la marca

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

    1. En Información de la aplicación, en Nombre de la aplicación, escribe Sheets 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 el 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 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 habilitaste en tu proyecto de Google Cloud.

    1. En Agregar permisos de forma manual, pega los permisos para el servidor de MCP de Hojas de cálculo de Google:

      • https://www.googleapis.com/auth/drive.readonly
      • https://www.googleapis.com/auth/drive.file
      • https://www.googleapis.com/auth/spreadsheets.readonly
      • https://www.googleapis.com/auth/spreadsheets

    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 Hojas de cálculo de Google a tu cliente de MCP, sigue las instrucciones de tu cliente.

Antigravity

Para agregar el servidor de MCP remoto de Hojas de cálculo de Google a Antigravity, agrega la configuración del servidor a tu archivo mcp_config.json. Estas instrucciones admiten 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. Ingresa 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. Haz clic en Crear y copia tu ID de cliente y secreto del cliente.

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

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

    {
  "mcpServers": {
    "sheets": {
      "serverUrl": "https://sheetsmcp.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. Guarda 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 de usuario de Antigravity).
      2. Navega a Personalizaciones.
      3. En Servidores de MCP instalados, haz clic en Actualizar.
      4. Busca sheets 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 sheets, 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.

  6. 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 al servidor 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 cualquier servidor en la vista del panel para inspeccionar su estado y enumerar todas las herramientas disponibles.

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

Claude

Para usar el servidor de MCP remoto de Hojas de cálculo de Google con Claude.ai o Claude Desktop, debes tener el plan Claude Enterprise, Pro, Max o Team.

Para agregar el servidor de MCP remoto de Hojas de cálculo de Google a Claude, configura un conector personalizado con un ID de cliente y un secreto 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. Ingresa 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. Haz clic en Crear y copia tu ID de cliente y 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 Hojas de cálculo de Google:
      • Nombre del servidor: Google Sheets.
      • URL del servidor de MCP remoto: https://sheetsmcp.googleapis.com/mcp/v1
    4. En Configuración avanzada, ingresa tu ID de cliente de OAuth y 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 Hojas de cálculo de Google, ingresa lo siguiente:

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 Hojas de cálculo de Google

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

Intenta hacerle las siguientes preguntas a tu cliente de MCP:

  • "Read sheet Sheet1 from Google Sheet abcd123."

    El cliente recupera los valores de la cuadrícula con sheets.get_values.

  • "Insert a column at column index 2 in Google Sheet abcd123."

    El cliente realiza sheets.insert_dimension para mutar columnas.

Si las herramientas se ejecutan correctamente y recibes respuestas relevantes, tu servidor de MCP de Hojas de cálculo de Google está configurado correctamente.

Solución de problemas

Si tienes problemas para conectarte al servidor de MCP, puedes buscar 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.

Referencia de herramientas

Las siguientes herramientas están disponibles para el servidor de MCP de Hojas de cálculo de Google:

  • get_values
  • get_spreadsheet
  • update_spreadsheet
  • update_values
  • update_formulas
  • insert_dimension

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

Cuando expones un modelo de lenguaje a datos no confiables, existe el riesgo de un ataque de inyección indirecta de instrucciones. Debido a que los hosts de MCP, como Google Antigravity, tienen acceso a potentes herramientas y APIs a través del servidor de MCP de Hojas de cálculo de Google, pueden leer, modificar y borrar datos en tu Cuenta de Google.

Para mitigar estos riesgos, debes filtrar 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 para 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 Hojas de cálculo de Google a aplicaciones no confiables o no verificadas.
  • Ten cuidado con las entradas no confiables. Evita pedirle a tu cliente de MCP que procese hojas de cálculo u otros recursos de fuentes no verificadas. Estas entradas pueden contener instrucciones ocultas que pueden secuestrar 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.