Skip to main content
Glama
Sign In
deenesjakoruzh
gconnect-mcp-all-v1

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.

This is not a GA4-only connector and not a Google Ads-only connector. It is a shared platform with GA4, Google Ads, and Display & Video 360 adapters:

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

MCP JWT sub is always the internal operatorId. Google OpenID sub lives only on google_connections.googleSubjectId.

Architecture

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

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

See docs/architecture.md.

Related MCP server: google-ads-mcp

Identity

  • MCP authentication answers: who is the operator?

  • Google OAuth answers: which Google account is connected?

  • Uniqueness is (operatorId, googleSubjectId), never email and never a global Google subject.

See docs/identity-model.md.

Persistence

Firestore named database gconnect-mcp-all-v1 only.

Do not use (default) (V1) or ga4-mcp-v3 (V3). Startup rejects those IDs.

See docs/google-connections.md.

Local development

  1. Copy .env.example to .env and fill placeholders. Do not copy secrets from V3.

  2. npm install

  3. npm test

  4. npm run typecheck

  5. npm run dev

Claude Custom Connector URL is http://localhost:3000/mcp. Health is GET /health.

Google Ads

Uses official Google Ads REST v25. Read-only. The app developer token is an application secret (GOOGLE_ADS_DEVELOPER_TOKEN), never a user OAuth credential.

The server resolves login-customer-id from discovered MCC hierarchy. Hyphenated customer IDs are normalized before API use.

See docs/google-ads.md, docs/ga4.md, and docs/dv360.md.

Display & Video 360

Uses official Display & Video 360 REST v4. Read-only discovery in this phase. Existing Google connections must reconnect to grant https://www.googleapis.com/auth/display-video. No extra secrets.

Deployment

Cloud Run, unauthenticated ingress, named Firestore database gconnect-mcp-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 ...

See docs/deployment.md and 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

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • 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

  • google-ads-mcp

    kevin-namba
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables MCP clients such as Claude to manage Google Ads accounts through the Google Ads API, including performance reporting, keyword planning, search and P-MAX campaign creation, status changes, and budget updates.
    MIT

  • google-ads-mcp

    kevin-namba
    A
    license
    A
    quality
    C
    maintenance
    Enables MCP clients such as Claude to read Google Ads performance reports, run keyword planner queries, and create or manage search and Performance Max campaigns, ad groups, keywords, ads, budgets, and delivery status. Write operations default to paused and can be disabled entirely for read-only analytics use.
    16
    MIT

  • GA4 MCP

    tagpilot
    A
    license
    Not graded
    quality
    A
    maintenance
    Enables MCP clients like Claude and Cursor to run read-only Google Analytics 4 queries — reports, funnels, realtime data, property and stream setup, custom dimensions, plus tracking-health checks for duplicate transactions and traffic attribution — with a one-time browser Google sign-in and no Google Cloud project required. GA4 data flows directly from the local machine to Google, and only read-only analytics access is requested.
    Apache 2.0