Google Analytics MCP Server

Una interfaz estructurada para interactuar con las APIs de Google Analytics, simplificando tareas como consultar informes y gestionar propiedades.

GitHub
6
Prueba este MCPPatrocinado

Documentación

Servidor MCP de Google Analytics

GA-MCP (Panel de Control de Gestión de Google Analytics) es un paquete ligero de Node.js que proporciona a los desarrolladores una interfaz estructurada para interactuar con las APIs de Google Analytics. Simplifica tareas comunes de GA como consultar informes de analítica, gestionar propiedades, audiencias y más, lo que lo hace ideal para analistas de datos, desarrolladores y equipos de marketing que buscan automatizar flujos de trabajo de informes y analítica. Estándar MCP.

Características

  • Obtener y analizar datos de rendimiento de GA (sesiones, usuarios, páginas vistas, conversiones)
  • Gestionar propiedades, flujos de datos y eventos de conversión
  • Consultar dimensiones y métricas personalizadas
  • Acceder a jerarquías de cuentas y configuraciones de propiedades
  • Exportar datos para paneles de control o análisis adicionales
  • Autenticación OAuth2 con tokens de acceso y actualización
  • Ligero, seguro y altamente configurable

Herramientas MCP

  • get_reports: Obtener datos de informes de analítica para métricas y dimensiones especificadas
  • list_accounts: Listar todas las cuentas de Google Analytics
  • list_properties: Listar propiedades para una cuenta de Google Analytics
  • list_data_streams: Listar flujos de datos para una propiedad
  • list_custom_dimensions: Listar dimensiones personalizadas para una propiedad
  • list_custom_metrics: Listar métricas personalizadas para una propiedad
  • list_conversion_events: Listar eventos de conversión para una propiedad

Primeros Pasos

Requisitos Previos

  • Node.js v18 o posterior
  • Credenciales OAuth2 de Google (ID de Cliente y Secreto de Cliente)
  • Tokens de acceso y actualización válidos de Google Analytics

Configuración de Autenticación

  1. Crear Credenciales OAuth2:

    • Ve a la Consola de Google Cloud

    • Crea o selecciona un proyecto

    • Habilita la API de Google Analytics

    • Ve a "Credenciales" → "Crear Credenciales" → "IDs de Cliente OAuth 2.0"

    • Configura la pantalla de consentimiento y elige el tipo de aplicación adecuado:

      Opción A: Aplicación Web (Recomendada)

      • Selecciona "Aplicación web"
      • Añade http://localhost:3000/auth/callback a "URIs de redirección autorizados"

      Opción B: Aplicación de Escritorio

      • Selecciona "Aplicación de escritorio"
      • No se necesita configuración de URI de redirección (utiliza flujo fuera de banda)

  2. Generar Tokens de Acceso y Actualización:

    • Usa el script auxiliar incluido: npm run oauth-helper
    • O usa el Playground de OAuth2 de Google con tus credenciales de cliente
    • O implementa tu propio flujo OAuth2

Flujo de Configuración Rápida

# 1. Set up environment file
npm run setup-env

# 2. Edit .env with your OAuth2 Client ID and Secret (from step 1 above)

# 3. Generate tokens
npm run oauth-helper

# 4. Copy the generated tokens to your .env file

# 5. Build and start
npm run build
node dist/index.js

Instalación

Clona este repositorio e instala las dependencias:

pnpm install
# or
npm install

Compilación

pnpm build
# or
npm run build

Configuración de Variables de Entorno

Opción 1: Usando archivo .env (Recomendado)

Configura tu archivo de entorno:

npm run setup-env
# This creates .env from the template
# Edit .env file with your actual credentials

Opción 2: Usando comandos de exportación

Establece las siguientes variables de entorno:

export GOOGLE_CLIENT_ID=your_oauth2_client_id
export GOOGLE_CLIENT_SECRET=your_oauth2_client_secret
export GOOGLE_ACCESS_TOKEN=your_access_token
export GOOGLE_REFRESH_TOKEN=your_refresh_token

Inicio

Inicia el servidor MCP:

node dist/index.js

Integración con Cursor

Para usar este servidor MCP con Cursor, añade un archivo .cursor/mcp.json a la raíz de tu proyecto:

{
  "mcpServers": {
    "ga-mcp": {
      "command": "npx",
      "args": ["-y", "ga-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_oauth2_client_id",
        "GOOGLE_CLIENT_SECRET": "your_oauth2_client_secret",
        "GOOGLE_ACCESS_TOKEN": "your_access_token",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Integración con VSCode

Para usar este servidor MCP con VSCode, añade un archivo .vscode/mcp.json a la raíz de tu proyecto:

{
  "servers": {
    "ga-mcp": {
      "command": "npx",
      "args": ["-y", "ga-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_oauth2_client_id",
        "GOOGLE_CLIENT_SECRET": "your_oauth2_client_secret",
        "GOOGLE_ACCESS_TOKEN": "your_access_token",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Esta configuración permite que VSCode reconozca y gestione automáticamente el servidor MCP de Google Analytics.

Esta configuración permite que Cursor reconozca y gestione automáticamente el servidor MCP de Google Analytics.

Actualización de Tokens

El servidor MCP maneja automáticamente la actualización de tokens utilizando el token de actualización proporcionado. Si el token de acceso expira, se actualizará automáticamente durante las llamadas a la API.

Solución de Problemas

"El URI de redirección... solo puede ser utilizado por un ID de Cliente para aplicación nativa"

Este error ocurre cuando tienes un cliente OAuth de Aplicación web pero estás utilizando el URI de redirección fuera de banda. Soluciones:

Solución 1: Usar Aplicación Web (Recomendada)

  1. En la Consola de Google Cloud, edita tu cliente OAuth
  2. Añade http://localhost:3000/auth/callback a "URIs de redirección autorizados"
  3. Mantén GOOGLE_REDIRECT_URI=http://localhost:3000/auth/callback en tu archivo .env

Solución 2: Cambiar a Aplicación de Escritorio

  1. Crea un nuevo cliente OAuth y selecciona "Aplicación de escritorio"
  2. Establece GOOGLE_REDIRECT_URI=urn:ietf:wg:oauth:2.0:oob en tu archivo .env

Acerca de AST Consulting

AST Consulting es una firma de consultoría digital de primer nivel especializada en FinOps, optimización de la nube, soluciones de IA/ML, transformación digital y marketing de rendimiento. Con más de 100 años de experiencia combinada en liderazgo y un portafolio que impacta a más de 50 millones de negocios y más de 500 millones de usuarios, AST ofrece resultados medibles combinando visión estratégica con profunda experiencia técnica.

Desarrollamos ga-mcp como parte de nuestro compromiso de empoderar a especialistas en marketing, analistas y equipos digitales con herramientas que impulsan eficiencia, transparencia e información accionable. Ya sea optimizando el gasto en la nube o automatizando pipelines de inteligencia analítica, AST construye soluciones que escalan.

👉 Visítanos en www.astconsulting.in

ga-mcp