zaDojoGoogle Analytics MCP: dane GA4 dla agentów AI
Podłącz Google Analytics 4 do Claude, ChatGPT, Cursor lub Codex bez projektu Google Cloud. Trzynaście narzędzi tylko do odczytu, odczyty GA4 bez kredytów.
Autor: Denis Veisllari
Serwer MCP zaDojo pozwala Twojemu agentowi AI czytać usługę Google Analytics 4: odwiedzających, sesje, odsłony, współczynnik odrzuceń, kluczowe zdarzenia i przychody, w podziale na kanał, stronę, kraj, miasto, urządzenie lub przeglądarkę, a także to, kto jest na witrynie w tej chwili. GA4 podłączasz w zaDojo zwykłym logowaniem Google, więc nie potrzebujesz projektu Google Cloud, włączania API ani pliku z danymi uwierzytelniającymi. Odczyty z Google Analytics nie zużywają kredytów, a te same dane widać jako panel w aplikacji zaDojo.
Podłączenie w trzech krokach
- Załóż konto w zaDojo i projekt dla swojej witryny. Rejestracja nie wymaga karty.
- W projekcie otwórz My Site > Analytics i podłącz Google Analytics. Zaloguj się kontem Google, które ma dostęp do usługi GA4, zatwierdź dostęp tylko do odczytu i wybierz usługę.
- Dodaj poniższy adres serwera do swojego klienta AI i zatwierdź logowanie do zaDojo przy pierwszym połączeniu.
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: dodaj to do mcp.json w Settings > Tools & Integrations > MCP Tools.
{
"mcpServers": {
"zadojo": {
"url": "https://app.zadojo.com/mcp"
}
}
}Claude Desktop: otwórz Customize > Connectors, wybierz Add custom connector i wklej adres URL.
ChatGPT wymaga własnego połączenia; przewodnik ChatGPT opisuje kroki i plany, które je obsługują. Inne klienty obsługujące zdalne serwery MCP przyjmują ten sam adres, a przewodnik konfiguracji MCP omawia każdego z nich.
Co może czytać Twój agent
Każde narzędzie odpowiada na jeden rodzaj pytania, więc agent wybiera właściwy raport na podstawie Twojego pytania, zamiast budować zapytanie GA4 od zera.
| Twoje pytanie | Narzędzie |
|---|---|
| Jak radzi sobie cała witryna w porównaniu z poprzednim okresem? | get_google_analytics_traffic_overview |
| Które kraje, regiony, miasta, przeglądarki lub źródła prowadzą? | get_google_analytics_breakdown |
| Ile osób jest teraz na witrynie? | get_google_analytics_realtime_users |
| Czy ruch z wyszukiwania organicznego rośnie? | get_google_analytics_organic_overview |
| Które strony przyciągają odwiedzających z wyników organicznych? | get_google_analytics_organic_landing_pages |
| Które strony są czytane i jak długo? | get_google_analytics_page_performance |
| Które kanały, źródła lub kampanie dają sesje? | get_google_analytics_traffic_acquisition |
| Jakie kluczowe zdarzenia zachodzą i po których stronach docelowych? | get_google_analytics_key_events |
| Które produkty i strony docelowe przynoszą przychód? | get_google_analytics_ecommerce_performance |
| Czego odwiedzający szukają na witrynie? | get_google_analytics_site_search |
| Jakie urządzenia i kraje, ilu powracających odwiedzających? | get_google_analytics_audience_breakdown |
| Czy śledzenie jest poprawnie skonfigurowane? | get_google_analytics_measurement_health |
| Które strony blisko pierwszej strony wyników warto poprawić? | get_search_opportunities |
Przegląd ruchu i podziały
Przegląd ruchu obejmuje wszystkie kanały. Zwraca odwiedzających (aktywnych użytkowników w GA4), sesje, odsłony, współczynnik odrzuceń, średni czas sesji, kluczowe zdarzenia i przychód z zakupów, każde porównane z poprzednim okresem tej samej długości, oraz trend dzień po dniu.
Przegląd i podział przyjmują te same filtry: kanał, źródło, kampania, strona docelowa, strona, kraj, region, miasto, urządzenie, przeglądarka i system operacyjny. Filtry można łączyć, więc jedno pytanie może zawęzić liczby do „odwiedzających na urządzeniach mobilnych z Niemiec, którzy przyszli z Google”. Podział wypisuje 50 najczęstszych wartości jednego z tych wymiarów; w ten sposób agent schodzi od krajów do miast w jednym kraju.
Search Console i GA4 razem
Jeśli projekt ma też podłączone Search Console, get_search_opportunities łączy oba źródła. Bierze strony na pozycjach od 4 do 20 w Search Console, dopasowuje je do ich sesji i kluczowych zdarzeń w GA4 i ocenia je według popytu, wartości biznesowej i odległości od pierwszej strony. Strony, dla których GA4 nie ma danych, zostają na liście bez oceny.
Te same dane jako panel
Do zobaczenia liczb nie potrzebujesz agenta. Po podłączeniu GA4 My Site > Analytics w aplikacji zaDojo pokazuje:
- siedem głównych liczb (odwiedzający, sesje, odsłony, współczynnik odrzuceń, średnia sesja, kluczowe zdarzenia i przychód), każdą ze zmianą względem poprzedniego okresu;
- wykres dzienny dla wybranej z tych liczb;
- cztery panele: Sources (kanał, źródło, kampania), Pages (strona docelowa, strona), Locations (kraj, region, miasto) i Devices (urządzenie, przeglądarka, system operacyjny);
- bieżącą liczbę odwiedzających na witrynie w ostatnich 30 minutach, odświeżaną co minutę.
Kliknij dowolny wiersz, na przykład kraj lub przeglądarkę, a cała strona zawęzi się do niego. Filtry się sumują, a zakres możesz wybrać jako ostatnie 7, 28 lub 90 dni, ostatnie 12 miesięcy albo własne daty. Przeglądanie panelu nie zużywa kredytów.
Pytania warte zadania
- „Jak zmienił się ruch mobilny z Niemiec w ostatnich 7 dniach w porównaniu z tygodniem wcześniej?”
- „Które miasta w USA dały najwięcej odwiedzających w tym miesiącu?”
- „Które strony docelowe przyciągają odwiedzających z wyników organicznych, którzy potem się rejestrują?”
- „Czy ktoś jest teraz na witrynie?”
- „Które strony są na drugiej stronie wyników w Search Console i już konwertują w GA4?”
- „Czy śledzenie wyszukiwania w witrynie jest włączone i jakie kluczowe zdarzenia są skonfigurowane?”
Ile to kosztuje
Odczyty z Google Analytics nie zużywają kredytów, niezależnie od liczby pytań, a panel można oglądać za darmo. GA4 podłączysz na nowym koncie bez podawania karty.
To samo połączenie MCP obsługuje też płatne narzędzia badawcze zaDojo, takie jak badanie słów kluczowych (około 0,07 € za wyszukiwanie), backlinki i śledzenie pozycji. Te zużywają kredyty: plan kosztuje 10 € miesięcznie i zawiera 10 € na użycie. Opis każdego narzędzia mówi, czy zużywa kredyty, więc agent potrafi je odróżnić.
Z założenia tylko do odczytu
zaDojo prosi Google o zakres analytics.readonly. Agent może czytać raporty. Nie może zmieniać ustawień, edytować kluczowych zdarzeń, dodawać użytkowników ani ruszać Twojego kodu śledzenia. Możesz w każdej chwili odłączyć usługę w zaDojo albo usunąć dostęp zaDojo w ustawieniach konta Google.
Porównanie z serwerem MCP od Google
Google publikuje open source'owy serwer MCP dla Google Analytics, oznaczony jako eksperymentalny. Działa na Twoim komputerze w Pythonie i konfigurujesz go sam:
- Utwórz lub wybierz projekt Google Cloud.
- Włącz Google Analytics Admin API i Data API.
- Skonfiguruj dane uwierzytelniające z zakresem
analytics.readonlyprzez klienta OAuth lub konto usługi. - Wskaż serwerowi plik z danymi uwierzytelniającymi i identyfikator projektu.
| zaDojo MCP | Serwer Analytics MCP od Google | |
|---|---|---|
| Gdzie działa | Hostowany, jeden adres URL | Na Twoim komputerze (Python) |
| Konfiguracja Google Cloud | Brak, logujesz się przez Google | Projekt, dwa API i plik z danymi uwierzytelniającymi |
| Narzędzia | 13 narzędzi, każde do jednego rodzaju pytania | Ogólne narzędzia, takie jak run_report |
| Czas rzeczywisty | Odwiedzający z ostatnich 30 minut | Tak, przez run_realtime_report |
| Połączenie z Search Console | Tak | Nie |
| Koszt | Odczyty GA4 nie zużywają kredytów | Darmowy i open source |
Serwer Google to lepszy wybór, jeśli chcesz mieć wszystko na własnym komputerze albo potrzebujesz raportów, których zaDojo nie oferuje, takich jak ścieżki czy wymiary niestandardowe. zaDojo pasuje tym, którzy chcą mieć dane GA4 w agencie od razu, obok Search Console, narzędzi do słów kluczowych i pozycji, bez niczego do instalowania.
Ograniczenia
- Raporty obejmują tylko pełne dni. Zakresy kończą się na wczoraj, w strefie czasowej Twojej usługi.
- Google ukrywa lub próbkuje część danych ze względu na prywatność. Wtedy narzędzia oznaczają raport jako ograniczony, a brakujące wiersze są nieznane, a nie zerowe.
- Podziały zwracają 50 najczęstszych wartości. Własne zakresy dat mogą obejmować do 366 dni.
- Filtry dopasowują dokładnie. Kraje używają dwuliterowych kodów, takich jak DE, a najbezpieczniejsze wartości do filtrowania to te zwrócone przez podział.
- Liczba w czasie rzeczywistym obejmuje całą witrynę i nie przyjmuje filtrów.
- Brak danych demograficznych, danych na poziomie użytkownika i wymiarów niestandardowych.
- Tylko usługi GA4. Podłączane konto Google musi mieć dostęp do usługi.
- Google ogranicza liczbę raportów, jakie każda usługa może wykonać na godzinę i na dzień. Raporty pokazują pozostały limit, gdy Google go przesyła. Gdy limit się wyczerpie, narzędzia zwracają błąd zamiast częściowych liczb, z czasem ponowienia, jeśli Google go poda.
FAQ
Czy potrzebuję projektu Google Cloud?
Nie. Logujesz się przez Google w zaDojo i zatwierdzasz dostęp tylko do odczytu. Połączeniem z API zajmuje się zaDojo.
Czy odczyty z Google Analytics zużywają kredyty?
Nie. Odczyty z Google Analytics i Search Console nie zużywają kredytów, ani w aplikacji, ani przez agenta.
Czy agent może coś zmienić w Google Analytics?
Nie. zaDojo prosi o zakres analytics.readonly, więc agent może czytać raporty, ale nie może zmieniać ustawień, zdarzeń ani użytkowników.
Których klientów AI można użyć?
Claude Code, Claude Desktop, Cursor, Codex CLI, Codex w aplikacji desktopowej ChatGPT, ChatGPT z własnym połączeniem i innych klientów obsługujących zdalne serwery MCP.
Czy działa z Universal Analytics?
Nie. Czyta tylko usługi GA4.