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.