# QuerySail: Google Analytics

QuerySail: Google Analytics — MCP-сервер для Claude Code, подключающий Google Analytics 4 к ИИ-агенту для вопросов о трафике, сравнении периодов и realtime-данных без API-ключей.

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

## Что делает

QuerySail — готовый MCP-сервер для Google Analytics 4, который работает по HTTP: ставить локально ничего не нужно, но перед использованием нужно завести аккаунт на querysail.com и подключить Google. Сервер даёт пять инструментов: `list_properties` показывает доступные свойства GA4, `list_fields` — список измерений и метрик конкретного свойства, включая кастомные, `run_report` строит отчёты по пользователям, сессиям, событиям и доходу с разбивкой по каналам, страницам, устройствам и странам, `compare_report` сравнивает два периода и находит, что выросло или упало, а `run_realtime_report` показывает активность за последние 30 минут.

Доступ только на чтение: изменить свойства, потоки данных или аудитории через этот сервер нельзя. Отчёты кешируются до 15 минут, realtime-данные не кешируются, а свойства Universal Analytics сервер не поддерживает. Для Google наложены лимиты квот и возможны пороговые ограничения или сэмплирование — эти флаги сервер передаёт агенту как есть.

Подключение к Claude Code — через `claude mcp add` или установкой плагина из маркетплейса, который добавляет ещё и скилл для анализа данных GA4. Для клиентов без поддержки удалённых серверов есть мост `mcp-remote` на Node.js.

## Требования
- Удалённый сервер: `https://mcp.querysail.com/ga4/mcp`

## Установка

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

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http ga4 https://mcp.querysail.com/ga4/mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add querysail-google-analytics --url https://mcp.querysail.com/ga4/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "querysail-google-analytics": {
            "url": "https://mcp.querysail.com/ga4/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "querysail-google-analytics": {
            "type": "http",
            "url": "https://mcp.querysail.com/ga4/mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http querysail-google-analytics https://mcp.querysail.com/ga4/mcp
```

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

## Примеры запросов агенту
- Сколько пользователей и сессий было на сайте за последние 28 дней?
- Какие каналы принесли больше всего сессий в прошлом месяце и как это изменилось по сравнению с предыдущим?
- Сравни сессии из органического поиска с теми же неделями год назад

## Похожие
- [google-analytics](https://affpapa.org/nevibecode/skills/google-analytics.md) — скилл · 539 установок
- [pp-google-analytics](https://affpapa.org/nevibecode/skills/pp-google-analytics.md) — скилл · 152 установки
- [google-analytics-automation](https://affpapa.org/nevibecode/skills/google-analytics-automation.md) — скилл · 130 установок
- [Google Analytics 4 MCP](https://affpapa.org/nevibecode/mcp/google-analytics-4-mcp.md) — MCP-сервер
- [anacraft — Google Analytics 4](https://affpapa.org/nevibecode/mcp/anacraft-google-analytics-4.md) — MCP-сервер · ★ 1 у репозитория
- [google-analytics-mcp](https://affpapa.org/nevibecode/mcp/google-analytics-mcp.md) — MCP-сервер · ★ 243 у репозитория

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