Skip to main content
Glama
deenesjakoruzh
devopsbrandmirchi

GA4 Analytics MCP V3

by devopsbrandmirchi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Hybrid

GA4 Analytics MCP V3

Коннектор True Model B: один 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

  • Health: 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. После этого подключайте дополнительные учетные записи Google со страницы подключений или через ga4_start_google_connection.

  4. JWT sub в MCP всегда является operatorId, а не Google OpenID sub.

Подключение второй или третьей учетной записи Google

Из Claude вызовите ga4_start_google_connection и откройте возвращенный URL. Или используйте Подключить другую учетную запись Google на странице подключений во время авторизации. Каждая авторизация — это независимая OAuth-идентичность.

Маршрутизация ресурсов

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

Сервер никогда не использует текущий браузерный Google-вход, почту Claude или имя ресурса для выбора учетных данных.

Изоляция операторов

Оператор A не может загрузить подключения оператора B, угадав connectionId. Права владения проверяются на стороне сервера при каждой чувствительной операции.

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 перед первым использованием. Используйте отдельный Google OAuth веб-клиент от V1/V2.

Документация

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

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