# Google Analytics 4

MCP-сервер даёт агенту доступ к отчётам GA4, воронкам и настройкам ресурсов в режиме чтения. Пригодится, чтобы изучать аналитику из Claude Code.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Автор: get-mcp-ads
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/get-mcp-ads/google-analytics-mcp-server
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/mcp/get-mcp-ads-google-analytics-4

## Что делает

Сервер предоставляет 27 инструментов для чтения данных Google Analytics 4: отчётов, воронок, данных в реальном времени и настроек ресурсов. Он также умеет проверять сочетания метрик и измерений до запроса к API, а снимок квот помогает следить за доступными лимитами. Инструментов для записи нет.

Для работы нужны учётные данные платформы: `GA4_CLIENT_ID`, `GA4_CLIENT_SECRET` и `GA4_REFRESH_TOKEN`. Сервер запускается через `npx` и требует Node.js `22.23.4`, `24.22.1` или `26.12.1` и новее в соответствующих ветках. Без подходящей версии Node.js он выдаст предупреждение при запуске. В Claude Code подключение работает через MCP с транспортом stdio.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `GA4_CLIENT_ID`, `GA4_CLIENT_SECRET`, `GA4_REFRESH_TOKEN`, `GA4_PROPERTY_ID`, `GA4_PROPERTY_IDS` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add --env GA4_CLIENT_ID=<GA4_CLIENT_ID> --env GA4_CLIENT_SECRET=<GA4_CLIENT_SECRET> --env GA4_REFRESH_TOKEN=<GA4_REFRESH_TOKEN> --env GA4_PROPERTY_ID=<GA4_PROPERTY_ID> --env GA4_PROPERTY_IDS=<GA4_PROPERTY_IDS> --transport stdio get-mcp-ads-google-analytics-4 -- npx -y @getmcpads/google-analytics-mcp-server
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add get-mcp-ads-google-analytics-4 --env GA4_CLIENT_ID=<GA4_CLIENT_ID> --env GA4_CLIENT_SECRET=<GA4_CLIENT_SECRET> --env GA4_REFRESH_TOKEN=<GA4_REFRESH_TOKEN> --env GA4_PROPERTY_ID=<GA4_PROPERTY_ID> --env GA4_PROPERTY_IDS=<GA4_PROPERTY_IDS> -- npx -y @getmcpads/google-analytics-mcp-server
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "get-mcp-ads-google-analytics-4": {
            "command": "npx",
            "args": [
                "-y",
                "@getmcpads/google-analytics-mcp-server"
            ],
            "env": {
                "GA4_CLIENT_ID": "<GA4_CLIENT_ID>",
                "GA4_CLIENT_SECRET": "<GA4_CLIENT_SECRET>",
                "GA4_REFRESH_TOKEN": "<GA4_REFRESH_TOKEN>",
                "GA4_PROPERTY_ID": "<GA4_PROPERTY_ID>",
                "GA4_PROPERTY_IDS": "<GA4_PROPERTY_IDS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "get-mcp-ads-google-analytics-4": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@getmcpads/google-analytics-mcp-server"
            ],
            "env": {
                "GA4_CLIENT_ID": "<GA4_CLIENT_ID>",
                "GA4_CLIENT_SECRET": "<GA4_CLIENT_SECRET>",
                "GA4_REFRESH_TOKEN": "<GA4_REFRESH_TOKEN>",
                "GA4_PROPERTY_ID": "<GA4_PROPERTY_ID>",
                "GA4_PROPERTY_IDS": "<GA4_PROPERTY_IDS>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e GA4_CLIENT_ID=<GA4_CLIENT_ID> -e GA4_CLIENT_SECRET=<GA4_CLIENT_SECRET> -e GA4_REFRESH_TOKEN=<GA4_REFRESH_TOKEN> -e GA4_PROPERTY_ID=<GA4_PROPERTY_ID> -e GA4_PROPERTY_IDS=<GA4_PROPERTY_IDS> get-mcp-ads-google-analytics-4 npx -y @getmcpads/google-analytics-mcp-server
```
Вместо <…> подставьте свои значения

## Когда брать
- изучить трафик и конверсии в GA4
- проверить метрики и измерения перед запросом
- посмотреть данные воронки и отчёты в реальном времени
- проверить квоты ресурса GA4
- просмотреть настройки ресурсов и потоков данных

## Примеры запросов агенту
- Покажи отчёт по конверсиям для моего ресурса GA4.
- Проверь, совместимы ли эти метрика и измерение в GA4.
- Посмотри текущую квоту запросов для ресурса GA4.

## Похожие
- [World Monitor](https://affpapa.org/nevibecode/mcp/world-monitor.md) — MCP-сервер · ★ 89609
- [Scrapling MCP Server](https://affpapa.org/nevibecode/mcp/scrapling-mcp-server.md) — MCP-сервер · ★ 89899
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16730
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40459
- [dbx](https://affpapa.org/nevibecode/mcp/dbx.md) — MCP-сервер · ★ 27844
- [Metabase](https://affpapa.org/nevibecode/mcp/metabase.md) — MCP-сервер · ★ 49863

## Другие версии с тем же именем
- [Google Analytics 4 · mindstone](https://affpapa.org/nevibecode/mcp/google-analytics-4.md) — ★ 13

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md