Skip to main content
Glama
deenesjakoruzh
devopsbrandmirchi

gconnect-mcp-all-v1

by devopsbrandmirchi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

gconnect-mcp-all-v1

Compatible con True Model B Google Marketing MCP para conectores personalizados de Claude.ai.

No es un conector solo-GA4 ni no es un conector solo de Google Ads. Es una plataforma compartida con dos adaptadores de producto ahora y un punto de extensión reservado para más tarde para DV360:

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

El sub del JWT de MCP es siempre el operatorId interno. El sub de OpenID de Google solo existe en google_connection.googleSubjectId.

Arquitectura

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

Consulte docs/arquitectura.md.

Related MCP server: GA4 MCP Server

Identidad

  • La autenticación de MCP responde: ¿quién es el operor?

  • Google OAuth responde: ¿qué cuenta de Google está conecteda?

  • La unicidad es (operatorId, googleSubjectId), nunca email y nunca un subject global de Google.

Consulte docs/identity-model.md.

Persistencia

Solo la base de datos con nombre de Firestore gconnect-mcp-all-v1.

No us ( default ) (V1) ni ga4-mcp-v3 (V3). Inicio rechaza esos IDs.

Consulte docs/google-connections.md.

Desarrolo local

  1. Copie .env.example a .env y rellene los valores. No copée secretos de V3.

  2. npm install

  3. npm test

  4. npm run typecheck

  5. npm run dev

La URL del Custom Connector de Claude es http://localhost:3000/mcp. La salud es GET /health.

Google Ads

Usa el Google Ads REST oficial v25. Solo lectura. El modo de la aplicación es un secreto (GOOGLE_ADS_DEVELOPER_TOKEN), nunca una credencial OAuth de usario.

El servidor resuelve login-customer-id desde la jerarquía de MCC descubierta. Los IDs de cliente con guiones se normalizan antes de la llamada a la API.

Consulte docs/google-ads.md y docs/ga4.md.

Despliegue

Cloud Run, entrada sin autenticación, base de datos con nombre de Firestore 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 ...

Consulte docs/deployment.md y 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