Conecta GA4 a Claude Code con un solo comando
Claude Code
Conecta GA4 a Claude Code: ejecuta claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, escribe /mcp y entra con tu cuenta de PaidSync.ai.
Claude Code accede a Google Analytics 4 con 26 tools: informes, tiempo real, eventos clave, dimensiones, audiencias y vínculos con Google Ads. Pregunta antes de cada tool; las escrituras en GA4 se aplican a la primera, sin simulación.
Un comando. Login OAuth, sin claves. Plan gratis, 100 tareas al mes, valor $50, sin tarjeta.
El comando
Claude Code se comunica con servidores MCP remotos mediante Streamable HTTP. PaidSync es uno de ellos. Añádelo una vez y la misma terminal que edita tu código podrá consultar y configurar tus propiedades de GA4.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPor defecto, eso registra el servidor solo para el proyecto actual. Añade --scope user para que esté disponible en todos los proyectos de tu equipo.
Ejecuta claude mcp list para confirmar que está ahí, luego inicia una sesión y escribe /mcp para iniciar sesión.
Configuración en 5 pasos
1Regístrate en paidsync.ai/signup
Lleva 10 segundos. Inicio de sesión con Google o correo. El plan gratuito son 100 tareas al mes a $0, sin tarjeta.
2Conecta GA4 en el panel de PaidSync
Haz clic en Conectar en Google Analytics 4. GA4 se autoriza con Google OAuth, con la cuenta de Google que tiene acceso a tus propiedades. Usa el mismo inicio de sesión de Google que Google Ads y pide los permisos de analítica, analytics.edit y analytics.readonly.
¿Ya estás dentro de Claude Code? Pídele que ejecute connect_ga4. La herramienta devuelve un enlace OAuth para abrir en tu navegador.
3Elige la propiedad en la que debe trabajar Claude Code
Dentro de una sesión, list_ga4_accounts y list_ga4_properties muestran todas las propiedades a las que llega tu inicio de sesión. Indica la propiedad en tu prompt, o fíjala en el CLAUDE.md de tu proyecto para que todas las sesiones la usen.
4Añade PaidSync a Claude Code
En tu terminal, ejecuta:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpInicia una sesión, escribe /mcp, elige paidsync e inicia sesión con tu acceso de PaidSync en la ventana del navegador que se abre. Claude Code guarda el token OAuth por ti. No se pega ninguna clave en ningún sitio.
¿Lo configuras para un equipo? Sube un .mcp.json en la raíz del repositorio para que cada ingeniero reciba el mismo conector:
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}¿Prefieres una clave API, por ejemplo para ejecuciones sin interfaz? Envíala en una cabecera, nunca en la URL, donde acabaría en los registros:
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"En un .mcp.json versionado, añade "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } para que la clave se quede en el entorno de cada ingeniero y nunca entre en git. Aplicar un cambio en Google Ads sigue requiriendo el inicio de sesión OAuth. En otras plataformas una clave también puede aplicar cambios, así que trátala como una contraseña y prefiere OAuth.
5Prueba la conexión
En una sesión de Claude Code pregunta: “Muéstrame las sesiones y los eventos clave por fuente y medio de los últimos 28 días”
Claude Code ejecuta un informe de GA4 sobre la propiedad y devuelve la tabla. La conexión está activa.
El plan gratuito incluye 100 tareas al mes. Pro desde $99 al mes, Team desde $249.
Prompts de GA4 para probar en Claude Code
Cada prompt de abajo corresponde a herramientas del grupo GA4 de PaidSync. Claude Code elige la herramienta. La última columna indica si la llamada puede cambiar algo en la propiedad.
| Petición | Herramientas que llama | Cambia tu cuenta |
|---|---|---|
| “Lista mis propiedades de GA4 y sus flujos de datos” | list_ga4_properties, list_ga4_data_streams | No |
| “Sesiones y conversiones por fuente y medio, últimos 28 días” | run_ga4_report | No |
| “¿Se está disparando ahora mismo el evento de compra?” | run_ga4_realtime_report | No |
| “¿Qué eventos clave están configurados y está vinculado Google Ads?” | list_ga4_conversion_events, list_ga4_google_ads_links | No |
| “¿Qué eventos de medición mejorada están activados en el flujo web?” | get_ga4_enhanced_measurement | No |
| “Marca generate_lead como evento clave” | create_ga4_conversion_event | Sí, después de que confirmes |
| “Añade una dimensión personalizada para el parámetro de evento plan_tier” | create_ga4_custom_dimension | Sí, después de que confirmes |
| “Vincula la cuenta de Google Ads 123-456-7890 a esta propiedad” | create_ga4_google_ads_link | Sí, después de que confirmes |
Ejecútalo en modo headless con claude -p
El indicador -p ejecuta Claude Code sin la sesión interactiva. Inicia sesión una vez con /mcp y el token de OAuth guardado se mantiene. Un informe que termina en un archivo se ve así:
claude -p "Run a GA4 report for the last 7 days of sessions and key events by source and medium, and flag any source whose key events dropped against the week before." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/ga4-$(date +%F).jsonLas lecturas se ejecutan directamente, y las escrituras también. --allowedTools "mcp__paidsync" permite todas las herramientas de PaidSync, escrituras incluidas, sin aviso.
Para un trabajo desatendido, permite solo las herramientas de lectura que necesite, cada una por nombre como mcp__paidsync__tool_name.
Qué lee y qué escribe
De las 26 herramientas de GA4, 11 solo leen y 13 pueden escribir.
Leer más
Las lecturas e informes cubren propiedades, flujos de datos, eventos clave, dimensiones y métricas personalizadas, audiencias, vínculos con Google Ads, medición mejorada, informes personalizados mediante run_ga4_report y los últimos 30 minutos mediante run_ga4_realtime_report.
Las escrituras cambian la configuración de la propiedad: propiedades, flujos de datos, eventos clave, dimensiones y métricas personalizadas, audiencias, medición mejorada y vínculos con Google Ads. Ninguna escritura de GA4 tiene simulación. Cada una se aplica en la primera llamada, así que lee los argumentos en la solicitud de Claude Code antes de permitirla. Las eliminaciones requieren confirm_destructive.
Con MCP, el paso de aprobación es el propio aviso de Claude Code. Pregunta antes de ejecutar una herramienta, salvo que la hayas permitido con --allowedTools o en tus ajustes. PaidSync añade comprobaciones por su parte. Las eliminaciones, pausas y cambios de presupuesto requieren confirm_destructive, y una comprobación de reglas previa a la escritura bloquea los argumentos inseguros. La tarjeta de aprobación, y Undo en una tarjeta aplicada cuyo cambio tiene una inversa segura, solo se aplican en el espacio de trabajo de PaidSync.
Añadir a ChatGPT: abre PaidSync.ai en el directorio de plugins de ChatGPT, instálalo e inicia sesión.
Añadir a Claude: abre PaidSync.ai en el directorio de conectores de Claude, haz clic en Conectar e inicia sesión.
Límites a conocer
- Un evento debe estar ya disparándose en tu flujo de datos antes de que
create_ga4_conversion_eventpueda marcarlo como evento clave. - Las herramientas de GA4 no colocan etiquetas en tu sitio web. Las etiquetas viven en Google Tag Manager, que tiene su propia configuración para Claude Code.
setup_ga4_eventcrea una etiqueta de evento de GA4 en un espacio de trabajo de GTM, así que también necesita GTM conectado. - Eliminar un evento clave con
delete_ga4_conversion_eventhace que deje de contar como evento clave. GA4 sigue recopilando el propio evento. - El informe en tiempo real cubre solo los últimos 30 minutos. Usa
run_ga4_reportpara cualquier dato anterior.
Preguntas frecuentes
Cómo conectar GA4 a Claude Code
Regístrate en paidsync.ai, conecta Google Analytics 4 en el panel con tu inicio de sesión de Google y luego ejecuta claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp en tu terminal. Escribe /mcp dentro de una sesión, elige paidsync e inicia sesión con tu cuenta de PaidSync.
¿Puede Claude Code cambiar mi configuración de GA4?
Sí. Claude Code puede marcar eventos clave, añadir dimensiones y métricas personalizadas, crear audiencias, cambiar la medición mejorada y vincular Google Ads. Las escrituras en GA4 no tienen simulación y se aplican en la primera llamada, así que la solicitud de Claude Code es tu control. Las eliminaciones requieren una confirmación explícita.
¿Puede Claude Code comprobar si el seguimiento funciona?
Sí. run_ga4_realtime_report muestra los últimos 30 minutos, así que puedes disparar un evento de prueba en tu sitio y preguntar a Claude Code si llegó.
¿Funciona en modo headless con claude -p?
Sí. Una vez que has iniciado sesión con /mcp, claude -p reutiliza el token de OAuth guardado. Las lecturas se ejecutan directamente. Las escrituras requieren cuidado. No hay nadie para responder al aviso de Claude Code, así que cualquier herramienta de escritura que hayas permitido con --allowedTools se ejecuta directamente. Para un trabajo desatendido, permite solo las herramientas de lectura que necesite.
Es gratis
Sí. El plan gratuito cuesta $0 por 100 tareas al mes, sin tarjeta. Pro empieza en $99 al mes y Team en $249 al mes.
26 herramientas de GA4. Un comando en Claude Code.