Google Ads MCP nedir? Kurulum, salt okuma ve geliştirici jetonu
Asistanına kampanyalarını, bütçeni ya da performansını sorarsın; Google Ads MCP Google Ads hesabındaki veriyi GAQL sorgusuyla okur. Google'ın geliştirici araç setindeki açık kaynak MCP sunucusu (Apache-2.0, sürüm 0.0.5); belgesi sunucunun "tamamen salt okunur" olduğunu, teklifleri değiştiremeyeceğini, kampanya duraklatamayacağını ve yeni varlık oluşturamayacağını yazıyor. Üç aracı var: erişilebilir hesapları listeleme, GAQL ile arama ve alan bilgisi. Kurulum için Python (pipx), Google Cloud projesi, Google Ads API erişim seviyesi ve Google hesabıyla giriş gerekir. Belgeye göre geliştirici jetonları 9 Eylül 2026'da kaldırıldı ve son sürümde gerekmiyor.
- Ne yapar
- Asistana Google Ads kampanya ve performans verisini okutur
- Tür
- MCP sunucusu (yerel, açık kaynak)
- Yapımcı
- Salt okuma
- Evet (belgeye göre tamamen)
- Sürüm
- 0.0.5, erken aşama
- Kurulum
- Cloud projesi + Python gerekir
- Ücret
- Sunucu için ücret yok; API ücreti belgede yazmıyor
Google Ads MCP ne işe yarar?
MCP, yapay zekâ programlarının dış araçlara bağlanma standardıdır. Google Ads MCP ile asistan Google Ads hesabındaki kampanya, bütçe, durum ve metrik verisini senin adına sorgular. "Bu hafta hangi kampanya en çok harcadı?" gibi bir soruyu GAQL (Google Ads Query Language) sorgusuna çevirip çalıştırır.
Belgeye göre tamamen salt okunur: teklif değiştiremez, kampanya duraklatamaz.
Sunucuda üç araç var: list_accessible_customers (erişebildiğin müşteri kimlikleri), search (GAQL sorgusu) ve get_resource_metadata (bir kaynağın sorgulanabilir alanları).
Kime yarar: Google Ads raporlarını elle çekmek yerine asistana sormak isteyen reklam yöneticilerine ve ajanslara. Hesapta değişiklik yaptırmak için bu araç uygun değil.
Google Ads MCP nasıl kurulur?
Gerekenler: Python 3.10+ ve pipx, Google Ads API'si etkin bir Google Cloud projesi, projenin Google Ads API erişim seviyesi (Explorer, Basic veya Standard) ve Google Ads hesabına erişimi olan bir Google kullanıcısı. Komutlar Google belgesi ve README'den aynen alındı.
- pipx'i kur.
- Google Cloud projende Google Ads API'sini etkinleştir.
- Uygulama varsayılan kimlik bilgisini (ADC) adwords kapsamıyla oluştur; çıktıdaki "Credentials saved to file" yolunu not al.
- MCP istemcinin ayar dosyasına sunucuyu ekle (aşağıdaki örnek) ve istemciyi yeniden başlat.
› gcloud auth application-default login --scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform --client-id-file=YOUR_CLIENT_JSON_FILE› {"mcpServers":{"google-ads-mcp":{"command":"pipx","args":["run","--spec","git+https://github.com/googleads/google-ads-mcp.git","google-ads-mcp"],"env":{"GOOGLE_PROJECT_ID":"YOUR_PROJECT_ID","GOOGLE_APPLICATION_CREDENTIALS":"/path/to/credentials.json"}}}}Yönetici (MCC) hesabı üzerinden erişiyorsan ortam değişkenlerine GOOGLE_ADS_LOGIN_CUSTOMER_ID ekleyebilir ya da her çağrıda login_customer_id verebilirsin. Sürümü sabitlemek için README google-ads-mcp==X.Y.Z biçimini öneriyor.
!Geliştirici jetonu: Google belgesi jetonların 9 Eylül 2026'da kaldırıldığını ve son sürümde artık gerekmediğini yazıyor; erişim seviyesi artık Cloud projesine bağlı. README örneği ise hâlâ GOOGLE_ADS_DEVELOPER_TOKEN gösteriyor ("Optional"). Atlas kartındaki "jeton başvurusu gerekir" ifadesi eskimiş.
Atlas kartındaki claude mcp add satırı Google'ın sayfalarında yok; resmî örnek mcpServers JSON'u. Sohbet uygulamaları (Claude, ChatGPT) için belge, kendi Cloud Run'ında sunucu yayınlayıp özel bağlayıcı eklemeyi anlatıyor.
Google Ads MCP nasıl kullanılır?
Kurulumdan sonra isteği normal yazarsın; asistan GAQL sorgusunu kendisi kurar. Önce hangi hesaba erişebildiğini sor.
Günlük işlem sınırı erişim seviyesine bağlı: Google'ın erişim seviyesi sayfasına göre Explorer üretim hesaplarında 2.880 işlem/gün, Basic 15.000, Standard sınırsız.
Google Ads MCP hangi istemcilerde çalışır?
| AntigravityVar | README'de ayrı bölüm: yerel ya da Streamable HTTP. |
|---|---|
| CodexKısmen | README yalnız HTTP dağıtımı için komut veriyor; önce OAuth proxy ile ayrı süreç gerekir. |
| Gemini CLIVar | Belgede settings.json örneği var (Cloud Run adresi). |
| Claude Code, Cursor, VS CodeKısmen | README mcpServers bloğunun aynı olduğunu söylüyor; dosya yollarını kendi istemcinin belgesiyle karşılaştır. |
| Claude / ChatGPT sohbet uygulamalarıKısmen | Yalnız kendi Cloud Run dağıtımınla özel bağlayıcı olarak. |
Google Ads MCP neye erişir, hesapta değişiklik yapar mı?
Kampanya, bütçe, durum ve performans verisi (GAQL ile erişilebilen her şey); erişilebilir müşteri kimlikleri ve adları; kaynak alanları.
Belgeye göre hiçbir şey: teklifleri değiştiremez, kampanya duraklatamaz, yeni varlık oluşturamaz.
Silme aracı yok.
README: sunucu verini bağladığın asistana ve modele açar. Sorgu sonuçları (kampanya adları, harcamalar) kullandığın yapay zekâ hizmetine gider. API çağrılarına ürünü iyileştirmek için ek bir kullanım başlığı eklenir.
!Salt okunurluk Google'ın OAuth kapsamından değil, sunucunun sunduğu araçlardan gelir: kapsam tam adwords. Aynı kimlikle başka bir program yazma yapabilir. Ayrıca bakımcılardan biri Haziran 2026'da yazma erişimi eklemeyi planladığını yazdı (issue #84); gelecek sürümler değişebilir, bu yüzden sürümü sabitle.
GitHub Güvenlik Danışmanlıkları ve OSV taraması yapılmadı; kayıtlı uyarı olup olmadığı bilinmiyor. Bu "güvenli" demek değildir.
Google Ads MCP ücretsiz mi?
Sunucunun kendisi açık kaynak ve ücret istemiyor. Google Ads API'sinin kullanım ücretini belge netleştirmiyor: Google Cloud faturalandırma sayfana ve Google Ads API Center'a bak. Kullandığın asistanın kendi ücreti ayrı. Yeni Cloud projelerinde Explorer erişimi başvurusunun otomatik reddedildiğini bildiren kullanıcı raporları var (issue #133, 9-13 Ekim 2026); resmî bir çözüm yayımlanmamış.
Bu bir mali ya da hukuki görüş değildir. TL fiyatı yok.
Sık sorunlar ve çözümleri
| Ne oluyor | Ne yapmalı |
|---|---|
| "The Google Cloud project is only approved for use with test accounts" | Cloud projesinin Google Ads API sayfasından Explorer erişimine başvur (README). |
| Explorer başvurusu saniyeler içinde reddediliyor | Kullanıcıların bildirdiği Üç kullanıcı bildirdi (issue #133); resmî çözüm yok. |
| Kullanıcıların bildirdiği Workspace oturum denetimi açık kuruluşta yaklaşık 16 saatte bir "Reauthentication is needed" (503) | Tarayıcıdan yeniden oturum aç; gözetimsiz kullanım için kalıcı yol belgelenmemiş (issue #100, açık). |
| Windows'ta list_accessible_customers sonsuza kadar bekliyor | Kaynakta düzeltme var (issue #76 kapalı); güncel sürümü kullan. |
Google Ads MCP nasıl kaldırılır?
- İstemcide: MCP ayar dosyasından google-ads-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 bağlantı kesme adımını ayrıca anlatmıyor; yukarıdakiler genel yöntemdir.
Sık sorulan sorular
Google Ads MCP hesabımda değişiklik yapabilir mi?
Hayır. Google belgesi sunucunun tamamen salt okunur olduğunu, teklifleri değiştiremeyeceğini, kampanya duraklatamayacağını ve yeni varlık oluşturamayacağını yazıyor. Ancak OAuth kapsamı tam adwords kapsamıdır; salt okunurluk sunucunun araç setinden gelir.
Geliştirici jetonu gerekiyor mu?
Google belgesine göre geliştirici jetonları 9 Eylül 2026'da kaldırıldı ve son sürümde gerekmiyor; README örnekleri hâlâ jeton değişkenini isteğe bağlı gösteriyor. Erişim seviyesi artık Cloud projesine bağlı.
Günde kaç sorgu atabilirim?
Erişim seviyesine bağlı: Explorer üretim hesaplarında günde 2.880 işlem, Basic 15.000, Standard sınırsız. Gün, son 24 saatlik kayan penceredir.
Verim yapay zekâ şirketine gidiyor mu?
Sunucu yerelde çalışsa da araç sonuçları bağladığın asistanın bağlamına girer; README bunu açıkça yazıyor. Hangi sağlayıcıya gittiği kullandığın asistana bağlı.
Resmî mi, güvenilir mi?
Belge Google'ın developers.google.com sitesinde, depo googleads kuruluşunda ve dosyalar Google LLC telifli. Sürüm 0.0.x, yani erken aşama; belge repoyu topluluk kaynakları altında anıyor. "Google ürünü değil" türü bir uyarı görünmüyor.
İlgili rehberler
Kaynaklar
Resmî kaynaklarda net olmayanlar: Google Ads API ücreti · Google'ın barındırdığı uzak uç noktanın genel kullanıma açık olup olmadığı (belge "izin listeli pilot" diyor) · güvenlik danışmanlığı taraması (yapılmadı) · bağlantı kesme adımının resmî kaydı · Türkçe ve TL bilgisi. Her biri ilgili bölümde yazılı.