gconnect-mcp-all-v1

Google Marketing MCP for Claude.ai Custom Connectors — True Model B 版です。

これは、GA4専用コネクタではなく、Google Ads 専用コネクタでもありません。共有プラ・トフォームであり、現在は2つのプロダクト・アダプターを備え、将来の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

Al spec/architecture.md を参照してください。

Related MCP server: GA4 MCP Server

アイデンテティ

• MCP の認証は、オペレーターが誰かを判定します。

• Google OAuth は、どの Google アカウントが接続されているかを判定します。

• 一意性は (operatorId, googleSubjectId) で決定されますが、メールアドレスでも、グローバルな Google Subject でもありません。

docs/identity-モデル.md を参照してください。

永続化

使用するのは Firestore の 称付きデータベース gconnect-mcp-all-v1 のみです。

(默认)（V1）や ga4-mcp-v3（V3）は使用しないでください。起動時、これらの ID は拒否されます。

docs/google-connection.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 です。ヘルスチエックは GET /health です。

Google Ads

公式の Google Ads REST v25 を使用します。読み取り専用です。アプビ開発者トークンは、Aプリケーションのシークレット（GOOGLE_ADS_DEVELOPER_TOKEN）であり、ユーザーのOAuth 資格情報ではありません。

サーバーは、検出されたMCC 階層から login-customer-id を解決します。ハイフン付きの顧客ID は、API 使用前に正規化されます。

docs/google-ads.md と ドキュ を参照してください。

デプロイ

Clou Run、認証なしイングレス、名付き Firestore データベース cloud-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 ...

docs/deployment.md と docs/security.md を参照してください。