google-analytics-mcp
google-analytics-mcp — MCP-сервер сообщества (автор — surendranb). GA4 для агентов: обзор схемы, агрегация на сервере и анализ. Ставится через uvx или через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- surendranb
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- other
- ОС
- Не указана
- Языки
- python
Уровень риска: medium
Только чтение данных GA4 через сервисный аккаунт; анонимная телеметрия отключается DO_NOT_TRACK=1.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"google-analytics\": {\n \"command\": \"uvx\",\n \"args\": [\"google-analytics-mcp\"]\n }\n }\n}",
"file": "mcp.json",
"lang": "json",
"notes": "Дословно из README",
"verified": "docs"
}
Что умеет
Google Analytics 4 MCP Server даёт ИИ-агенту доступ к данным Google Analytics 4: отчёты, структура свойств, агрегирование метрик и данные в реальном времени. Инструменты:
| Инструмент | Что делает |
|---|---|
get_ga4_data |
многомерные отчёты GA4 с итогами по метрикам и агрегированием на стороне сервера |
list_accounts |
доступные аккаунты Google Analytics и уровни прав |
list_properties |
ресурсы GA4 в аккаунте |
get_property_metadata |
полная схема параметров и метрик, пользовательские определения и правила совместимости |
run_realtime_report |
активные пользователи и события за последние 30 минут |
search_skills, skills_list, skill_read |
поиск, список и загрузка готовых аналитических сценариев |
Готовые сценарии загружаются с GitHub и подсказывают агенту порядок анализа:
traffic-diagnosis— поиск причины резкого падения трафика;channel-acquisition— группировка каналов и модели атрибуции;ecommerce-analysis— выручка, доля покупок и воронка конверсии;ai-referral-analysis— выделение переходов из ChatGPT, Claude, Perplexity и Gemini.
Отчёт get_ga4_data принимает списки параметров, метрик и диапазонов дат, а также ограничение числа строк. Все инструменты читают данные — изменять настройки Google Analytics сервер не умеет.
Кому подойдёт
- Маркетологам и аналитикам: ответы на вопросы о трафике и конверсиях без ручной сборки отчётов.
- Владельцам интернет-магазинов: анализ выручки и воронки покупок.
- Тем, кто отслеживает трафик из ИИ-ассистентов: отдельный сценарий для таких переходов.
Похожие серверы — в категории данные и аналитика.
Установка
Сервер можно запустить через uvx google-analytics-mcp, python -m ga4_mcp или npx -y @surendranb/google-analytics-mcp. Есть и установщик одной командой, который сам настраивает Claude Desktop, Cursor, Claude Code, Antigravity, VS Code, Zed и Windsurf, — перед запуском скрипта из интернета просмотрите его содержимое.
Для доступа к данным нужен сервисный аккаунт Google: путь к его ключу передаётся в GOOGLE_APPLICATION_CREDENTIALS, идентификатор ресурса — в GA4_PROPERTY_ID. Храните файл ключа вне репозиториев.
Подключение к клиентам
Команда и конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
claude mcp add google-analytics -- uvx google-analytics-mcpКонфиг Cursor добавляют в mcp.json, конфиг Claude Desktop — в claude_desktop_config.json; замените в нём идентификатор ресурса и путь к ключу своими значениями.
Проверка
Попросите агента вызвать list_accounts. В ответе должен быть список аккаунтов Google Analytics, доступных сервисному аккаунту, с уровнями прав.
Примеры задач
Сравни сессии и конверсии по каналам за последние 28 дней с предыдущим периодом.Трафик сайта вчера упал вдвое — разберись по сценарию traffic-diagnosis, в чём причина.Сколько пользователей сейчас на сайте и какие события они совершают?Риски
- Доступ к аналитике. Агент видит все данные ресурсов, к которым есть доступ у сервисного аккаунта. Выдавайте ему права только на чтение и только к нужным ресурсам.
- Ключ сервисного аккаунта. Файл ключа даёт доступ к Google Analytics; не публикуйте его.
- Загрузка сценариев. Аналитические сценарии подгружаются с GitHub во время работы.
- Телеметрия. Пакет отправляет анонимную диагностику (вызовы команд, задержки, коды ошибок) без запросов, учётных данных и персональных данных. Отключается переменной
DO_NOT_TRACK=1илиMCP_TELEMETRY_OPT_OUT=1.
Частые вопросы
Может ли сервер изменить настройки Google Analytics?
Нет. Все инструменты только читают отчёты, метаданные и списки аккаунтов.
Поддерживается ли Universal Analytics?
Сервер рассчитан на Google Analytics 4.
Как отключить телеметрию?
Задайте переменную окружения DO_NOT_TRACK=1 или MCP_TELEMETRY_OPT_OUT=1.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
AutoClip
Нарезка длинных видео на короткие клипы с обложками и субтитрами.
Google Ads + Meta Ads + SEO/GEO MCP
Google Ads, Meta Ads, GA4 и Search Console в одном сервере.
NotFair
Доступ к Google, Meta, X, LinkedIn, Reddit, TikTok, GSC, GA4 и WordPress через OAuth.
obsei
Самостоятельно размещаемая система обратной связи клиентов с удалением персональных данных.