zaDojoGoogle Analytics MCP: AI ajanlarına ücretsiz GA4
Google Analytics 4'ü Google Cloud projesi olmadan Claude, ChatGPT, Cursor veya Codex'e bağla. On üç salt okunur araç; GA4 okumaları kredi harcamaz.
Yazar: Denis Veisllari
zaDojo'nun MCP sunucusu, yapay zekâ ajanının Google Analytics 4 mülkünü okumasını sağlar: ziyaretçiler, oturumlar, sayfa görüntülemeleri, hemen çıkma oranı, önemli etkinlikler ve gelir; kanala, sayfaya, ülkeye, şehre, cihaza ya da tarayıcıya göre ayrılmış olarak, ayrıca şu anda sitede kimin olduğu. GA4'ü zaDojo içinde normal bir Google girişiyle bağlarsın, yani Google Cloud projesi, etkinleştirilecek API ya da kimlik bilgisi dosyası yok. Google Analytics okumak kredi harcamaz ve aynı veriler zaDojo uygulamasında bir pano olarak da görünür.
Üç adımda bağla
- Bir zaDojo hesabı ve siten için bir proje oluştur. Kayıt için kart gerekmez.
- Projede My Site > Analytics bölümünü aç ve Google Analytics'i bağla. GA4 mülkünü görebilen bir Google hesabıyla giriş yap, salt okunur erişimi onayla ve mülkü seç.
- Aşağıdaki sunucu URL'sini yapay zekâ istemcine ekle ve ilk bağlandığında zaDojo girişini onayla.
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: bunu Settings > Tools & Integrations > MCP Tools altındaki mcp.json dosyasına ekle.
{
"mcpServers": {
"zadojo": {
"url": "https://app.zadojo.com/mcp"
}
}
}Claude Desktop: Customize > Connectors bölümünü aç, Add custom connector'ı seç ve URL'yi yapıştır.
ChatGPT özel bir bağlantı gerektirir; ChatGPT rehberi adımları ve bunu destekleyen planları listeler. Uzak MCP sunucularını destekleyen diğer istemciler de aynı URL'yi kullanır ve MCP kurulum rehberi her istemciyi ele alır.
Ajanının okuyabildikleri
Her araç tek bir soru türünü yanıtlar, böylece ajanın sıfırdan bir GA4 sorgusu kurmak yerine sorundan doğru raporu seçer.
| Sorun | Araç |
|---|---|
| Sitenin tamamı önceki döneme göre nasıl gidiyor? | get_google_analytics_traffic_overview |
| Hangi ülkeler, bölgeler, şehirler, tarayıcılar ya da kaynaklar önde? | get_google_analytics_breakdown |
| Şu anda sitede kaç kişi var? | get_google_analytics_realtime_users |
| Organik arama trafiği büyüyor mu? | get_google_analytics_organic_overview |
| Hangi sayfalar organik ziyaretçi getiriyor? | get_google_analytics_organic_landing_pages |
| Hangi sayfalar okunuyor ve ne kadar süreyle? | get_google_analytics_page_performance |
| Hangi kanallar, kaynaklar ya da kampanyalar oturum gönderiyor? | get_google_analytics_traffic_acquisition |
| Hangi önemli etkinlikler oluyor ve hangi açılış sayfalarından sonra? | get_google_analytics_key_events |
| Hangi ürünler ve açılış sayfaları gelir getiriyor? | get_google_analytics_ecommerce_performance |
| Ziyaretçiler sitede ne arıyor? | get_google_analytics_site_search |
| Hangi cihazlar ve ülkeler, ve kaç geri dönen ziyaretçi var? | get_google_analytics_audience_breakdown |
| İzleme doğru kurulmuş mu? | get_google_analytics_measurement_health |
| İlk sayfaya yakın hangi sayfalar iyileştirmeye değer? | get_search_opportunities |
Trafiğe genel bakış ve kırılımlar
Trafiğe genel bakış tüm kanalları kapsar. Ziyaretçileri (GA4'ün aktif kullanıcıları), oturumları, sayfa görüntülemelerini, hemen çıkma oranını, ortalama oturum süresini, önemli etkinlikleri ve satın alma gelirini döndürür; her birini aynı uzunluktaki önceki dönemle karşılaştırır ve günlük bir trend ekler.
Genel bakış ve kırılım aynı filtreleri alır: kanal, kaynak, kampanya, açılış sayfası, sayfa, ülke, bölge, şehir, cihaz, tarayıcı ve işletim sistemi. Filtreler birleşir, böylece tek bir soru rakamları "Google'dan gelen, Almanya'daki mobil ziyaretçiler" diye daraltabilir. Kırılım, bu boyutlardan birinin ilk 50 değerini listeler; bir ajan ülkelerden tek bir ülkenin içindeki şehirlere bu şekilde iner.
Search Console ve GA4 birlikte
Projede Search Console da bağlıysa, get_search_opportunities ikisini birleştirir. Search Console'da 4 ile 20 arası pozisyonda sıralanan sayfaları alır, bunları GA4 oturumları ve önemli etkinlikleriyle eşler ve talebe, iş değerine ve ilk sayfaya ne kadar yakın olduklarına göre puanlar. GA4'te verisi olmayan sayfalar puansız olarak listede kalır.
Aynı veriler pano olarak
Rakamları görmek için bir ajana ihtiyacın yok. GA4 bağlandıktan sonra zaDojo uygulamasındaki My Site > Analytics şunları gösterir:
- yedi ana rakam (ziyaretçiler, oturumlar, sayfa görüntülemeleri, hemen çıkma oranı, ortalama oturum, önemli etkinlikler ve gelir), her biri önceki döneme göre değişimiyle;
- bu rakamlardan seçtiğin biri için günlük bir grafik;
- dört panel: Sources (kanal, kaynak, kampanya), Pages (açılış sayfası, sayfa), Locations (ülke, bölge, şehir) ve Devices (cihaz, tarayıcı, işletim sistemi);
- son 30 dakikada sitedeki ziyaretçilerin her dakika yenilenen canlı sayısı.
Herhangi bir satıra, örneğin bir ülkeye ya da bir tarayıcıya tıkla, sayfanın tamamı ona göre daralır. Filtreler üst üste eklenir; son 7, 28 ya da 90 günü, son 12 ayı veya kendi tarihlerini seçebilirsin. Panoyu görüntülemek kredi harcamaz.
Sormaya değer sorular
- "Almanya'dan gelen mobil trafik son 7 günde önceki haftaya göre nasıl değişti?"
- "Bu ay en çok ziyaretçiyi hangi ABD şehirleri gönderdi?"
- "Hangi açılış sayfaları sonradan kaydolan organik ziyaretçiler getiriyor?"
- "Şu anda sitede kimse var mı?"
- "Search Console'da ikinci sayfada sıralanan ve GA4'te zaten dönüşüm getiren sayfalar hangileri?"
- "Site içi arama takibi açık mı ve hangi önemli etkinlikler kurulu?"
Maliyeti ne
Google Analytics okumaları, kaç soru sorarsan sor kredi harcamaz ve panoyu görüntülemek ücretsizdir. Yeni bir hesapta kart girmeden GA4'ü bağlayabilirsin.
Aynı MCP bağlantısı, anahtar kelime araştırması (arama başına yaklaşık 0,07 €), backlinkler ve sıralama takibi gibi zaDojo'nun ücretli araştırma araçlarına da hizmet eder. Bunlar kredi kullanır: plan ayda 10 €'dur ve 10 € kullanım içerir. Her aracın açıklaması kredi kullanıp kullanmadığını söyler, böylece ajanın ikisini ayırt edebilir.
Tasarım gereği salt okunur
zaDojo, Google'dan analytics.readonly kapsamını ister. Ajanın raporları okuyabilir. Ayarları değiştiremez, önemli etkinlikleri düzenleyemez, kullanıcı ekleyemez ya da izleme koduna dokunamaz. zaDojo'da istediğin zaman bağlantıyı kesebilir ya da zaDojo'nun erişimini Google hesap ayarlarından kaldırabilirsin.
Google'ın kendi MCP sunucusuyla karşılaştırma
Google, deneysel olarak işaretlenmiş açık kaynaklı bir Google Analytics MCP sunucusu yayınlıyor. Python ile kendi bilgisayarında çalışır ve kurulumu sen yaparsın:
- Bir Google Cloud projesi oluştur ya da seç.
- Google Analytics Admin API ve Data API'yi etkinleştir.
- Bir OAuth istemcisi ya da hizmet hesabı üzerinden
analytics.readonlykapsamıyla kimlik bilgilerini kur. - Sunucuyu kimlik bilgisi dosyasına ve proje kimliğine yönlendir.
| zaDojo MCP | Google'ın Analytics MCP sunucusu | |
|---|---|---|
| Nerede çalışır | Barındırılan, tek bir URL | Senin bilgisayarında (Python) |
| Google Cloud kurulumu | Yok, Google ile giriş yaparsın | Proje, iki API ve bir kimlik bilgisi dosyası |
| Araçlar | Her biri tek bir soru türü için 13 araç | run_report gibi genel araçlar |
| Gerçek zamanlı | Son 30 dakikadaki ziyaretçiler | Var, run_realtime_report üzerinden |
| Search Console birleşimi | Var | Yok |
| Maliyet | GA4 okumaları kredi harcamaz | Ücretsiz ve açık kaynak |
Her şeyin kendi makinende olmasını istiyorsan ya da huniler veya özel boyutlar gibi zaDojo'nun sunmadığı raporlara ihtiyacın varsa Google'ın sunucusu daha iyi bir seçim. zaDojo ise GA4 verilerini bugün, Search Console, anahtar kelime ve sıralama araçlarının yanında, hiçbir şey kurmadan ajanında görmek isteyenlere uyar.
Bilinmesi gereken sınırlar
- Raporlar yalnızca tamamlanmış günleri kapsar. Aralıklar, mülkünün saat diliminde dünde biter.
- Google gizlilik nedeniyle bazı verileri gizler ya da örnekler. Bu olduğunda araçlar raporu sınırlı olarak işaretler; eksik satırlar sıfır değil, bilinmiyor demektir.
- Kırılımlar ilk 50 değeri döndürür. Özel tarih aralıkları en fazla 366 gün kapsayabilir.
- Filtreler birebir eşleşir. Ülkeler DE gibi iki harfli kodlar kullanır ve filtrelemek için en güvenli değerler bir kırılımın döndürdüğü değerlerdir.
- Gerçek zamanlı sayı sitenin tamamını kapsar ve filtre almaz.
- Demografi, kullanıcı düzeyinde veri ya da özel boyutlar yok.
- Yalnızca GA4 mülkleri. Bağladığın Google hesabının mülke erişimi olmalı.
- Google her mülkün saatte ve günde ne kadar raporlama çalıştırabileceğini sınırlar. Raporlar, Google gönderdiğinde kalan kotayı gösterir. Kota biterse araçlar kısmi rakamlar yerine bir hata döndürür; Google bir yeniden deneme zamanı verirse onu da ekler.
SSS
Bir Google Cloud projesine ihtiyacım var mı?
Hayır. zaDojo içinde Google ile giriş yapar ve salt okunur erişimi onaylarsın. API bağlantısını zaDojo halleder.
Google Analytics'i okumak kredi harcar mı?
Hayır. Google Analytics ve Search Console okumaları, uygulamada da ajanın üzerinden de kredi harcamaz.
Ajan Google Analytics'te bir şey değiştirebilir mi?
Hayır. zaDojo analytics.readonly kapsamını ister, bu yüzden ajan raporları okuyabilir ama ayarları, etkinlikleri ya da kullanıcıları değiştiremez.
Hangi yapay zekâ istemcileri kullanabilir?
Claude Code, Claude Desktop, Cursor, Codex CLI, ChatGPT masaüstü uygulamasındaki Codex, özel bağlantıyla ChatGPT ve uzak MCP sunucularını destekleyen diğer istemciler.
Universal Analytics ile çalışır mı?
Hayır. Yalnızca GA4 mülklerini okur.