Google Analytics 4 MCP Server бета-версия: экспериментальный инструмент для естественных запросов к GA4

26 октября 2026 года Google опубликовал официальную документацию по Google Analytics 4 MCP Server. Репозиторий googleanalytics/google-analytics-mcp на GitHub и пакет analytics-mcp на PyPI получили статус экспериментальных. Сервер реализует протокол Model Context Protocol для подключения данных Google Analytics 4 к языковым моделям и агентам.

Функции Google Analytics 4 MCP Server

Сервер предоставляет набор инструментов только для чтения. Среди них get_account_summaries, get_property_details, run_report, run_realtime_report, run_funnel_report и run_conversions_report. Доступна также опциональная операция записи create_property_annotation при использовании флага --allow-write и области analytics.edit.

Для работы требуется Python версии 3.10 или выше, проект Google Cloud с включёнными API Analytics Admin и Data API, а также роль Viewer на свойстве GA4. Аутентификация выполняется через Application Default Credentials с областью analytics.readonly. Транспорт — локальный stdio, без размещённой конечной точки в официальной документации.

Google Analytics 4 MCP Server работает в рамках квот GA4 API. Экспериментальный статус означает возможные изменения в наборе инструментов и поведении. Сервер не позволяет изменять настройки свойств GA4.

Контекст и возможности применения

Model Context Protocol разработан для стандартизации взаимодействия ИИ-агентов с внешними источниками данных. Google Analytics 4 MCP Server даёт агентам Gemini, Claude и аналогичным системам возможность формировать отчёты и анализировать свойства GA4 естественным языком. Это расширяет существующие возможности GA4 API для сценариев, связанных с маркетинговыми платформами и API аналитики.

В отличие от прямых коннекторов CRM, сервер не содержит встроенных функций экспорта в конкретные системы. Данные, полученные через инструменты run_report и run_funnel_report, можно передавать в CRM вручную или с помощью существующих интеграций GA4. В России пользователи применяют общие квоты GA4 API и должны учитывать требования локального законодательства при обработке данных.

Ограничения включают локальный запуск на машине пользователя и отсутствие нативной хостинговой версии. Разработчики могут отслеживать обновления в репозитории и документации Google for Developers. Дальнейшее развитие ожидается в области отчётов по воронкам и конверсиям, которые в некоторых источниках отмечены как альфа.