lab
Esc

Prueba con

↑↓ para moverte · Enter para abrir · también en /buscar?q= para agentes

configuración intermedio mcpclaude-codegeminiga4

Google Analytics MCP: consulta tus propiedades desde el agente

Pregunta por informes y actividad de GA4 con un servidor mantenido por Google. Empieza con permisos de lectura y compara las respuestas con Analytics.

✓ verificado el 27 oct 2026

Instrucciones para tu agente

Esto es lo que se copia. Pégaselo a tu agente y te lo monta paso a paso.

O ábrelo directamente en ClaudeChatGPT

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

Para el agente: cómo acompañar al usuario

  1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
  2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
  3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
  4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
  5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
  6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

Pasos de configuración

Paso 1: prepara el acceso

Comprueba que tienes Python ≥3.10, pipx, gcloud y Claude Code disponibles. Habilita Admin API y Data API. Crea un cliente OAuth de escritorio y descarga su JSON privado. La ruta ADC del README se ejecuta así, sustituyendo YOUR_CLIENT_JSON_FILE por su ruta:

gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=YOUR_CLIENT_JSON_FILE

Autoriza con la identidad que puede leer GA4 y conserva la ruta que imprime «Credentials saved to file»: úsala como PATH_TO_CREDENTIALS_JSON en el siguiente paso. No pegues el contenido de las credenciales en el chat.

Paso 2: conecta Claude Code

El comando oficial utiliza marcadores que debes sustituir por rutas e identificadores de tu entorno:

claude mcp add analytics-mcp \
  --scope user \
  -e "GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_CREDENTIALS_JSON" \
  -e "GOOGLE_PROJECT_ID=YOUR_PROJECT_ID" \
  -- pipx run analytics-mcp

Paso 3: prueba lectura

Pide listar las cuentas y propiedades accesibles y después un informe corto de una propiedad de ensayo.

Comprobación

Compara un informe con GA4 usando el mismo periodo y dimensiones. Comprueba que la configuración no incorpora --allow-write ni solicita alcance de edición.

Si algo falla

Si no encuentra propiedades, revisa los permisos de la identidad ADC. Si la API está deshabilitada o hay errores de cuota, corrige el proyecto de Google Cloud siguiendo el README.

Consulta el README oficial para el procedimiento completo y los cambios de versión.

ver en .md ¿Prefieres el recurso entero?

Qué es

Google Analytics MCP es un servidor experimental para acceder a las API de Analytics desde un cliente MCP. Expone consultas de cuentas, propiedades e informes, incluidos datos en tiempo real.

Para qué te sirve

  • Cuando necesitas investigar qué eventos se usan más en una propiedad.
  • Cuando quieres consultar dimensiones disponibles antes de pedir un informe.
  • Cuando comparas actividad reciente sin exportar manualmente cada tabla.

Cómo funciona

El proceso local utiliza Google Analytics Admin API y Data API con las credenciales del usuario. Las herramientas traducen consultas estructuradas en informes. El modo predeterminado es de lectura; la versión actual documenta una opción de escritura para anotaciones.

Antes de empezar

Necesitas Python ≥3.10, pipx, gcloud, un proyecto Google Cloud con ambas API activadas y acceso a la propiedad. Configura Application Default Credentials con el alcance analytics.readonly. Sigue el README para elegir el cliente y la identidad autorizada.

Límites y alternativas

No asumas que todas sus versiones son exclusivamente de lectura: --allow-write y el alcance de edición habilitan una herramienta adicional. No los actives para una prueba de informes. Las cuotas y el acceso a datos siguen dependiendo de Google; contrasta periodos, zona horaria y filtros con GA4.

Recursos