GA4 - Google Analytics MCP Server

¿Qué es el servidor GA4 - Google Analytics MCP?

GA4 - Google Analytics MCP es un servidor independiente que expone las capacidades de informes de Google Analytics 4 a través del Protocolo de Contexto de Modelo estandarizado. Actúa como un puente seguro entre tu propiedad GA4 y cualquier herramienta de IA compatible con MCP, permitiendo búsquedas rápidas de análisis, informes e integración en flujos de trabajo de IA mediante funciones predefinidas.

Cómo Configurar

1. Configuración de Google

   • Habilita la API de Datos de Google Analytics en tu proyecto de Google Cloud.
   • Crea una cuenta de servicio en "IAM & Admin > Cuentas de Servicio" y genera una clave de credenciales en JSON.
   • Concede a la cuenta de servicio acceso de "Visualizador" a tu propiedad GA4 en Google Analytics.

2. Entorno del Servidor

   • Configura las variables de entorno:
     • GOOGLE_CLIENT_EMAIL: Correo electrónico de la cuenta de servicio del JSON de credenciales
     • GOOGLE_PRIVATE_KEY: Clave privada de la cuenta de servicio del JSON de credenciales
     • GA_PROPERTY_ID: Tu ID de propiedad GA4

3. Instalación

   • Instala globalmente: npm install -g mcp-server-google-analytics
   • O usa con npx: npx mcp-server-google-analytics
   • O instala a través de Smithery para integración con Claude Desktop.

4. Configuración para Herramientas de IA (por ejemplo, Claude Desktop)

   • Agrega el comando y las variables de entorno apropiadas en la configuración de tu herramienta bajo servidores MCP.

Cómo Usar

1. Iniciar el Servidor

   • Ejecuta pnpm start, npx mcp-server-google-analytics, o inícialo desde tu integración de herramienta.

2. Llamar a Funciones/Herramientas

   • Las herramientas de IA o agentes LLM pueden invocar funciones como runReport, getPageViews, getActiveUsers, getEvents o getUserBehavior a través de la interfaz MCP.
   • Pasa los campos requeridos (por ejemplo, rangos de fechas, dimensiones, métricas) como argumentos de función.

3. Ejemplo: Consultar Vistas de Página

   • Usa la herramienta getPageViews proporcionando un rango de fechas y dimensiones opcionales para obtener métricas de vistas de página.

4. Integración

   • Incorpora el servidor con cualquier cliente de IA o sistema de automatización que soporte MCP para acceso dinámico a análisis.

Funciones Clave

• Acceso a datos de análisis de GA4 en tiempo real a través de llamadas de función MCP estándar.
• Informes personalizables: elige métricas, dimensiones, filtros y períodos específicos.
• Herramientas predefinidas múltiples: vistas de página, métricas de usuarios, métricas de eventos y análisis de comportamiento.
• Autenticación segura con cuenta de servicio, con permisos mínimos necesarios.
• Instalación y configuración fáciles para uso tanto independiente como integrado (por ejemplo, en Claude Desktop).
• Diseñado para ser extensible para futuras necesidades analíticas.

Casos de Uso

• Integra métricas de GA4 directamente en paneles impulsados por IA, herramientas de informes o flujos de trabajo de asistentes.
• Permite a chatbots o agentes de IA responder preguntas sobre el uso de sitios web/aplicaciones, tendencias de tráfico o participación de usuarios.
• Automatiza la generación de resúmenes de análisis, análisis de cohortes o informes basados en eventos.
• Monitorea el rendimiento de campañas y el comportamiento de usuarios en tiempo real desde productos habilitados para IA.

FAQ

Q1: ¿Qué permisos de GA4 se requieren para la cuenta de servicio?
A: La cuenta de servicio solo necesita acceso de "Visualizador" a la propiedad GA4 objetivo, lo que permite acceso solo a lectura a los datos analíticos.

Q2: ¿Está segura mi clave privada durante la operación?
A: Sí, tu clave privada y credenciales se mantienen solo en variables de entorno del servidor; nunca expongas claves al cliente o repositorios públicos.

Q3: ¿Puedo usar esto con cualquier herramienta o flujo de trabajo de IA?
A: Sí, siempre que la herramienta soporte integración MCP, puedes conectar el servidor y acceder a las funciones analíticas.

Q4: ¿Qué pasa si mis credenciales son inválidas o no están configuradas correctamente?
A: El servidor no podrá autenticarse con Google Analytics y las llamadas a funciones devolverán errores indicando problemas de credenciales; asegúrate de seguir las instrucciones de configuración de cerca.

Q5: ¿Es posible extender o personalizar las herramientas disponibles?
A: Sí, el proyecto es de código abierto, y puedes contribuir o adaptar el servidor para soportar consultas adicionales de GA4 o lógica de informes personalizada.