zaDojoGoogle Analytics MCP: данные GA4 для ИИ-агентов
Подключите Google Analytics 4 к Claude, ChatGPT, Cursor или Codex без проекта Google Cloud. Тринадцать инструментов только для чтения, без расхода кредитов.
Автор: Denis Veisllari
MCP-сервер zaDojo позволяет вашему ИИ-агенту читать ресурс Google Analytics 4: посетителей, сеансы, просмотры страниц, показатель отказов, ключевые события и доход с разбивкой по каналу, странице, стране, городу, устройству или браузеру, а также то, кто находится на сайте прямо сейчас. GA4 подключается внутри zaDojo обычным входом через Google, поэтому не нужны ни проект Google Cloud, ни включение API, ни файл с учётными данными. Чтение Google Analytics не тратит кредиты, а те же данные доступны в виде дашборда в приложении zaDojo.
Подключение в три шага
- Создайте аккаунт zaDojo и проект для своего сайта. Для регистрации карта не нужна.
- В проекте откройте My Site > Analytics и подключите Google Analytics. Войдите через аккаунт Google, у которого есть доступ к ресурсу GA4, подтвердите доступ только для чтения и выберите ресурс.
- Добавьте адрес сервера ниже в свой ИИ-клиент и подтвердите вход в zaDojo при первом подключении.
https://app.zadojo.com/mcpClaude Code
claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcpCodex CLI
codex mcp add zadojo --url https://app.zadojo.com/mcpCursor: добавьте это в mcp.json в разделе Settings > Tools & Integrations > MCP Tools.
{
"mcpServers": {
"zadojo": {
"url": "https://app.zadojo.com/mcp"
}
}
}Claude Desktop: откройте Customize > Connectors, выберите Add custom connector и вставьте адрес.
ChatGPT требует пользовательского подключения; в руководстве для ChatGPT перечислены шаги и тарифы, которые это поддерживают. Другие клиенты с поддержкой удалённых MCP-серверов принимают тот же адрес, а руководство по настройке MCP описывает каждый клиент.
Что может читать ваш агент
Каждый инструмент отвечает на один тип вопросов, поэтому агент выбирает нужный отчёт по вашему вопросу, а не собирает запрос к GA4 с нуля.
| Ваш вопрос | Инструмент |
|---|---|
| Как работает весь сайт по сравнению с предыдущим периодом? | get_google_analytics_traffic_overview |
| Какие страны, регионы, города, браузеры или источники лидируют? | get_google_analytics_breakdown |
| Сколько человек на сайте прямо сейчас? | get_google_analytics_realtime_users |
| Растёт ли трафик из органического поиска? | get_google_analytics_organic_overview |
| Какие страницы приводят органических посетителей? | get_google_analytics_organic_landing_pages |
| Какие страницы читают и как долго? | get_google_analytics_page_performance |
| Какие каналы, источники или кампании приводят сеансы? | get_google_analytics_traffic_acquisition |
| Какие ключевые события происходят и после каких страниц входа? | get_google_analytics_key_events |
| Какие товары и страницы входа приносят доход? | get_google_analytics_ecommerce_performance |
| Что посетители ищут на сайте? | get_google_analytics_site_search |
| Какие устройства и страны, сколько вернувшихся посетителей? | get_google_analytics_audience_breakdown |
| Правильно ли настроено отслеживание? | get_google_analytics_measurement_health |
| Какие страницы рядом с первой страницей выдачи стоит улучшить? | get_search_opportunities |
Обзор трафика и разбивки
Обзор трафика охватывает все каналы. Он возвращает посетителей (активных пользователей GA4), сеансы, просмотры страниц, показатель отказов, среднюю длительность сеанса, ключевые события и доход от покупок, каждый показатель в сравнении с предыдущим периодом той же длины, а также динамику по дням.
Обзор и разбивка принимают одни и те же фильтры: канал, источник, кампания, страница входа, страница, страна, регион, город, устройство, браузер и операционная система. Фильтры комбинируются, поэтому один вопрос может сузить цифры до «мобильных посетителей из Германии, пришедших из Google». Разбивка показывает 50 главных значений одного из этих измерений, и так агент переходит от стран к городам внутри одной страны.
Search Console и GA4 вместе
Если в проекте также подключён Search Console, get_search_opportunities объединяет оба источника. Он берёт страницы на позициях с 4 по 20 в Search Console, сопоставляет их с сеансами и ключевыми событиями в GA4 и оценивает по спросу, ценности для бизнеса и близости к первой странице. Страницы, по которым в GA4 нет данных, остаются в списке без оценки.
Те же данные в виде дашборда
Чтобы увидеть цифры, агент не нужен. После подключения GA4 раздел My Site > Analytics в приложении zaDojo показывает:
- семь главных показателей (посетители, сеансы, просмотры страниц, показатель отказов, средний сеанс, ключевые события и доход), каждый с изменением относительно предыдущего периода;
- дневной график для любого выбранного показателя;
- четыре панели: Sources (канал, источник, кампания), Pages (страница входа, страница), Locations (страна, регион, город) и Devices (устройство, браузер, операционная система);
- живой счётчик посетителей на сайте за последние 30 минут, который обновляется каждую минуту.
Нажмите на любую строку, например на страну или браузер, и вся страница сузится до неё. Фильтры складываются, а период можно выбрать: последние 7, 28 или 90 дней, последние 12 месяцев или свои даты. Просмотр дашборда не тратит кредиты.
Вопросы, которые стоит задать
- «Как изменился мобильный трафик из Германии за последние 7 дней по сравнению с предыдущей неделей?»
- «Какие города США прислали больше всего посетителей в этом месяце?»
- «Какие страницы входа приводят органических посетителей, которые потом регистрируются?»
- «Есть ли кто-нибудь на сайте прямо сейчас?»
- «Какие страницы находятся на второй странице в Search Console и уже конвертируют в GA4?»
- «Включено ли отслеживание поиска по сайту и какие ключевые события настроены?»
Сколько это стоит
Чтение Google Analytics не тратит кредиты, сколько бы вопросов вы ни задали, а дашборд можно смотреть бесплатно. Подключить GA4 на новом аккаунте можно без ввода карты.
То же MCP-подключение обслуживает и платные исследовательские инструменты zaDojo, например подбор ключевых слов (около 0,07 € за поиск), обратные ссылки и отслеживание позиций. Они расходуют кредиты: тариф стоит 10 € в месяц и включает 10 € использования. В описании каждого инструмента сказано, тратит ли он кредиты, поэтому агент различает одни и другие.
Только чтение, и это намеренно
zaDojo запрашивает у Google область доступа analytics.readonly. Агент может читать отчёты, но не может менять настройки, редактировать ключевые события, добавлять пользователей или трогать код отслеживания. Отключиться можно в zaDojo в любой момент или отозвать доступ zaDojo в настройках аккаунта Google.
Сравнение с собственным MCP-сервером Google
Google публикует MCP-сервер Google Analytics с открытым кодом, помеченный как экспериментальный. Он работает на вашем компьютере на Python, и настраивать его нужно самостоятельно:
- Создайте или выберите проект Google Cloud.
- Включите Google Analytics Admin API и Data API.
- Настройте учётные данные с областью доступа
analytics.readonlyчерез OAuth-клиент или сервисный аккаунт. - Укажите серверу файл с учётными данными и ID проекта.
| zaDojo MCP | MCP-сервер Analytics от Google | |
|---|---|---|
| Где работает | В облаке, один адрес | На вашем компьютере (Python) |
| Настройка Google Cloud | Не нужна, вы входите через Google | Проект, два API и файл с учётными данными |
| Инструменты | 13 инструментов, каждый для одного типа вопросов | Общие инструменты, например run_report |
| Реальное время | Посетители за последние 30 минут | Да, через run_realtime_report |
| Связка с Search Console | Да | Нет |
| Стоимость | Чтение GA4 не тратит кредиты | Бесплатно, открытый код |
Сервер Google лучше, если вы хотите держать всё на своей машине или вам нужны отчёты, которых нет в zaDojo, например воронки или пользовательские параметры. zaDojo подходит тем, кто хочет получить данные GA4 в агенте уже сегодня, рядом с инструментами Search Console, ключевых слов и позиций, ничего не устанавливая.
Ограничения, которые нужно знать
- Отчёты охватывают только полные дни. Периоды заканчиваются вчерашним днём в часовом поясе вашего ресурса.
- Google скрывает или выборочно обрабатывает часть данных ради конфиденциальности. В таких случаях инструменты помечают отчёт как ограниченный, а отсутствующие строки означают «неизвестно», а не ноль.
- Разбивки возвращают 50 главных значений. Свой период может охватывать до 366 дней.
- Фильтры требуют точного совпадения. Страны задаются двухбуквенными кодами, например DE, и надёжнее всего фильтровать по значениям, которые вернула разбивка.
- Счётчик в реальном времени охватывает весь сайт и не принимает фильтров.
- Демографии, данных на уровне пользователя и пользовательских параметров нет.
- Только ресурсы GA4. Подключаемый аккаунт Google должен иметь доступ к ресурсу.
- Google ограничивает объём отчётов, который каждый ресурс может запросить в час и в день. Отчёты показывают остаток квоты, когда Google его сообщает. Если квота исчерпана, инструменты возвращают ошибку вместо неполных цифр и время повтора, если Google его указывает.
Частые вопросы
Нужен ли проект Google Cloud?
Нет. Вы входите через Google внутри zaDojo и подтверждаете доступ только для чтения. Подключение к API берёт на себя zaDojo.
Тратит ли чтение Google Analytics кредиты?
Нет. Чтение Google Analytics и Search Console не тратит кредиты ни в приложении, ни через агента.
Может ли агент что-то изменить в Google Analytics?
Нет. zaDojo запрашивает область доступа analytics.readonly, поэтому агент может читать отчёты, но не может менять настройки, события или пользователей.
Какие ИИ-клиенты могут это использовать?
Claude Code, Claude Desktop, Cursor, Codex CLI, Codex в настольном приложении ChatGPT, ChatGPT с пользовательским подключением и другие клиенты с поддержкой удалённых MCP-серверов.
Работает ли это с Universal Analytics?
Нет. Читаются только ресурсы GA4.