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

• Firestore-Schema

• OAuth-Abläufe

• MCP-Tools

• Sicherheit

• V2 vs. V3