zaDojoGoogle Analytics MCP: GA4 для AI-агентів
Підключи Google Analytics 4 до Claude, ChatGPT, Cursor або Codex без Google Cloud. Тринадцять інструментів лише для читання, а читання GA4 безкоштовне.
Автор: Denis Veisllari
MCP-сервер zaDojo дає твоєму AI-агенту змогу читати твою властивість Google Analytics 4: відвідувачів, сесії, перегляди сторінок, показник відмов, ключові події та дохід із розбивкою за каналом, сторінкою, країною, містом, пристроєм чи браузером, а також хто зараз на сайті. GA4 підключається всередині zaDojo через звичайний вхід Google, тож не потрібні ні проєкт Google Cloud, ні ввімкнення API, ні файл облікових даних. Читання Google Analytics не витрачає кредитів, а ті самі дані відображаються як дашборд у застосунку zaDojo.
Підключення у три кроки
- Створи акаунт zaDojo і проєкт для свого сайту. Для реєстрації картка не потрібна.
- У проєкті відкрий My Site > Analytics і підключи Google Analytics. Увійди через акаунт Google, який має доступ до властивості GA4, підтвердь доступ лише для читання і обери властивість.
- Додай адресу сервера нижче у свій AI-клієнт і підтвердь вхід у 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 і встав URL.
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 його вказує.
FAQ
Чи потрібен мені проєкт Google Cloud?
Ні. Ти входиш через Google усередині zaDojo і підтверджуєш доступ лише для читання. zaDojo бере підключення до API на себе.
Чи витрачає читання Google Analytics кредити?
Ні. Читання Google Analytics і Search Console не витрачає кредитів ні в застосунку, ні через агента.
Чи може агент щось змінити в Google Analytics?
Ні. zaDojo запитує доступ analytics.readonly, тож агент може читати звіти, але не може змінювати налаштування, події чи користувачів.
Які AI-клієнти можуть цим користуватися?
Claude Code, Claude Desktop, Cursor, Codex CLI, Codex у настільному застосунку ChatGPT, ChatGPT із власним підключенням та інші клієнти з підтримкою віддалених MCP-серверів.
Чи працює це з Universal Analytics?
Ні. Читаються лише властивості GA4.