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.
- 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
pipxinstalados. - 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.
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íntoma | Causa probable | Solució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 |
Si el servidor MCP arranca en consola, ya está todo conectado.
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.
En Creative Web dejamos este tipo de integraciones funcionando de punta a punta.
Conocer Creative WebPreguntas frecuentes
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.
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.
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.
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.