Skip to main content
Glama
deenesjakoruzh
devopsbrandmirchi

GA4 Analytics MCP V3

by devopsbrandmirchi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

GA4 Analytics MCP V3

Conector True Model B: un operador de MCP puede poseer múltiples conexiones independientes de Google OAuth. Cada consulta de GA4 se ejecuta con la credencial de Google que tiene acceso a esa propiedad.

Esta es una nueva aplicación. No modifica V2 y no usa Firestore (default) (reservado para V1).

Desarrollo local

cd D:\MCP_Servers\Ga4McpV3
npm install
copy .env.example .env.local
# Fill secrets. Set FIRESTORE_DATABASE_ID=ga4-mcp-v3 (never (default)).
npm test
npm run dev

  • Aplicación: http://localhost:3000

  • MCP: http://localhost:3000/mcp

  • Salud: http://localhost:3000/health

Related MCP server: GA4 MCP Server

Conector personalizado de Claude

URL: https://<v3-host>/mcp

  1. Claude inicia MCP OAuth 2.1 (mismo flujo V2).

  2. El primer inicio de sesión de Google inicializa un operatorId interno.

  3. Después de eso, conecta cuentas de Google adicionales desde la página de conexiones o ga4_start_google_connection.

  4. El sub del JWT de MCP es siempre operatorId, nunca un sub de Google OpenID.

Conecta una segunda o tercera cuenta de Google

Desde Claude, llama a ga4_start_google_connection y abre la URL devuelta. O usa Conectar otra cuenta de Google en la página de conexiones durante la autorización. Cada autorización es una identidad OAuth independiente.

Enrutamiento de propiedades

property_id → this operator's ga4_properties row → connection_id → encrypted refresh token → GA4 API

El servidor nunca usa el inicio de sesión de Google del navegador actual, el correo de Claude o el nombre de la propiedad para elegir una credencial.

Aislamiento de operadores

El operador A no puede cargar las conexiones del operador B adivinando un connectionId. La propiedad se verifica en el servidor en cada operación sensible.

Cloud Run

.\scripts\cloud-run-setup.ps1 -ProjectId YOUR_PROJECT_ID
.\scripts\cloud-run-deploy.ps1 -ProjectId YOUR_PROJECT_ID
.\scripts\cloud-run-set-env.ps1 `
  -ProjectId YOUR_PROJECT_ID `
  -AppBaseUrl https://YOUR_V3_CLOUD_RUN_URL `
  -GoogleClientId ... -GoogleClientSecret ... `
  -McpTokenSecret ... -OauthStateSecret ... -TokenEncryptionKey ...

Crea una base de datos de Firestore con nombre ga4-mcp-v3 antes del primer uso. Usa un cliente web de Google OAuth separado de V1/V2.

Documentación

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • GA4 MCP Server

    wonyoungseong
    F
    license
    A
    quality
    D
    maintenance
    Enables interaction with Google Analytics 4 to manage accounts, run standard or realtime reports, and validate event parameters. It supports dual authentication methods and integrates with GTM for end-to-end data collection orchestration.
    8
    -

  • Google Workspace MCP

    yaniv-tg
    -
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI assistants to securely manage Google Workspace services (Gmail, Calendar, Drive, Sheets, Contacts) with persistent multi-account OAuth. Uses OS keychain for credential storage with health monitoring and granular business rules for enterprise security.
    -