--- title: "MCP de Google Analytics 1.0: qué hace y cómo conectarlo a GA4" description: "El servidor MCP oficial de Google Analytics pasó a versión estable. Qué informes permite, cómo instalarlo con Claude o Cursor y por qué empezar en solo lectura." url: "https://cookingmetrics.com/es/blog/mcp-google-analytics-ga4/" markdown_url: "https://cookingmetrics.com/es/blog/mcp-google-analytics-ga4.md" lang: "es" date_published: "2026-11-12" author: "Martín Garay" author_url: "https://cookingmetrics.com/es/quien-es-martin-garay/" publisher: "CookingMetrics" publisher_url: "https://cookingmetrics.com/es/" keywords: ["MCP", "Google Analytics"] citation_apa7: "Garay, M. (2026, 12 de noviembre). *MCP de Google Analytics 1.0: qué hace y cómo conectarlo a GA4*. CookingMetrics. https://cookingmetrics.com/es/blog/mcp-google-analytics-ga4/" references_apa7: - "Google Analytics, GitHub. (s. f.). *Google Analytics MCP server*. https://github.com/googleanalytics/google-analytics-mcp" - "Google Analytics, GitHub. (s. f.). *Google Analytics MCP server: releases*. https://github.com/googleanalytics/google-analytics-mcp/releases" - "Google for Developers. (s. f.). *Google Analytics MCP server*. https://developers.google.com/analytics/devguides/MCP" - "Google Cloud. (s. f.). *Set up ADC for a local development environment*. https://docs.cloud.google.com/docs/authentication/set-up-adc-local-dev-environment" - "Python Packaging Authority. (s. f.). *pipx documentation*. https://pipx.pypa.io/" - "Google Analytics for Developers. (s. f.). *Google Analytics Data API basics*. https://developers.google.com/analytics/devguides/reporting/data/v1/basics" - "Google Analytics for Developers. (s. f.). *Google Analytics Data API schema*. https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema" --- # MCP de Google Analytics 1.0: qué hace y cómo conectarlo a GA4 > El servidor MCP oficial de Google Analytics pasó a versión estable. Qué informes permite, cómo instalarlo con Claude o Cursor y por qué empezar en solo lectura. - **Autor:** [Martín Garay](https://cookingmetrics.com/es/quien-es-martin-garay/) · Fundador de CookingMetrics - **Publicado:** 12 de noviembre de 2026 - **Temas:** MCP, Google Analytics - **Versión web:** https://cookingmetrics.com/es/blog/mcp-google-analytics-ga4/ ## Cómo citar este artículo (APA, 7.ª edición) Garay, M. (2026, 12 de noviembre). *MCP de Google Analytics 1.0: qué hace y cómo conectarlo a GA4*. CookingMetrics. https://cookingmetrics.com/es/blog/mcp-google-analytics-ga4/ Cita en el texto: (Garay, 2026) ## Referencias - Google Analytics, GitHub. (s. f.). *Google Analytics MCP server*. https://github.com/googleanalytics/google-analytics-mcp Cita en el texto: (Google Analytics, GitHub, s. f.) - Google Analytics, GitHub. (s. f.). *Google Analytics MCP server: releases*. https://github.com/googleanalytics/google-analytics-mcp/releases Cita en el texto: (Google Analytics, GitHub, s. f.) - Google for Developers. (s. f.). *Google Analytics MCP server*. https://developers.google.com/analytics/devguides/MCP Cita en el texto: (Google for Developers, s. f.) - Google Cloud. (s. f.). *Set up ADC for a local development environment*. https://docs.cloud.google.com/docs/authentication/set-up-adc-local-dev-environment Cita en el texto: (Google Cloud, s. f.) - Python Packaging Authority. (s. f.). *pipx documentation*. https://pipx.pypa.io/ Cita en el texto: (Python Packaging Authority, s. f.) - Google Analytics for Developers. (s. f.). *Google Analytics Data API basics*. https://developers.google.com/analytics/devguides/reporting/data/v1/basics Cita en el texto: (Google Analytics for Developers, s. f.) - Google Analytics for Developers. (s. f.). *Google Analytics Data API schema*. https://developers.google.com/analytics/devguides/reporting/data/v1/api-schema Cita en el texto: (Google Analytics for Developers, s. f.) --- **El servidor MCP de Google Analytics es la vía oficial para que un asistente de IA, como Claude o Cursor, consulte los datos de una propiedad de GA4 mediante las API de Google.** El 3 de noviembre de 2026, Google publicó la versión 1.0.0 y el proyecto dejó la etapa experimental. Tres días después llegó la 1.1.0, que suma la creación opcional de eventos clave y dimensiones personalizadas. Este artículo explica qué herramientas incluye, cómo instalarlo paso a paso y qué precauciones conviene tomar antes de habilitar la escritura. Lo que se afirma sobre el funcionamiento del servidor proviene del [repositorio oficial en GitHub](https://github.com/googleanalytics/google-analytics-mcp) y de la [documentación de Google for Developers](https://developers.google.com/analytics/devguides/MCP?hl=es-419), consultados el 11 de noviembre de 2026. ## En síntesis - Con la 1.0.0 (3/11/2026), el proyecto dejó de ser experimental. La versión vigente al 11/11/2026 es la 1.1.0. - Ofrece cuatro informes (estándar, tiempo real, embudos y conversiones) y lecturas de configuración: cuentas, propiedad, eventos clave, dimensiones y métricas personalizadas, vínculos con Google Ads y anotaciones. - Cada respuesta de un informe admite hasta 250.000 filas; para volúmenes mayores se pagina. - Viene en solo lectura. Crear anotaciones, eventos clave o dimensiones personalizadas exige activar `--allow-write`, sumar el alcance `analytics.edit` y tener el rol adecuado en la propiedad. - Requiere un proyecto de Google Cloud con dos API habilitadas, credenciales y Python 3.10 o superior. ## Qué es un servidor MCP y qué cambia con la versión 1.0 MCP (*Model Context Protocol*) es un protocolo abierto que permite a un asistente de IA usar herramientas externas. Un servidor MCP expone esas herramientas con un nombre, una descripción y sus parámetros, y el asistente decide cuándo llamarlas. En este caso, las herramientas consultan la Google Analytics Data API y la Google Analytics Admin API con las credenciales del usuario. En la práctica, en lugar de armar un informe en la interfaz o escribir código contra la API, se le hace la pregunta al asistente, que traduce el pedido en una consulta, la ejecuta y devuelve el resultado. El proyecto se publicó como experimento en agosto de 2025 (versión 0.1.0). La versión 1.0.0, del 3 de noviembre de 2026, lo declara estable, según la [lista de versiones del repositorio](https://github.com/googleanalytics/google-analytics-mcp/releases). La 1.1.0, del 6 de noviembre, agregó rangos por minuto en tiempo real y las herramientas opcionales de escritura de dimensiones personalizadas y eventos clave. ## Qué puede hacer hoy ### Informes - **Informe estándar (`run_report`).** Dimensiones, métricas, filtros, orden y rangos de fechas. Cada respuesta admite hasta 250.000 filas y se puede paginar. - **Tiempo real (`run_realtime_report`).** Los últimos 30 minutos, o hasta dos rangos por minuto dentro de esa ventana. Sirve para comprobar que una campaña recién activada o una etiqueta corregida ya envía datos. - **Embudos (`run_funnel_report`).** Pasos definidos por el usuario, desglose por una dimensión, segmentos y análisis de la «próxima acción»: qué hacen las personas después de completar o abandonar el embudo. Usa la versión alfa de la Data API, por lo que puede cambiar. - **Conversiones (`run_conversions_report`).** Costos de anuncios, conversiones, retorno de la inversión publicitaria (ROAS) y modelo de atribución, basado en datos (`DATA_DRIVEN`) o último clic (`LAST_CLICK`). [Sección para lectores con cuenta, nivel C: https://cookingmetrics.com/es/blog/mcp-google-analytics-ga4/#bloque-1] ### Auditoría de la configuración - Resumen de las cuentas y propiedades a las que tiene acceso la credencial. - Detalles de una propiedad. - Lista de eventos clave. - Dimensiones y métricas personalizadas. - Cuentas de Google Ads vinculadas. - Anotaciones de la propiedad. Para una auditoría, esta parte resulta tan útil como los informes: permite preguntar, por ejemplo, qué eventos están marcados como clave y si alguno no registró actividad en los últimos 30 días. [Sección para lectores con cuenta, nivel C: https://cookingmetrics.com/es/blog/mcp-google-analytics-ga4/#bloque-2] ### Configuración (solo con la escritura activada) - Crear anotaciones en la línea de tiempo de la propiedad. - Crear dimensiones personalizadas (requiere el rol Editor). - Marcar un evento como evento clave (requiere el rol Marketer o Editor). Estas tres herramientas no aparecen si el servidor no se inicia con la escritura activada. ## Requisitos previos - Un proyecto de Google Cloud. - La Google Analytics Admin API y la Google Analytics Data API habilitadas en ese proyecto. - Acceso a la propiedad con, al menos, el rol Lector. - Credenciales con el alcance `https://www.googleapis.com/auth/analytics.readonly`. Para escribir, también `https://www.googleapis.com/auth/analytics.edit`. - Python 3.10 o superior y `pipx` (o `uv`) para ejecutar el paquete `analytics-mcp`. ## Cómo instalarlo paso a paso 1. **Habilitar las API.** Desde la consola de Google Cloud o con la CLI de Google Cloud: ``` gcloud services enable analyticsadmin.googleapis.com analyticsdata.googleapis.com --project=ID_DEL_PROYECTO ``` 2. **Configurar las credenciales.** La opción más directa son las credenciales predeterminadas de la aplicación (ADC): ``` gcloud auth application-default login --scopes="https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform" ``` El comando informa la ruta del archivo de credenciales que genera. Como alternativa, se puede usar una cuenta de servicio, por suplantación o con un archivo de clave, que recibe acceso a la propiedad como cualquier usuario. 3. **Agregar el servidor al asistente.** En Claude Code: ``` claude mcp add analytics-mcp --scope user -e GOOGLE_APPLICATION_CREDENTIALS="RUTA_AL_ARCHIVO_JSON" -e GOOGLE_CLOUD_PROJECT="ID_DEL_PROYECTO" -- pipx run analytics-mcp ``` En Claude Desktop, Cursor u otros clientes compatibles, la configuración equivalente en formato JSON es: ``` { "mcpServers": { "analytics-mcp": { "command": "pipx", "args": ["run", "analytics-mcp"], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "RUTA_AL_ARCHIVO_JSON", "GOOGLE_CLOUD_PROJECT": "ID_DEL_PROYECTO" } } } } ``` 4. **Comprobar la conexión.** Reiniciar el cliente y pedir algo de bajo riesgo, por ejemplo: «¿A qué cuentas y propiedades de Google Analytics tengo acceso?». Si la respuesta lista las propiedades esperadas, la conexión funciona. El repositorio documenta además la ejecución como servidor HTTP propio, incluso en Cloud Run, con OAuth integrado. Google no ofrece un servidor alojado: cada equipo ejecuta el suyo. [Sección para lectores con cuenta, nivel C: https://cookingmetrics.com/es/blog/mcp-google-analytics-ga4/#bloque-3] ## Prompts para empezar - «Compare sesiones y eventos clave de Meta contra Google Ads en los últimos 30 días, frente al período anterior.» El resultado depende de cómo esté etiquetado el tráfico de Meta: sin parámetros UTM consistentes, parte de ese tráfico puede aparecer como referencia o como directo. - «Muestre el embudo de compra solo del tráfico pago. ¿En qué paso se pierden más personas y qué hacen después?» El asistente debe definir un segmento de tráfico pago; conviene pedirle que indique qué condición usó. - «¿Está llegando en tiempo real el tráfico de la campaña que se activó hoy?» - «Agregue una anotación con la fecha de hoy: se cambió la estrategia de puja a ROAS objetivo.» Solo funciona con la escritura activada. En cualquier caso, conviene pedir al asistente que muestre las dimensiones, métricas, filtros y fechas que usó. Un informe correcto con una definición equivocada sigue siendo un error. [Sección para lectores con cuenta, nivel C: https://cookingmetrics.com/es/blog/mcp-google-analytics-ga4/#bloque-4] ## Por qué empezar en solo lectura La escritura se activa a propósito, con la opción `--allow-write` o la variable de entorno `ANALYTICS_MCP_ALLOW_WRITE`, y además exige el alcance `analytics.edit`. Mantenerla desactivada al principio tiene tres ventajas: - **Límite de daño.** Un pedido ambiguo no puede crear eventos clave ni dimensiones. Un evento clave cambia lo que se cuenta como conversión en los informes y, si la propiedad está vinculada, lo que puede llegar a Google Ads. - **Cupos limitados.** Las propiedades tienen un número máximo de dimensiones personalizadas. Crear una de prueba consume un lugar. - **Proceso.** Antes de delegar cambios en un asistente, el equipo necesita definir quién los aprueba y cómo se registran. Cuando la escritura sea necesaria, conviene usar una credencial distinta, limitada a las propiedades que corresponda, y empezar por las anotaciones, que no alteran los datos. [Sección para lectores con cuenta, nivel C: https://cookingmetrics.com/es/blog/mcp-google-analytics-ga4/#bloque-5] ## Límites que conviene conocer - **Documentación desalineada.** Al 11 de noviembre de 2026, la página de Google for Developers indica que el servidor está disponible solo para lectura y lista nueve herramientas; el repositorio, en la versión 1.1.0, incluye trece, tres de ellas de escritura opcional. - **Funciones en versión alfa.** Los embudos y las anotaciones usan versiones alfa de las API de Google, que pueden cambiar. - **Cuotas.** Las consultas consumen la cuota de la Data API del proyecto. Muchas preguntas encadenadas sobre rangos amplios pueden agotarla. - **Interpretación.** El servidor devuelve datos; la conclusión la arma el asistente. Las cifras deben verificarse antes de usarlas en una decisión o en un informe para un cliente. Las respuestas del asistente valen tanto como la configuración de la propiedad. Si los eventos, las conversiones o la atribución de campañas no están bien definidos, el [autodiagnóstico de Google Analytics de CookingMetrics](https://cookingmetrics.com/es/google-analytics-autodiagnostico/) ayuda a revisarlos antes de confiar en una consulta automática. ## Lecturas relacionadas - [MCP para Google Ads: conexión, eCommerce y leads B2B](https://cookingmetrics.com/es/blog/mcp-google-ads/), el servidor equivalente para la cuenta publicitaria. - [Qué aprendimos al revisar nuestro sitio para agentes de IA](https://cookingmetrics.com/es/blog/medimos-nuestro-sitio-agent-ready/), sobre cómo se preparó [CookingMetrics](https://cookingmetrics.com/es/) para los agentes. ## Preguntas frecuentes ### ¿El MCP de Google Analytics modifica la propiedad? No, salvo que se active la escritura de forma explícita. Por defecto solo consulta informes y configuración. Con `--allow-write` y el alcance `analytics.edit` puede crear anotaciones, eventos clave y dimensiones personalizadas, según el rol de la credencial en la propiedad. ### ¿Hace falta saber programar para usarlo? Para consultarlo, no: las preguntas se hacen en lenguaje natural. La instalación sí requiere trabajar con la consola de Google Cloud, la línea de comandos y el archivo de configuración del cliente de IA. ### ¿Google ofrece un servidor alojado? No. El servidor se ejecuta en el equipo del usuario o en una infraestructura propia, como Cloud Run. El repositorio documenta las dos opciones. --- ## Sobre el autor **[Martín Garay](https://cookingmetrics.com/es/quien-es-martin-garay/)** — Fundador de CookingMetrics Soy Martín Garay, fundador y Martech Advisor de CookingMetrics y director de la Comisión de Tecnología de la Cámara Argentina de Comercio Electrónico (CACE). Hace más de 20 años trabajo en Analytics, desarrollo, SEO técnico y ecommerce: implemento la medición, encuentro dónde falla y la convierto en información útil para decidir. ### En qué puedo ayudarle - **Google Analytics y medición**: Reviso compras, ingresos, campañas y eventos en Google Analytics y Google Tag Manager. Explico qué datos son confiables, qué hay que corregir y cómo comprobar que la corrección funcionó. - **SEO técnico**: Reviso rastreo, indexación, arquitectura y rendimiento, sobre todo antes y después de los cambios o migraciones que pueden afectar la visibilidad del sitio. - **SEO para búsquedas con IA**: Trabajo la base técnica y el contenido que buscadores y asistentes de IA necesitan para encontrar y comprender una marca, condición previa para que la citen. [Qué es GEO y cómo se relaciona con la búsqueda generativa](https://cookingmetrics.com/es/blog/que-es-geo-generative-engine-optimization/). ### Mi trabajo en la Cámara Argentina de Comercio Electrónico - **Director de la Comisión de Tecnología** (DESDE AGOSTO DE 2025): Coordino la agenda de la comisión junto a Gabriel Topola, subdirector. Analizamos las plataformas y herramientas que necesita un negocio online para crecer: CMS, integraciones, atención al cliente y gestión omnicanal. - **Curaduría del foro técnico** (IT CAMP · ECOMMERCE DAY ARGENTINA): Con el equipo de Eventos de CACE armo la programación del IT Camp: charlas para equipos de sistemas y desarrollo sobre arquitectura de plataformas, código y buenas prácticas, con oradores que trabajan en la implementación. - **Comisiones de Marketing y Data Analytics** (DESDE 2016): Empecé en la comisión de Marketing y ayudé a crear la de Data Analytics. Di webinars de Google Analytics, incluida la migración a GA4, y colaboré en la implementación de Google Analytics para Hot Sale y Cyber Monday. - **Dashboard de métricas para ecommerce** (PARA LOS SOCIOS): Con la comisión de Data Analytics y el equipo de Comunidad CACE desarrollamos un tablero en Google Analytics y Looker Studio para que cada socio consulte los indicadores clave de su propia tienda. ### Ponencias - [De SEO a GEO: qué hace falta para que una marca sea citada por un motor de respuestas](https://www.youtube.com/watch?v=mlyjuSBdMzI) — ECOMMERCE DAY ARGENTINA 2026 · IT CAMP · 27 DE AGOSTO DE 2026 · CENTRO DE CONVENCIONES BUENOS AIRES - [SEO para IA: cómo preparar una marca para aparecer en ChatGPT y en los resúmenes con IA de Google](https://www.youtube.com/watch?v=4dI7jqnLg-M) — AI IN LATAM 2025 · BUENOS AIRES · MÁS DE 3.500 ASISTENTES Y 100 ORADORES, SEGÚN LA ORGANIZACIÓN ### Perfiles y enlaces - [Perfil completo](https://cookingmetrics.com/es/quien-es-martin-garay/) - [LinkedIn](https://www.linkedin.com/in/seospecialistmartingaray/) - [Instagram](https://www.instagram.com/garaymartin/) - [YouTube](https://www.youtube.com/@MartinGaray) - [martingaray.com.ar](https://www.martingaray.com.ar/) - [Director de la Comisión de Tecnología de CACE](https://cace.org.ar/pages/comision-de-tecnologia?utm_source=cookingmetrics.com&utm_medium=referral&utm_campaign=perfil-martin&utm_content=caja-autor) - [Dashboard de métricas para ecommerce, gratis para socios de CACE](https://cace.org.ar/pages/dashboard-de-metricas?utm_source=cookingmetrics.com&utm_medium=referral&utm_campaign=perfil-martin&utm_content=caja-autor) --- ## Sobre CookingMetrics CookingMetrics ofrece consultoría de Google Analytics, implementación de medición y SEO. Su fundador, Martín Garay, aporta más de 20 años de experiencia en Analytics, desarrollo y ecommerce. El trabajo conecta los datos con las decisiones del negocio. ### Servicios - **[Auditoría de Google Analytics](https://cookingmetrics.com/es/servicios/auditoria-ga4/)**: ¿Las compras o los ingresos no coinciden con su tienda? Revisamos la medición y le entregamos un plan de corrección en 10 días hábiles. [Conozca el alcance de la auditoría](https://cookingmetrics.com/es/servicios/auditoria-ga4/). - **[Google Tag Manager](https://cookingmetrics.com/es/servicios/gtm/)**: ¿Dejaron de medirse eventos después de cambiar la web? Revisamos etiquetas, activadores y versiones para encontrar duplicaciones o faltantes. [Consulte por auditoría e implementación de Google Tag Manager](https://cookingmetrics.com/es/servicios/gtm/). - **[Medición del lado del servidor](https://cookingmetrics.com/es/servicios/medicion-cookieless/)**: Evaluamos cómo enviar datos desde su servidor, respetar el consentimiento y evitar duplicaciones. [Qué incluye la medición server-side](https://cookingmetrics.com/es/servicios/medicion-cookieless/). - **[SEO técnico](https://cookingmetrics.com/es/servicios/seo-tecnico/)**: ¿Migró el sitio o hay páginas que no aparecen en Google? Revisamos rastreo, indexación, estructura y rendimiento. [Cómo trabajamos el SEO técnico](https://cookingmetrics.com/es/servicios/seo-tecnico/). - **[SEO para búsquedas con IA (GEO)](https://cookingmetrics.com/es/servicios/seo-ai-geo/)**: Revisamos si buscadores y asistentes pueden acceder a sus páginas y comprender su contenido. [Qué podemos mejorar para la búsqueda con IA](https://cookingmetrics.com/es/servicios/seo-ai-geo/). ### Soluciones - **[Autodiagnóstico de Google Analytics](https://cookingmetrics.com/es/google-analytics-autodiagnostico/)** (Estado: Disponible) - **[GA4 Report Generator](https://cookingmetrics.com/es/producto/ga4-report-generator/)** (Estado: Beta): Herramienta en beta que ya permite generar informes de Google Analytics. Consulte las funciones disponibles y el alcance para su proyecto. [Conozca GA4 Report Generator](https://cookingmetrics.com/es/producto/ga4-report-generator/). - **[IndexNow Connect](https://cookingmetrics.com/es/producto/indexnow-connect/)** (Estado: Disponible para Tiendanube): Comunica URLs nuevas, actualizadas o eliminadas a los buscadores que participan en IndexNow. [Cómo funciona IndexNow Connect](https://cookingmetrics.com/es/producto/indexnow-connect/). - **[Análisis SEO IA](https://cookingmetrics.com/es/producto/ai-seo-analysis/)** (Estado: En desarrollo): *Próximamente.* Una auditoría automatizada de cómo los asistentes de IA y los buscadores acceden y usan su contenido. [Conozca Análisis SEO IA](https://cookingmetrics.com/es/producto/ai-seo-analysis/). **Hablemos de su medición:** [Agendar charla](https://cookingmetrics.com/es/quien-es-martin-garay/) · [CookingMetrics](https://cookingmetrics.com/es/)