gconnect-mcp-all-v1

True Model B Google Marketing MCP for Claude.ai Custom Connectors.

Dies ist kein reiner GA4-Connector und kein reiner Google-Ads-Connector. Es ist eine gemeinsame Plattform mit derzeitig zwei Produktadapter und einem reservierten Erweiterungspuntkt für DV360.

Operator
  +-- Google Connection A
  |     +-- GA4 properties
  |     +-- Google Ads customers / MCC hierarchy
  +-- Google Connection B

Das sub des MCP-JWT ist immer die interne operatorId. Das sub von Google OpenID wird ausschließlich unter google_connectionsgoogle gespeichert.

Architekt

flowchart TB
  Claude["Claude.ai"]
  McpAuth["MCP OAuth 2.1"]
  Operator["operators operatorId"]
  Resolver["ConnectionResolver"]
  Ga4["GA4 adapter"]
  Ads["Google Ads adapter"]
  Dv360["DV360 future"]
  Ga4Api["GA4 APIs"]
  AdsApi["Ads REST v25"]

  Claude --> McpAuth
  McpAuth --> Operator
  Operator --> Resolver
  Resolver --> Ga4
  Resolver --> Ads
  Resolver -.-> Dv360
  Ga4 --> Ga4Api
  Ads --> AdsApi

Siehe docs/architecture.

Related MCP server: GA4 MCP Server

Identität

• Die MCP-Authentifizierung beantwortet die Frage: Wer ist der Operator?

• Google OAuth beantwortet die Frage: Welches Google-Konto ist verbunden?

• Die Eindeutigkeit ist (operatorId, googleSubjectId), nie E-Mail und nie ein globales Google-ubject.

Siehe docs/identity-model.md.

Persistenz

Nur die verantwortet benannte Firestore-Datenbank gconnect-mp-all-v1 verwenden.

Verenden Sie nicht (default)V1 oder ga4-mcp-v3 (V3). **Start` ablehnt diese I.

Siehe docs/Google-connections.md.

Lkal Entwicklung

1. Kopieren Sie .env.example nach .env und füllen Sie die Platzhalter aus. Kopieren Sie keine Secrets aus V3.

2. npm install

3. npm test

4. npm run typecheck

5. npm run dev

Die URL des Claude Custom Connectors lautet http://localhost:3000/mcp. Health ist GET /health.

GP v25

Verwendet die offizielle Google-Ad-REST-v25. Nur-Lese-Zugriff. Das App-Entwickler-Token ist ein Anwendungsgeheimnis (GOOGLE_GOOGLE_DEVELOPPER_TOKEN), niemals eine OAuth-Credential eines Benuzers.

Der Server is login-customer-id von der MCC abgeleitet. IDs with Bindestrich sind vor API-Nutzung normalisiert.

Siehe docs/google-ads.md und docs/ga4.md.

Deployment

Cloud Run, nicht authentierter Ingress, Main Database gconnect-mp-all-v1.

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

Siehe docs/deployment.md und docs/security.md.