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.

Настройка клиентов

cursor
{
    "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

Нарезка длинных видео на короткие клипы с обложками и субтитрами.

Риск: medium Лицензия: MIT ★ 10 310

NotFair

Доступ к Google, Meta, X, LinkedIn, Reddit, TikTok, GSC, GA4 и WordPress через OAuth.

Риск: medium Лицензия: MIT ★ 4 143

obsei

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

Риск: medium Лицензия: Apache-2.0 ★ 1 452

Источники