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 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.

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