Skip to main content
Glama
deenesjakoruzh
devopsbrandmirchi

gconnect-mcp-all-v1

by devopsbrandmirchi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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.

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

  • ads-mcp

    manlikemuneeb
    A
    license
    Not graded
    quality
    C
    maintenance
    Unified MCP server for managing Meta Ads, LinkedIn Ads, Google Ads, GA4, and Search Console with 89 read/write tools, multi-account support, OAuth setup, and safe dry-run mutations.
    MIT

  • GA4 MCP Server

    luminarylane
    A
    license
    A
    quality
    B
    maintenance
    Connects MCP clients like Claude Desktop to Google Analytics 4 Data API, enabling natural language queries for reports, top pages, traffic sources, conversions, realtime users, and period comparisons.
    7
    20 PyPI
    MIT

  • Google MCP Server

    kairos-company
    A
    license
    Not graded
    quality
    D
    maintenance
    A unified MCP server that gives AI assistants direct access to Google Analytics 4, Google Search Console, Google Ads and Google Merchant Center data using OAuth2 user credentials.
    MIT

  • Google Ads MCP Server

    FlatbuzhZubumafu
    A
    license
    B
    quality
    C
    maintenance
    Enables Claude and other MCP-capable assistants to monitor and manage Google Ads accounts by pulling performance reports, running GAQL queries, adjusting budgets, pausing or enabling campaigns, adding keywords and negative keywords, and creating campaigns and ads, with preview and read-only safety controls.
    31
    Apache 2.0