Skip to main content
Glama
deenesjakoruzh
devopsbrandmirchi

GA4 Analytics MCP V3

by devopsbrandmirchi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

GA4 Analytics MCP V3

True Model B コネクタ:1つのMCPオペレーターが複数の独立したGoogle OAuth接続を所有できます。各GA4クエリは、そのプロパティへのアクセス権を持つGoogle認証情報で実行されます。

これは新しいアプリケーションです。V2を変更せず、Firestore (default)(V1用に予約済み)も使用しません。

ローカル開発

cd D:\MCP_Servers\Ga4McpV3
npm install
copy .env.example .env.local
# Fill secrets. Set FIRESTORE_DATABASE_ID=ga4-mcp-v3 (never (default)).
npm test
npm run dev

  • アプリ: http://localhost:3000

  • MCP: http://localhost:3000/mcp

  • ヘルスチェック: http://localhost:3000/health

Related MCP server: GA4 MCP Server

Claude カスタムコネクタ

URL: https://<v3-host>/mcp

  1. ClaudeがMCP OAuth 2.1を開始します(V2と同じフロー)。

  2. 最初のGoogleサインインが内部のoperatorIdをブートストラップします。

  3. その後、接続ページまたはga4_start_google_connectionから追加のGoogleアカウントを接続します。

  4. MCP JWTのsubは常にoperatorIdであり、Google OpenIDのsubではありません。

2つ目または3つ目のGoogleアカウントを接続する

Claudeからga4_start_google_connectionを呼び出し、返されたURLを開きます。または、認可中に接続ページの別のGoogleアカウントを接続を使用します。各認可は独立したOAuth IDです。

プロパティルーティング

property_id → this operator's ga4_properties row → connection_id → encrypted refresh token → GA4 API

サーバーは、現在のブラウザのGoogleログイン、Claudeのメール、またはプロパティ名を使用して認証情報を選択することはありません。

オペレーターの分離

オペレーターAは、connectionIdを推測してもオペレーターBの接続を読み込めません。所有権は、すべての機密操作でサーバー側でチェックされます。

Cloud Run

.\scripts\cloud-run-setup.ps1 -ProjectId YOUR_PROJECT_ID
.\scripts\cloud-run-deploy.ps1 -ProjectId YOUR_PROJECT_ID
.\scripts\cloud-run-set-env.ps1 `
  -ProjectId YOUR_PROJECT_ID `
  -AppBaseUrl https://YOUR_V3_CLOUD_RUN_URL `
  -GoogleClientId ... -GoogleClientSecret ... `
  -McpTokenSecret ... -OauthStateSecret ... -TokenEncryptionKey ...

初回使用前に、名前付きFirestoreデータベースga4-mcp-v3を作成します。V1/V2とは別のGoogle OAuthウェブクライアントを使用します。

ドキュメント

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

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • GA4 MCP Server

    wonyoungseong
    F
    license
    A
    quality
    D
    maintenance
    Enables interaction with Google Analytics 4 to manage accounts, run standard or realtime reports, and validate event parameters. It supports dual authentication methods and integrates with GTM for end-to-end data collection orchestration.
    8
    -

  • Google Workspace MCP

    yaniv-tg
    -
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI assistants to securely manage Google Workspace services (Gmail, Calendar, Drive, Sheets, Contacts) with persistent multi-account OAuth. Uses OS keychain for credential storage with health monitoring and granular business rules for enterprise security.
    -