Cómo conectar Google Analytics a Claude vía MCP (guía completa) | Creative Web
Guía técnica · MCP

Cómo conectar Google Analytics a Claude vía MCP

Paso a paso para que Claude Desktop lea directamente tus datos de GA4 — con los errores más comunes y cómo resolverlos, aprendidos a punta de prueba y error.

Ricardo Cáceres Quiroz · Creative Web · Actualizado julio 2026
1
Service Account en GCP
2
APIs a habilitar
0
Líneas de código propias
TL;DR
  • El conector se instala con pipx run analytics-mcp, no hay que programar nada.
  • Necesitas un Service Account de Google Cloud con su archivo JSON de credenciales.
  • Hay que habilitar la Google Analytics Admin API y la Data API en el proyecto de GCP — este es el paso que casi todos se saltan.
  • El Service Account debe agregarse como usuario (rol Viewer) dentro de la propiedad GA4.
  • Después de editar claude_desktop_config.json, hay que cerrar Claude Desktop desde la bandeja del sistema y volver a abrirlo — no basta con cerrar la ventana.

Por qué conviene tener Analytics conectado directo a Claude

Cada vez que un cliente pregunta "¿cómo venimos este mes?" implica abrir GA4, armar el reporte, exportarlo y después redactar el análisis. Conectar Google Analytics a Claude por MCP (Model Context Protocol) elimina ese paso intermedio: Claude consulta la propiedad directamente y arma el análisis en el mismo chat, con el contexto de la cuenta que ya tiene guardado.

El MCP no reemplaza tu criterio analítico, reemplaza el tiempo que perdías exportando CSVs para llegar a él.

Lo que necesitas antes de empezar

  • Claude Desktop instalado (Windows o Mac).
  • Python 3.12+ y pipx instalados.
  • Una cuenta de Google Cloud con un proyecto activo.
  • Acceso de administrador a la propiedad de GA4 que quieres conectar.

Paso 1: crear el Service Account en Google Cloud

Ve a Google Cloud Console → IAM y administración → Cuentas de servicio → Crear cuenta de servicio. Al terminar, genera una clave en formato JSON y descárgala — este archivo es el que usará Claude para autenticarse.

Punto crítico
Guarda el JSON en una ruta local simple (no dentro de OneDrive con sincronización activa "solo en la nube"), por ejemplo C:\Users\usuario\claude-credentials\. Si OneDrive no ha descargado el archivo localmente, Claude no podrá leerlo aunque la ruta sea correcta.

Paso 2: habilitar las APIs — el paso que casi todos se saltan

Tener el Service Account no es suficiente. En el mismo proyecto de Google Cloud, ve a "APIs y servicios habilitados" y activa:

  • Google Analytics Admin API
  • Google Analytics Data API

Sin este paso, el servidor MCP puede arrancar perfectamente bien — incluso mostrar "Starting MCP Stdio Server" en consola sin ningún error — pero cualquier consulta real a GA4 fallará con un error de permisos poco claro.

Paso 3: dar acceso al Service Account dentro de GA4

Abre el archivo JSON descargado y busca el campo client_email (termina en @tu-proyecto.iam.gserviceaccount.com). Luego, en Google Analytics:

Administrar → Acceso a la propiedad → botón "+" → Agregar usuarios → pega ese correo → asigna rol Viewer / Lector.

Paso 4: configurar Claude Desktop

Dentro de la app, ve a Configuración → Conectores → Servidores MCP locales → Editar configuración. Esto abre el archivo real que la aplicación lee (en Windows, suele estar en %APPDATA%\Claude\claude_desktop_config.json). Agrega el bloque del servidor:

{
  "mcpServers": {
    "analytics-mcp": {
      "command": "RUTA\\A\\pipx.exe",
      "args": ["run", "analytics-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "RUTA\\AL\\ARCHIVO.json",
        "GOOGLE_PROJECT_ID": "tu-project-id"
      }
    }
  }
}

Reinicia Claude Desktop por completo

Este es el error más común: guardar la configuración y solo cerrar la ventana. Claude Desktop solo relee mcpServers al iniciar. Hay que cerrarlo desde la bandeja del sistema (icono junto al reloj → clic derecho → Salir) y volver a abrirlo.

Errores comunes y cómo resolverlos

SíntomaCausa probableSolución
"No se han agregado servidores" Falta reiniciar la app, o se editó el archivo equivocado Cerrar desde la bandeja del sistema y reabrir
El comando funciona en consola pero no en Claude Configuración no guardada en la ruta que lee Claude Desktop Usar el botón "Editar configuración" para confirmar la ruta real
Conecta pero las consultas fallan Service Account sin permisos en GA4, o APIs no habilitadas en GCP Verificar rol Viewer en GA4 y activar Admin/Data API
No encuentra el archivo de credenciales Archivo en OneDrive sin descargar localmente Mover el JSON a una carpeta local fuera de OneDrive
Mito

Si el servidor MCP arranca en consola, ya está todo conectado.

Realidad

Arrancar el proceso solo confirma que el comando es válido — Claude Desktop necesita leer la configuración y el Service Account necesita permisos reales en GA4.

Una vez conectado: qué puedes pedirle a Claude

Con el conector activo, puedes pedir reportes de tráfico, comparaciones de conversión por canal, análisis de cohortes o cruces entre Google Ads y GA4 — todo dentro del mismo chat donde ya tienes el contexto de la cuenta y del negocio.

¿Prefieres que alguien más lo configure por ti?

En Creative Web dejamos este tipo de integraciones funcionando de punta a punta.

Conocer Creative Web

Preguntas frecuentes

¿Necesito programar algo para conectar Google Analytics a Claude?

No. El conector analytics-mcp es un paquete ya construido que se instala con pipx. Solo necesitas configurar el archivo claude_desktop_config.json y crear un Service Account en Google Cloud.

¿Por qué Claude no detecta mi servidor MCP de Analytics aunque el comando funciona en consola?

Casi siempre es porque Claude Desktop no se reinició después de editar la configuración, o porque el archivo editado no es el mismo que la app está leyendo. Cierra Claude Desktop completamente desde la bandeja del sistema y ábrelo de nuevo.

¿Qué permisos necesita el Service Account en GA4?

Basta con el rol de Viewer (Lector) en la propiedad de GA4 que quieres consultar. Se agrega en Administrar > Acceso a la propiedad, usando el client_email del archivo JSON de credenciales.

¿Hay que habilitar alguna API en Google Cloud además de crear el Service Account?

Sí, y es el paso que más se salta: hay que habilitar la Google Analytics Admin API (y la Google Analytics Data API) en el proyecto de Google Cloud correspondiente, o las consultas fallarán aunque el Service Account tenga acceso en GA4.

RC
Ricardo Cáceres Quiroz
Fundador de Creative Web · Google Ads, Meta Ads y automatización con IA para PYMEs chilenas