gconnect-mcp-all-v1

True Model B Google MCP для Claude.ai Custom Connectors.

Это не коннектор только для GA4 и не коннектор только для Google Ads. Это общая платформа с двумя адаптерами продуктов сейчас и зарезервированной точкой расширения для DV360 в будущем:

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

MCP JWT sub — это всегда внутренний operatorId. Google OpenID sub существует только в google_connections.googleSubjectId.

Архитектура

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

См. docs/architecture.md.

Related MCP server: GA4 MCP Server

Идентичность

• Аутентификация MCP отвечает на вопрос: кто является оператором?

• Google OAuth отвечает на вопрос: какой аккаунт Google подключён?

• Уникальность — (operatorId, googleSubjectId), никогда не email и никогда не глобальный Google-субъект.

См. docs/identity-model.md.

Хранение

Используйте только именную базу данных Firestore gconnect-mcp-all-v1.

Не используйте (default) (V1) или ga4-mcp-v3 (V3). При запуске эти идентификаторы отклоняются.

См. docs/google-connections.md.

Локальная разработка

1. Скопируйте .env.example в .env и заполните плейсхолдеры. Не копируйте секреты из V3.

2. npm install

3. npm test

4. npm run typecheck

5. npm run dev

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

Google Ads

Использует официальный Google Ads REST v25. Только чтение. Токен разработчика приложения — это секрет приложения (GOOGLE_ADS_DEVELOPER_TOKEN), но никогда не пользовательские OAuth-учётные данные.

Сервер извлекает login-customer-id из обнаруженной иерархии MCC. Идентификаторы клиентов с дефисами нормализуются перед вызовом API.

См. docs/google-ads.md и docs/ga4.md.

Развёртывание

Cloud Run, неаутентифицированный входящий трафик, именная база данных Firestore gconnect-mcp-end-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 ...

См. docs/deployment.md и docs/security.md.