Inicio › SEO e IA › Cómo conectar Google Analytics 4 (GA4) a Claude: guía paso a paso
Analiza tu tráfico, tus fuentes y tus conversiones en lenguaje natural, directamente en Claude. Sin exportar, sin tablas cruzadas, sin programar.
Conectar tu Google Analytics 4 (GA4) a Claude se hace en cuatro pasos: crear un proyecto de Google Cloud, activar las API de Analytics, generar un identificador OAuth y, por último, conectar el servidor a Claude. Te llevará 15 minutos. Solo tienes que hacerlo una vez y es gratis.
Los datos de GA4, en modo conversación
Al estar conectado a Claude, tu Google Analytics se lee en lenguaje natural. Solo tienes que hacer tu pregunta y Claude te muestra tus sesiones, tus fuentes y tus conversiones ya agregadas, sin necesidad de exportarlas ni de crear una exploración.
Antes teníamos que abrir GA4, elegir el informe adecuado, crear una exploración, cruzar dos dimensiones sin estropearlo todo y, después, exportar los datos para poder, por fin, ver una cifra. Ya sabes, esa interfaz que te hace suspirar… ¡Pues se acabó!
Ahí escribes una frase: «Muéstrame mis sesiones de los últimos 30 días por fuente». La respuesta aparece en Claude, ya procesada. Sigues con: «¿De dónde proceden mis conversiones?», «Compáralas con las del año pasado», «¿Qué páginas atraen a más visitantes?».
Son tus datos de GA4, en modo «discusión». Los utilizo antes de cada reunión con el cliente y ya no voy a volver atrás. Pero hay que saber qué hay que fijarse: primero establece un plan de medición claro de los KPI que quieres seguir antes de lanzarte a analizar las cifras.
Para que la magia surta efecto, Claude solo tiene que consultar tu Google Analytics. Eso es todo lo que explica esta guía. Y se limita a la lectura: consulta tus cifras, no publica nada, no borra nada ni modifica ningún ajuste.
¿Por qué hay que vincular tu propia cuenta de Google a Claude?
En lugar de una «cuenta de servicio» (un bot que invitas a tus herramientas), se accede directamente a través de tu cuenta de Google. De hecho, es lo que recomienda Google para su propia herramienta Analytics, y la forma más sencilla de mantenerla a largo plazo. Claude ve lo mismo que tú en GA4, ni más ni menos.
Google Analytics 4 es la herramienta que mide quién visita tu página web y qué hacen en ella. Al estar conectada a Claude, puedes explorarla en lenguaje natural, sin tablas cruzadas.
Lo que hay que instalar antes de empezar
Dos herramientas gratuitas que hay que instalar una sola vez para conectar Claude y GA4: pipx y la CLI de gcloud.
La guía paso a paso que aparece a continuación utiliza Claude Code en Mac, la versión de Claude que se ejecuta en el Terminal. En Windows o en Claude Desktop, toda la parte relacionada con Google es idéntica: ve a la sección «¿Sin Terminal?» o «¿En Windows?» para la configuración.
En Mac, hay dos pequeñas herramientas que debes instalar si aún no las tienes. Abre la aplicación «Terminal» y pega estas líneas una por una:
# Homebrew, le gestionnaire d'installation du Mac (saute si tu l'as déjà)
# instructions sur https://brew.sh
brew install pipx # pour faire tourner le serveur Analytics
brew install --cask gcloud-cli # l'outil de connexion GoogleEso es todo en cuanto a la interfaz gráfica. El resto se hace en el navegador y en el Terminal, pantalla a pantalla.
Paso 1: preparar el proyecto de Google Cloud
Crea un proyecto gratuito de Google Cloud y, a continuación, activa las dos API de Analytics. Ese es el espacio y las vías por las que Claude accederá a tus datos. No hay que pagar nada ni hay ningún riesgo. Te lo explico:
Crea el proyecto de Google Cloud
Entra en console.cloud.google.com e inicia sesión con la cuenta de Google que tiene acceso a tu Analytics. Este es el punto más importante de la guía: esa cuenta, y ninguna otra.
Si Google te propone crear un proyecto, acéptalo. El nombre no tiene ninguna importancia. Si ya tienes un proyecto, puedes volver a utilizarlo. No pierdas de vista elID del proyecto que aparece en la página de inicio, algo así como mon-projet-123, lo necesitaremos al final.
Activa las dos API de Analytics
Una API es una puerta a través de la cual dos programas se comunican entre sí. Por defecto, están cerradas. En la barra de búsqueda situada en la parte superior de la consola, busca y activa estas dos, una por una, con el botón azul «Activar »:
- API de datos de Google Analytics (tus cifras)
- API de administración de Google Analytics (la lista de tus propiedades)
Paso 2: crear la clave de conexión (OAuth)
Genera un identificador OAuth: el permiso que autoriza a Claude a consultar tu Analytics en tu nombre. Se hace en dos pasos y hay que descargar un archivo.
Configura la pantalla de autorización de OAuth
En el menú de la izquierda, ve a «Google Auth Platform» (o busca «OAuth» en la barra superior). Configúralo así:
- Tipo de usuario: Externo.
- Deja el estado en «Prueba», es perfecto para uso personal.
- En «Usuarios de prueba», haz clic en «Añadir usuarios» e introduce tu propia dirección de Gmail, la del paso 1.
¿Para qué sirve registrarse como usuario de prueba?
Mientras tu aplicación esté en modo de prueba, solo las direcciones que aparecen aquí tienen permiso para utilizarla. Al añadirte, te autorizas a ti mismo. Esto también te permitirá pasar sin problemas la pantalla «aplicación no validada» en el paso 3.
Crea el cliente OAuth y recupera la clave
Sin salir de Google Auth Platform, ve a «Clientes» y, a continuación, a «Crear un cliente »:
- Tipo de aplicación: Aplicación de escritorio.
- Ponle un nombre que signifique algo, por ejemplo
Claude Analytics. - Haz clic en «Crear» y, a continuación, en «Descargar en formato JSON».
Este pequeño archivo .json, esa es tu clave. Guárdala en una carpeta discreta y fácil de encontrar. Te propongo esta ruta, que volveremos a utilizar tal cual:
# crée le dossier puis dépose ton fichier dedans, renommé proprement
mkdir -p ~/.config/google-mcp
mv ~/Downloads/client_secret_*.json ~/.config/google-mcp/oauth-client.jsonEste archivo es una contraseña
Nunca lo envíes por correo electrónico, no lo publiques en Discord ni lo guardes en una carpeta compartida. Da acceso a tus datos: guárdalo en tu ordenador y ya está.
Paso 3: conectar Claude a Analytics
Dos comandos en el Terminal: uno para iniciar sesión en Google y otro para conectar el servidor a Claude. Copias, pegas y confirmas. ¡No tiene ningún misterio!
Inicia sesión con la cuenta de Google correcta
Pega este comando en el Terminal. Ocupa varias líneas, así que copia todo el bloque de una vez:
gcloud auth application-default login \
--client-id-file=$HOME/.config/google-mcp/oauth-client.json \
--scopes=openid,\
https://www.googleapis.com/auth/cloud-platform,\
https://www.googleapis.com/auth/analytics.readonlySe abre una ventana del navegador. Sigue estos pasos:
- Elige tu cuenta de Google, la del paso 1.
- Aparece un mensaje que dice «Google no ha validado esta aplicación»: es normal, la aplicación la has creado tú. Haz clic en «Configuración avanzada» y, a continuación, en «Acceder a Claude Analytics (no seguro)».
- Autoriza el acceso de lectura.
De vuelta en la Terminal, deberías ver Credentials saved to file. Ya está, tu conexión queda registrada.
Conecta el servidor de Analytics
Sin salir del Terminal, pega este comando. Sustituye TON-ID-PROJET mediante el ID anotado en el paso 1:
claude mcp add --scope user google-analytics \
-e GOOGLE_PROJECT_ID=TON-ID-PROJET \
-- pipx run analytics-mcpA continuación, cierra y vuelve a abrir Claude Code. La nueva herramienta solo aparece al reiniciar, y eso es lo que confunde a todo el mundo.
¿Cómo se conecta Claude a GA4 sin Terminal o en Windows?
Para conectar Google Analytics 4 a Claude sin Terminal, la configuración por parte de Google (proyecto en la nube, API, identificador de OAuth) es la misma en todos los sistemas. Lo único que cambia es la forma de conectar el servidor. El inicio de sesión en tu cuenta, el comando gcloud auth del paso 3, pasa de todos modos una vez por el Terminal en Mac o por PowerShell en Windows.
En Claude Desktop (Mac o Windows), no escribas claude mcp add. Añade el servidor en la configuración: en la aplicación, Ajustes → Desarrollador → Editar configuración, luego pega este bloque y guarda:
{
"mcpServers": {
"google-analytics": {
"command": "pipx",
"args": ["run", "analytics-mcp"],
"env": {
"GOOGLE_PROJECT_ID": "TON-ID-PROJET"
}
}
}
}Cierra y vuelve a abrir Claude Desktop. En Windows, instala Python (con pipx) y la CLI de gcloud desde sus páginas web oficiales, en lugar de hacerlo a través de Homebrew; el comando gcloud auth del paso 3 sigue siendo el mismo en PowerShell.
Si el Terminal te echa para atrás
Hay servicios de terceros (Supermetrics, Porter, Windsor.ai) que conectan tu Analytics a Claude con un solo clic, sin necesidad de usar la línea de comandos. La desventaja es que son de pago y que tus datos pasan por sus servidores antes de llegar a Claude. Para un uso personal y gratuito, el método anterior sigue siendo el más limpio.
Paso 4: comprobar la conexión con Claude y consultar GA4
Comprueba que el servidor muestre «Connected» y, a continuación, formula tus preguntas en lenguaje natural. Lo más difícil ya está hecho.
Comprueba la conexión entre Claude y GA4
En el Terminal, escribe claude mcp list : tu servidor google-analytics debe mostrar ✓ Connected. A continuación, en Claude, ponte manos a la obra:
- «Lista de mis propiedades de Google Analytics».
- «Mis sesiones de los últimos 30 días por fuente y dispositivo.»
- «Compara mis conversiones de este mes con las del mes pasado.»
- «¿Qué páginas generan más tráfico orgánico?»
Si las cifras suben, ¡está de moda!
Preguntas frecuentes sobre la conexión entre GA4 y Claude
Hay dos errores recurrentes: «ninguna propiedad» cuando Claude está conectado a una cuenta de Google incorrecta, y «invalid_grant» cuando la sesión ha caducado. Ambos se solucionan volviendo a ejecutar el comando de conexión del paso 3.
Claude no ve ninguna propiedad GA4, ¿qué se puede hacer?
En la mayoría de los casos, el inicio de sesión se ha realizado con una cuenta de Google incorrecta. Vuelve a intentar el proceso de inicio de sesión del paso 3 y elige la cuenta que realmente tenga acceso a tu Analytics.
¿Por qué caduca la sesión de GA4 al cabo de unos días en Claude?
En el modo de prueba, el token de acceso caduca al cabo de aproximadamente una semana y Claude muestra el mensaje «invalid_grant». Vuelve a ejecutar el comando de conexión del paso 3. Para no tener que volver a preocuparte por ello, cambia tu aplicación al modo «Producción» en Google Auth Platform.
Conectar Search Console a Claude
La configuración de Search Console sigue la misma lógica: el mismo proyecto de Google Cloud, pero con una API y un ámbito diferentes. Te he preparado la guía complementaria: Cómo conectar Google Search Console a Claude. Para conectarlos los dos a la vez, añade el osciloscopio webmasters.readonly en el comando de conexión del paso 3.
