Skip to main content
Glama
deenesjakoruzh
devopsbrandmirchi

GA4 Analytics MCP V3

by devopsbrandmirchi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

GA4 Analytics MCP V3

Echter Model-B-Connector: Ein MCP-Operator kann mehrere unabhängige Google-OAuth-Verbindungen besitzen. Jede GA4-Abfrage wird mit den Google-Anmeldedaten ausgeführt, die Zugriff auf diese Property haben.

Dies ist eine neue Anwendung. Sie ändert V2 nicht und verwendet nicht Firestore (default) (reserviert für V1).

Lokale Entwicklung

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

  • App: http://localhost:3000

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

  • Health: http://localhost:3000/health

Related MCP server: GA4 MCP Server

Claude Benutzerdefinierter Connector

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

  1. Claude startet MCP OAuth 2.1 (gleicher V2-Ablauf).

  2. Die erste Google-Anmeldung initialisiert eine interne operatorId.

  3. Danach verbinden Sie zusätzliche Google-Konten über die Verbindungsseite oder ga4_start_google_connection.

  4. Das MCP-JWT sub ist immer operatorId, niemals ein Google-OpenID-sub.

Ein zweites oder drittes Google-Konto verbinden

Rufen Sie in Claude ga4_start_google_connection auf und öffnen Sie die zurückgegebene URL. Oder verwenden Sie Ein anderes Google-Konto verbinden auf der Verbindungsseite während der Autorisierung. Jede Autorisierung ist eine unabhängige OAuth-Identität.

Property-Routing

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

Der Server verwendet niemals die aktuelle Google-Anmeldung im Browser, die Claude-E-Mail oder den Property-Namen, um eine Anmeldedaten auszuwählen.

Operator-Isolation

Operator A kann die Verbindungen von Operator B nicht durch Erraten einer connectionId laden. Die Eigentümerschaft wird serverseitig bei jedem sensiblen Vorgang überprüft.

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 ...

Erstellen Sie vor der ersten Verwendung eine benannte Firestore-Datenbank ga4-mcp-v3. Verwenden Sie einen separaten Google-OAuth-Webclient von V1/V2.

Dokumentation

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

ActivityStale
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.
    -