Conectar GA4 a Claude Code ayuda a investigar si la instrumentación de eventos coincide con los datos que llegan a Analytics. Agrega herramientas de informes a la sesión de código sin guardar credenciales de Google en el repositorio. Revisa el contrato de eventos y decide si el siguiente paso corresponde al código, Tag Manager o GA4.
¿Qué necesitas antes de conectar?
Instala Claude Code en la computadora donde ejecutarás los comandos. Su CLI admite servidores MCP HTTP remotos y OAuth en el navegador. Esta ruta registra un servidor explícito de alcance de usuario para tus proyectos; compartir configuración de equipo por proyecto es otra decisión. No necesitas ejecutar un servidor local de Google API.
- Una cuenta de Google con acceso a la propiedad GA4 que quieres analizar.
- Una cuenta de LoomaScale y una conexión de Google Analytics; conectar Google Ads no autoriza Analytics.
- El ID numérico de la propiedad o acceso para descubrirlo en la lista de cuentas. Un ID de medición G- identifica un flujo web, no la propiedad usada para los informes.
¿Cómo conectas Claude Code a GA4?
1. Conecta GA4 en LoomaScale
Crea una cuenta de LoomaScale o inicia sesión y abre las conexiones. Elige Google Analytics, entra con el correo de Google que tiene acceso a los datos y revisa los permisos solicitados. Iniciar sesión en LoomaScale con Google no sustituye conectar esta fuente. Puedes conectar el servicio sin conectar una cuenta publicitaria.
2. Registra el servidor MCP remoto en Claude Code
Ejecuta este comando en la terminal del sistema, fuera de una conversación de Claude Code. El alcance de usuario permite usar la conexión en tus proyectos. La URL selecciona las herramientas de este servicio de Google.
claude mcp add --transport http --scope user loomascale-ga4 https://api.loomascale.com/mcp/ga4Si ya usas el plugin completo de LoomaScale para agentes, revisa sus herramientas antes de agregar otra conexión. La ruta con plugin está en la guía de Claude Code; este artículo usa configuración MCP directa.
3. Autentícate desde el menú MCP de Claude Code
Abre Claude Code e introduce /mcp. Selecciona loomascale-ga4 y completa la autenticación en el navegador. Usa la cuenta de LoomaScale que tiene tu fuente de Google conectada. Vuelve a Claude Code y confirma que el servidor esté conectado. Desde la terminal del sistema, revisa la entrada con claude mcp get loomascale-ga4 o claude mcp list. Agregar el servidor guarda la configuración; no demuestra que la consulta de cuentas de Google haya funcionado.
4. Verifica el acceso con una consulta real de cuentas
Usa LoomaScale para llamar a ga4_get_account_summaries. Muestra mis propiedades GA4 con sus nombres e ID numéricos. Pregúntame cuál usar. Lee su zona horaria de informes y su moneda. No cambies ninguna configuración.
La respuesta debe mostrar propiedades de tu cuenta de Google, con un recurso como properties/123456789. Elige por nombre e ID y conserva esa selección en las siguientes solicitudes. Una explicación de GA4 o un panel de ejemplo no verifica que el conector haya obtenido datos. Una lista vacía puede ser una respuesta válida si esa cuenta no tiene propiedades accesibles.
¿Cómo compruebas un contrato de eventos con Claude Code y GA4?
Empieza con un evento identificable en el repositorio, como generate_lead. Pide a Claude Code registrar su nombre exacto y las condiciones que lo emiten. Después contrasta ese contrato con los nombres observados y sus recuentos recientes en GA4. Un evento ausente es una pista para investigar, no una prueba automática de que el código nunca se ejecutó.
Usa LoomaScale con la propiedad GA4 seleccionada. Lee la instrumentación de eventos del formulario de leads del repositorio sin editar archivos. Identifica nombres previstos y cuándo se activan. Muestra eventCount por eventName en los últimos 7 días completos y busca los nombres esperados. Si ayuda, consulta eventos en tiempo real por separado. Explica qué verifica el informe y qué necesita una prueba en navegador. No crees eventos ni cambies configuraciones.
Distingue un nombre incorrecto de un fallo de recopilación. Un evento reciente puede faltar en un informe fechado mientras se procesa; el resultado en tiempo real cubre otra ventana temporal. Comprueba propiedad y flujo antes de editar código. Si necesitas una prueba en navegador, usa el entorno adecuado de pruebas del sitio y revisa las solicitudes realmente enviadas.
¿Qué dirección MCP usa esta guía?
https://api.loomascale.com/mcp/ga4La dirección específica expone herramientas de GA4 y funciones de cuenta de LoomaScale. El plugin o conector completo del directorio usa https://api.loomascale.com/mcp y puede acceder a las fuentes que conectes por separado. Elige la conexión completa para trabajar entre servicios o la dirección específica para las herramientas de esta fuente. Elegir una dirección limita las herramientas expuestas, no los roles que tiene tu cuenta de Google.
¿Qué puede leer o cambiar Claude Code en GA4?
LoomaScale obtiene informes de tráfico, interacción, eventos clave, ingresos, actividad en tiempo real y embudos. Empieza por los informes e indica fechas, dimensiones y métricas. Las herramientas de configuración pueden marcar eventos clave, añadir o cambiar reglas de eventos, ajustar la medición mejorada y la ocultación de datos, y crear o renombrar flujos web después de que apruebes una simulación; requieren el rol Editor en la propiedad y el permiso analytics.edit otorgado al conectar, y poder leer informes no concede edición. Conectar el asistente no instala etiquetas en tu sitio, no crea eventos históricos ni iguala la atribución de GA4 con la de una plataforma publicitaria.
¿Por qué faltan la conexión o los datos?
Si el servidor necesita autenticación, abre /mcp e inicia sesión otra vez. Si faltan herramientas, revisa claude mcp list, la dirección de la fuente y las restricciones de la organización. Reinicia la sesión tras cambiar la configuración si hace falta. El conector web de Claude y un servidor CLI explícito pueden solaparse; revisa las herramientas activas antes de duplicar conexiones.
Si falta la propiedad, revisa el correo de Google, el acceso a la propiedad y la conexión de Analytics en LoomaScale. Si el informe está vacío, comprueba la propiedad, las fechas, los filtros y el envío de eventos desde tu sitio. Compara periodos equivalentes en la zona horaria de la propiedad. Si difieren las métricas, conserva sus nombres y definiciones de atribución antes de sacar conclusiones. Usa el ID de la propiedad para informes, no el identificador G- del flujo.
Guías relacionadas y referencias oficiales
Usa GA4 desde otro asistente
- Cómo conectar ChatGPT a GA4
- Cómo conectar Claude a GA4
- Cómo conectar Codex a GA4
- Cómo conectar Grok Build a GA4
Conecta otra fuente de Google a Claude Code
Referencias oficiales de configuración
- Guía de Anthropic sobre MCP, alcances y autenticación de Claude Code
- Referencia de Google sobre el ID de propiedad GA4
Referencias de configuración revisadas el 12 de noviembre de 2026. Las etiquetas y políticas del espacio pueden cambiar; consulta la documentación enlazada del proveedor para tu cuenta. Los flujos compatibles de LoomaScale están en el centro de documentación.
