Підключення GA4 до Claude Code допомагає розробникам зіставити інструментацію подій із даними Analytics. Воно додає звітні інструменти до сеансу роботи з кодом без Google-облікових даних у репозиторії. Перевірте контракт подій, а потім визначте, де потрібен наступний крок: у коді, Tag Manager чи конфігурації GA4.
Що потрібно перед підключенням?
Установіть Claude Code на комп'ютері, де виконуватимете команди. CLI підтримує віддалені HTTP MCP-сервери та браузерний OAuth. Цей спосіб явно додає сервер на рівні користувача для роботи в різних проєктах; спільна конфігурація команди на рівні проєкту є окремим вибором. Локальний сервер Google API запускати не потрібно.
- Google-акаунт із доступом до потрібного ресурсу GA4.
- Акаунт LoomaScale та підключення Google Analytics: підключення Google Ads саме по собі не надає доступу до Analytics.
- Числовий ID ресурсу або можливість знайти його в переліку акаунтів. Ідентифікатор вимірювання G- належить вебпотоку, а не ресурсу для звітів.
Як підключити Claude Code до GA4?
1. Підключіть GA4 у LoomaScale
Створіть акаунт LoomaScale або увійдіть до нього, а потім відкрийте підключення. Виберіть Google Analytics, увійдіть Google-адресою з доступом до потрібних даних і перегляньте запитувані дозволи. Вхід до LoomaScale через Google не замінює підключення цього джерела даних. Цей сервіс можна підключити без рекламного акаунта.
2. Зареєструйте віддалений MCP-сервер у Claude Code
Виконайте команду в системному терміналі поза розмовою Claude Code. Рівень користувача робить підключення доступним у різних проєктах. URL обирає інструменти цього сервісу Google.
claude mcp add --transport http --scope user loomascale-ga4 https://api.loomascale.com/mcp/ga4Якщо вже використовуєте повний агентський плагін LoomaScale, перевірте його інструменти, перш ніж додавати друге підключення. Спосіб із плагіном описано в інструкції Claude Code; тут використовується пряме налаштування MCP.
3. Увійдіть через MCP-меню Claude Code
Відкрийте Claude Code та введіть /mcp. Виберіть loomascale-ga4 і завершіть автентифікацію в браузері акаунтом LoomaScale з підключеним джерелом Google. Поверніться до Claude Code й перевірте статус підключення. У системному терміналі можна переглянути збережений сервер через claude mcp get loomascale-ga4 або claude mcp list. Успішна команда додавання зберігає конфігурацію, але не доводить успішного отримання Google-акаунтів.
4. Перевірте доступ справжнім запитом акаунтів
Через LoomaScale викличте ga4_get_account_summaries. Покажіть доступні мені ресурси GA4 з назвами та числовими ID. Запитайте, який ресурс використовувати. Прочитайте його часовий пояс звітності та валюту. Нічого не змінюйте в налаштуваннях.
У відповіді мають бути ресурси вашого Google-акаунта з ідентифікатором на зразок properties/123456789. Виберіть ресурс за назвою та ID й використовуйте його в наступних запитах. Опис GA4 або приклад панелі не підтверджує отримання даних конектором. Порожній перелік може бути коректною відповіддю для акаунта без доступних ресурсів.
Як перевірити контракт подій через Claude Code та GA4?
Почніть із події, яку можна знайти в репозиторії, наприклад generate_lead. Попросіть Claude Code зафіксувати написання та умови її надсилання сайтом. Потім зіставте контракт зі спостереженими назвами та недавніми кількостями подій GA4. Відсутність події є підставою для перевірки, а не автоматичним доказом, що код не виконувався.
Через LoomaScale використайте вибраний ресурс GA4. Без редагування файлів прочитайте інструментацію подій форми заявки в репозиторії. Визначте очікувані назви подій та умови спрацювання. Покажіть eventCount за eventName за останні 7 повних днів і перевірте очікувані назви. За потреби окремо запросіть події в реальному часі. Поясніть, що доводить звіт і що потребує тесту браузером. Не створюйте подій і не змінюйте налаштування.
Відрізняйте розбіжність назв від збою збору. Нещодавня подія може ще не бути в звіті за дати через обробку; результат у реальному часі відповідає на питання про інше вікно часу. Перед зміною коду перевірте ресурс і потік. Якщо потрібен тест браузером, виконайте його у відповідному тестовому середовищі сайту й перевірте фактично надіслані запити.
Яку адресу MCP використовує ця інструкція?
https://api.loomascale.com/mcp/ga4Адреса окремого сервісу надає інструменти GA4 та допоміжні інструменти акаунта LoomaScale. Повний плагін або конектор із каталогу використовує https://api.loomascale.com/mcp і працює з усіма окремо підключеними джерелами. Для роботи між сервісами виберіть повне підключення; для інструментів одного джерела — окрему адресу. Вибір адреси обмежує набір інструментів, а не ролі вашого Google-акаунта.
Що Claude Code може читати або змінювати в GA4?
LoomaScale отримує звіти про трафік, залучення, ключові події, дохід, активність у реальному часі та воронки. Почніть зі звітів і задайте дати, параметри й показники. Інструменти конфігурації можуть позначати ключові події, додавати чи змінювати правила подій, налаштовувати розширене вимірювання й приховування даних, створювати чи перейменовувати вебпотоки після того, як ви погодите пробний запуск; вони потребують ролі Editor у ресурсі та дозволу analytics.edit, наданого під час підключення, а доступ до звітів не дає права редагування. Підключення асистента не встановлює тег на сайт, не створює минулих подій і не вирівнює атрибуцію GA4 та рекламних платформ.
Чому немає підключення або даних?
Якщо сервер потребує автентифікації, відкрийте /mcp та увійдіть знову. Якщо інструментів немає, перевірте claude mcp list, адресу джерела та обмеження організації. За потреби перезапустіть сеанс після зміни конфігурації. Вебконектор Claude та явно заданий CLI-сервер можуть перетинатися; перевірте активні інструменти перед додаванням дубльованих підключень.
Якщо ресурсу немає, перевірте Google-адресу, доступ до ресурсу та підключення Analytics у LoomaScale. Для порожнього звіту перевірте ресурс, дати, фільтри й надсилання подій із сайту. Порівнюйте рівноцінні періоди в часовому поясі ресурсу. Якщо показники відрізняються, зафіксуйте їхні точні назви та правила атрибуції, перш ніж робити висновки. Використовуйте ID ресурсу для звітів замість ідентифікатора потоку G-.
Пов'язані інструкції та офіційні джерела
Використовуйте GA4 в іншому асистенті
- Як підключити ChatGPT до GA4
- Як підключити Claude до GA4
- Як підключити Codex до GA4
- Як підключити Grok Build до GA4
Підключіть інше джерело Google до Claude Code
Офіційні інструкції налаштування
- Інструкція Anthropic про MCP, рівні конфігурації та вхід у Claude Code
- Довідник Google про ID ресурсу GA4
Джерела налаштування перевірено 12 листопада 2026 року. Назви меню та політики робочих просторів можуть змінюватися; звірте свій акаунт з інструкціями постачальників за посиланнями. Підтримувані процеси LoomaScale описано в центрі документації.
