Google Analytics MCP nedir? GA4 verisini asistana bağlamak, kurulum ve salt okuma

Asistanına sitenin trafiğini, dönüşümlerini ya da gerçek zamanlı ziyaretçisini sorarsın; Google Analytics MCP GA4 mülkündeki hesap ve mülk özetlerini, özel boyut ve metrikleri, Google Ads bağlantılarını ve standart, gerçek zamanlı, huni ve dönüşüm raporlarını çalıştırır. Google'ın googleanalytics deposundaki açık kaynak yerel MCP sunucusu (Apache-2.0, sürüm 0.7.0). Google'ın sayfası yalnızca okuma isteklerine açık olduğunu, yapılandırmayı ve ayarları düzenleyemediğini yazıyor; kimlik kapsamı da analytics.readonly. README başlığı sunucuyu "deneysel" olarak etiketliyor. Kurulum için Python (pipx), Google Cloud projesi ve iki API'nin etkinleştirilmesi gerekir.

Ne yapar: Asistana GA4 raporlarını okutur
Tür: MCP sunucusu (yerel, açık kaynak)
Yapımcı: Google
Salt okuma: Evet, kapsam düzeyinde
Durum: README: deneysel
Kurulum: Cloud projesi + Python gerekir
Ücret: Sunucu için ücret yok; API kotaları var

Google Analytics MCP ne işe yarar?

MCP, yapay zekâ programlarının dış araçlara bağlanma standardıdır. Google Analytics MCP ile asistan GA4 verilerini senin adına sorgular: hesap ve mülk özetlerini, mülk ayrıntılarını, bağlı Google Ads hesaplarını, mülk notlarını, özel boyut ve metrikleri okur; standart, gerçek zamanlı, huni ve dönüşüm raporları çalıştırır. Hepsi okuma işidir.

SenTrafiği ya da dönüşümü sorarsın

AsistanMCP destekleyen asistan

Google Analytics MCPBilgisayarında, pipx ile

GA4 mülkünStandart, gerçek zamanlı, huni, dönüşüm raporları

Kapsam analytics.readonly: yalnız okur, ayar değiştiremez.

GA4 raporlarını asistana çalıştırtmakNe alırsın: Rapor tablosu, yorumAyrı kurulum gerekir GA4 mülk ayarlarını okumakNe alırsın: Mülk bilgisiAyrı kurulum gerekir

Araç sayısı kaynaklara göre farklı: README yedi araç sayıyor, depodaki ana dalın kodunda dokuz araç tanımlı (mülk notları ve dönüşüm raporu README'de yok). Bu yüzden tek bir sayı verilmiyor.

Kime yarar: GA4 raporlarını elle çekmek yerine asistana sormak isteyen pazarlamacılara ve ajanslara. Ayar değiştirmek için uygun değil.

Google Analytics MCP nasıl kurulur?

Gerekenler: Python 3.10+ ve pipx, gcloud komut satırı, Google Analytics Admin API ve Data API'si etkin bir Google Cloud projesi ve GA4 mülküne erişimi olan bir Google kullanıcısı. Komutlar README'den aynen alındı.

pipx'i kur.
Google Cloud projende Google Analytics Admin API ve Google Analytics Data API'yi etkinleştir.
Uygulama varsayılan kimlik bilgisini analytics.readonly kapsamıyla oluştur; çıktıdaki kimlik dosyası yolunu not al.
MCP istemcine sunucuyu ekle (aşağıdaki sekmeler) ve istemciyi yeniden başlat.

Kimlik bilgisi (ADC)

› gcloud auth application-default login --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform --client-id-file=YOUR_CLIENT_JSON_FILE

Ekle

› claude mcp add analytics-mcp --scope user -e "GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_CREDENTIALS_JSON" -e "GOOGLE_PROJECT_ID=YOUR_PROJECT_ID" -- pipx run analytics-mcp

~/.gemini/settings.json dosyasına şu girdiyi ekle, sonra Gemini'de /mcp yazınca analytics-mcp listede görünmeli:

settings.json

› {"mcpServers":{"analytics-mcp":{"command":"pipx","args":["run","analytics-mcp"],"env":{"GOOGLE_APPLICATION_CREDENTIALS":"PATH_TO_CREDENTIALS_JSON","GOOGLE_PROJECT_ID":"YOUR_PROJECT_ID"}}}}

README yalnız Gemini ve Claude Code için adım veriyor; diğer istemciler için resmî kurulum yok. README'nin metni GOOGLE_CLOUD_PROJECT önerirken örnekleri GOOGLE_PROJECT_ID kullanıyor (kendi içinde tutarsız). Atlas kartındaki --spec analytics-mcp==0.7.0 sabitleme biçimi README'de yok.

Google Analytics MCP nasıl kullanılır?

Kurulumdan sonra isteği normal yazarsın. Önce hangi mülklere erişebildiğini sor.

Mülkleri gör"Google Analytics MCP ile erişebildiğim hesapları ve GA4 mülklerini listele."

Rapor"Son 28 günde en çok oturum getiren 10 kanalı, oturum ve dönüşüm sayılarıyla göster. Hangi mülkten çektiğini yaz."

Gerçek zamanlı"Şu an sitede kaç aktif kullanıcı var ve hangi sayfalarda?"

Raporlarda hangi boyut ve metriği istediğini yaz; uygun olmayan birleşimleri Data API reddeder. Küçük kitle gruplarında yaş, cinsiyet gibi boyutlar gizlilik eşiği yüzünden eşiklenebilir.

Google Analytics MCP hangi istemcilerde çalışır?

Claude CodeVar	README'de claude mcp add adımı var.
Gemini CLI / Code AssistVar	README'de settings.json adımı var.
Diğer MCP istemcileri (Cursor, Codex vb.)Net değil	Resmî kurulum yok; issue'larda bazı kullanıcılar kullanıyor.
Sohbet uygulamaları (claude.ai, ChatGPT)Yok	Sunucu yerel çalışır; belgede uzak bağlayıcı yok.

Google Analytics MCP neye erişir, ayarları değiştirir mi?

Okur

Hesap ve mülk özetleri, mülk ayrıntıları, Google Ads bağlantıları, mülk notları, özel boyut ve metrikler, standart/gerçek zamanlı/huni/dönüşüm raporları.

Yazar

Hiçbir şey: Google'ın sayfası yapılandırma ve ayarların düzenlenemediğini yazıyor; kimlik kapsamı analytics.readonly.

Siler

Silme aracı yok.

Veri

Çalıştırdığın raporların sonuçları bağladığın asistanın bağlamına girer, yani kullandığın yapay zekâ hizmetine gider. API çağrılarına user agent olarak analytics-mcp ve sürüm eklenir.

README sunucuyu "deneysel" olarak etiketliyor ve PyPI paketi Beta durumda. Raporlar kişisel veri içeren boyutlar barındırabilir; neyi asistana okuttuğuna dikkat et.

GitHub Güvenlik Danışmanlıkları ve OSV taraması yapılmadı; kayıtlı uyarı olup olmadığı bilinmiyor. Bu "güvenli" demek değildir.

Google Analytics MCP ücretsiz mi, kotası ne?

Sunucu açık kaynak ve ücret yazmıyor. Data API'nin ücret değil kota sınırları var:

Mülk türü	Çekirdek kota
Standart GA4 mülkü	Günde 200.000 jeton, saatte 40.000; eşzamanlı 10 istek
Analytics 360 mülkü	Günde 2.000.000 jeton, saatte 400.000; eşzamanlı 50 istek

Kaynak: Analytics Data API kotaları sayfası. Gerçek zamanlı ve huni raporları için ayrı satırlar var. Cloud projenin faturalandırması için Google Cloud sayfana bak; TL fiyatı yok. Bu bir mali görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
Windows'ta araç çağrıları dakikalarca sürüyor ya da donuyor	Sürüm notlarında stdio kilitlenmesi düzeltmeleri var (v0.4.0, v0.6.0); güncel sürümü kullan.
Kullanıcıların bildirdiği Claude Code (macOS) altında "Failed to resolve analyticsadmin.googleapis.com"	Açık issue'lar (#179, #180); resmî çözüm yok. Metin gRPC çözümleyicisini işaret ediyor, bu bir kullanıcı teşhisi.
Açılışta "Tool object has no attribute inputSchema"	mcp SDK 2.0.0 uyumsuzluğu; güncel paket mcp 2 öncesi sürümlerle sınırlı (issue #199 kapalı).

Google Analytics MCP nasıl kaldırılır?

Claude Code: claude mcp remove analytics-mcp çalıştır.
Gemini: settings.json içindeki analytics-mcp girdisini sil.
Kimlik bilgisi: ADC dosyasını sil ya da gcloud auth application-default revoke çalıştır (genel gcloud yöntemi).

Resmî sayfalar kaldırma adımını anlatmıyor; kaldırma komutları genel yöntemdir.

Sık sorulan sorular

Google Analytics MCP ayarlarımı değiştirebilir mi?

Hayır. Google'ın sayfası yalnızca okuma isteklerine açık olduğunu, yapılandırma ve ayarları düzenleyemediğini yazıyor; kimlik kapsamı da analytics.readonly. Yazma araçları için bir öneri issue'su açık ama kabul edilmiş bir özellik değil (#224).

Deneysel mi?

README başlığı Experimental diyor ve PyPI sınıflandırıcısı Beta. Google'ın geliştirici sayfasında deneysel ifadesi yok, ancak o sayfa en son 16 Eylül 2025'te güncellenmiş.

Hangi veri nereye gider?

Çalıştırdığın raporların sonuçları bağladığın asistanın bağlamına girer. Sunucu yerelde çalışır ve Google Analytics API'lerine çağrı yapar.

Claude.ai'ye bağlanır mı?

Hayır, resmî yol yok: sunucu yerel çalışır, README yalnız Gemini ve Claude Code için adım veriyor.

İlgili rehberler

AutoAE

/brag Claude Ads

Claude SEO DaVinci Resolve MCP ffmpeg-skill

Kaynaklar

Resmî kaynaklarda net olmayanlar: Veri örnekleme davranışı (aranmadı) · hangi sürümde kaç araç olduğu · güvenlik danışmanlığı taraması (yapılmadı) · kaldırma adımının resmî kaydı · PyPI'daki benzer adlı üçüncü taraf paketin kime ait olduğu · Türkçe ve TL bilgisi. Her biri ilgili bölümde yazılı.