Google Analytics 4 MCP — MCP-сервер для Claude Code: установка
Сервер даёт агенту доступ к отчётам GA4 и административным спискам в режиме чтения. С его помощью можно изучать метрики, проверять измерения и разбирать воронки.
claude mcp add --env GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> --env GA4_LOG_LEVEL=<GA4_LOG_LEVEL> --transport stdio google-analytics-4-mcp -- uvx scalably-ga4-mcpЧто делает Google Analytics 4 MCP
Сервер предоставляет 17 инструментов для чтения данных Google Analytics 4: стандартные, пакетные, сводные, оперативные отчёты и отчёты по воронкам. Агент также может получить каталог измерений и метрик, проверить их совместимость и просмотреть свойства, потоки данных, аудитории, ключевые события и другие списки администрирования.
Для работы нужны проект Google Cloud с включёнными Google Analytics Data API и Google Analytics Admin API, JSON-ключ сервисного аккаунта и доступ Viewer к нужным ресурсам GA4. Задайте путь к ключу через GOOGLE_APPLICATION_CREDENTIALS. Без доступа Viewer к свойству запросы к нему не пройдут. Сервер использует только чтение; отчёты в реальном времени охватывают последние 30 минут, а данные обычных отчётов могут запаздывать на 24–48 часов.
Какие задачи решает
- получить стандартный отчёт GA4 по выбранному свойству
- сравнить несколько отчётов одним пакетным запросом
- проверить, совместимы ли измерение и метрика
- посмотреть воронку и найти шаги с потерями
- узнать, какие свойства доступны сервисному аккаунту
Примеры запросов агенту
- Используй Google Analytics 4 MCP, найди доступные свойства и покажи их идентификаторы.
- Составь отчёт GA4 по стране и категории устройства для выбранного свойства.
- Проверь совместимость измерения и метрики, затем построй отчёт по воронке.
Как установить Google Analytics 4 MCP
Командой платформы
claude mcp add --env GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> --env GA4_LOG_LEVEL=<GA4_LOG_LEVEL> --transport stdio google-analytics-4-mcp -- uvx scalably-ga4-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-ga4-mcp <команда>
Командой платформы
codex mcp add google-analytics-4-mcp --env GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> --env GA4_LOG_LEVEL=<GA4_LOG_LEVEL> -- uvx scalably-ga4-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-ga4-mcp <команда>
Файл настроек
{
"mcpServers": {
"google-analytics-4-mcp": {
"command": "uvx",
"args": [
"scalably-ga4-mcp"
],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>",
"GA4_LOG_LEVEL": "<GA4_LOG_LEVEL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-ga4-mcp <команда>
Файл настроек
{
"servers": {
"google-analytics-4-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"scalably-ga4-mcp"
],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "<GOOGLE_APPLICATION_CREDENTIALS>",
"GA4_LOG_LEVEL": "<GA4_LOG_LEVEL>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-ga4-mcp <команда>
Командой платформы
gemini mcp add -e GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> -e GA4_LOG_LEVEL=<GA4_LOG_LEVEL> google-analytics-4-mcp uvx scalably-ga4-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from scalably-ga4-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Google Analytics 4 MCP
Как установить Google Analytics 4 MCP в Claude Code?
Задайте путь к JSON-ключу сервисного аккаунта вместо плейсхолдера и выполните claude mcp add ga4-mcp -e GOOGLE_APPLICATION_CREDENTIALS=<GOOGLE_APPLICATION_CREDENTIALS> -- uvx scalably-ga4-mcp.
Что делает Google Analytics 4 MCP?
Он подключает агента к данным GA4 для чтения отчётов и административной информации. В наборе есть инструменты для обычных, пакетных, оперативных и воронковых отчётов.
Что нужно настроить для доступа к свойствам GA4?
Включите Google Analytics Data API и Google Analytics Admin API в Google Cloud, создайте сервисный аккаунт и добавьте его адрес с ролью Viewer к каждому нужному свойству.
