Google Ads'i Claude Code'a tek komutla bağlayın
Claude Code terminalde çalışır; tıklanacak bir bağlayıcı ayar ekranı yoktur. Tek bir satır — claude mcp add --transport http opus-growth https://mcp.opus-growth.com — Opus Growth'u uzak MCP sunucusu olarak kaydeder, tek bir OAuth onayı Google Ads hesabınızı bağlar ve kod tabanınızı zaten okuyan ajan 69 Google Ads aracına kavuşur; aynı bağlantıda Microsoft Advertising, TikTok ve LinkedIn de gelir.
Başlamadan önce gerekenler: kurulu ve giriş yapılmış bir Claude Code (Claude Code'u kapsayan bir plan — Claude Pro, Max, Team veya Enterprise — ya da Anthropic API bakiyesi), makul ölçüde güncel bir sürüm (uzak HTTP MCP sunucusu desteği yeni sayılır) ve yönetmek istediğiniz reklam hesabına hâlihazırda erişimi olan bir Google hesabı. Liste bu kadar: başvurulacak Google Ads geliştirici jetonu, yapıştırılacak API anahtarı, kuracağınız bir sunucu yok. 7 günlük deneme yetkilendirdiğiniz anda başlar, kart bilgisi istemiyoruz.
https://mcp.opus-growth.comNeler yapabilirsiniz
Ayarlar ekranı değil, tek komut
Kurulumun tamamı terminaldeki tek bir satırdır: claude mcp add --transport http opus-growth https://mcp.opus-growth.com. Varsayılan kapsam sunucuyu yalnızca içinde bulunduğunuz projeye tanımlar; -s user eklerseniz makinenizdeki tüm projelerde açılır; -s project ise ekip arkadaşlarınızın git pull ile alacağı ortak bir .mcp.json dosyası yazar. Kurulacak paket, ayağa kaldırılacak sunucu, bakımını üstleneceğiniz yerel bir süreç yok.
Reklam hesabı ile kod tabanı aynı bağlamda
Bunu yalnızca bir kodlama ajanı yapabilir. Claude Code, analitik modülünüzün gerçekten tetiklediği dönüşüm olaylarını okuyup Google Ads'te tanımlı dönüşüm eylemleriyle karşılaştırabilir; yayındaki reklamların nihai URL'lerini uygulamadaki mevcut route'larla eşleştirebilir; kampanya izleme şablonlarını kodunuzdaki UTM standardına göre denetleyebilir. Tarayıcıdaki bir asistan depoyu göremez, raporlama bağlayıcısı da kodu göremez.
Tekrar eden hesap işi bir cron satırına iner
Başsız (headless) mod, yani claude -p, haftalık reklam operasyonunu zamanlanmış bir işe dönüştürür: geçen haftanın harcamasını tarihli bir markdown dosyasına dökmek, bir önceki çalıştırmayla farkını almak, özeti pull request açıklamasına koymak. O cron satırını yazmadan önce bilmeniz gereken bir ayrıntı var: Claude Code başsız modda MCP araçlarını kendiliğinden onaylamaz. --allowedTools bayrağıyla, çalıştırmanın kullanabileceği Opus Growth araçlarını ya da ortak ön eklerini siz belirtirsiniz. Listeye yalnızca raporlama araçlarını alırsanız iş gözetimsiz akar; yazma araçlarını dışarıda bırakırsanız zamanlanmış hiçbir çalıştırma harcamaya dokunamaz.
Yönetici hesabı taraması, Agency planında
Yönetici (MCC) yapısı login-customer-id ile doğrudan desteklenir; Agency planında tek bir istek tüm müşteri hesaplarını tarayıp sıralı tek bir cevap döndürebilir: dönüşüm takibi eksik hesaplar, bütçesi kaçan kampanyalar, aktif reklamı olmayan kampanyalar. Terminalde bu çıktı ekran görüntüsü değil, commit edebileceğiniz bir dosya veya tablodur. Free ve Pro planları bilinçli olarak tek reklam hesabına kilitlidir; yani hesaplar arası tarama Agency'e özgüdür, tek hesap denetimi ise her planda çalışır.
Depoya hiçbir reklam kimlik bilgisi girmez
Bağlayıcı bizim tarafımızda barındırılır ve her geliştirici kendi Google hesabıyla OAuth üzerinden yetki verir; .mcp.json dosyasına giren tek şey herkese açık bir adrestir. Başvurulacak Google Ads geliştirici jetonu, saklanacak istemci gizli anahtarı, gitignore'a eklenip yanlışlıkla commit'lenmesinden korkulacak bir servis hesabı JSON dosyası yok.
Kabuk erişimi olan bir ajana göre korkuluklar
Claude Code zaten dosya düzenleyip komut çalıştırabiliyor; üstüne sınırsız harcama yetkisi vermek gerçekten kötü bir fikir olurdu. Bu yüzden yazma yetkisi olan her araç önce yalnızca bir kuru çalıştırma döndürür: hangi hesap, hangi varlık, mevcut değer, önerilen değer — ve orada durur. Değişiklik reklam platformuna ancak ikinci, onaylanmış çağrıda gider. Tek bir değişiklik bütçeyi yüzde 50'den fazla artıramaz ve uygulanan her işlem, sonradan okuyabileceğiniz bir denetim kaydına yazılır. Bu kapı istemcide değil bağlayıcıda durduğu için terminalde, tarayıcıda ve editörde birebir aynı şekilde işler.
60 saniyede kurun
- 1
Sunucuyu tek komutla ekleyin
Terminalde şunu çalıştırın: claude mcp add --transport http opus-growth https://mcp.opus-growth.com — varsayılan kapsam sunucuyu bulunduğunuz projeye tanımlar. Makinenizdeki tüm projelerde kullanmak için -s user, ekibinizin depoya commit edeceği bir .mcp.json dosyası oluşturmak için -s project ekleyin.
- 2
Yetkilendirmeyi oturumun içinde tamamlayın
Claude Code'u başlatın, /mcp yazın, opus-growth sunucusunu seçin ve Authenticate deyin. Claude Code barındırılan OAuth akışı için tarayıcınızı bir kez açar: Google ile giriş yapar, erişimi onaylar ve bağlayıcının çalışacağı reklam hesaplarını seçersiniz. Tarayıcısı olmayan bir sunucuda SSH ile mi çalışıyorsunuz? Ekrana yazılan yetkilendirme adresini kendi bilgisayarınızdaki tarayıcıya yapıştırın; geri dönüş aynı şekilde tamamlanır.
- 3
Güvenmeden önce doğrulayın
claude mcp list komutunu çalıştırın ve opus-growth sunucusunun bağlı göründüğünü teyit edin. Ardından oturumda reklam hesaplarınızı listeletin. Hesap adları geldiyse 69 Google Ads aracı o oturumda hazırdır; aynı yetkilendirmeyle Microsoft Advertising, TikTok Ads ve LinkedIn Ads de açılmıştır.
- 4
Gerçek bir iş çalıştırın ve çıktıyı kaydedin
Elinizle yapacağınız bir işle başlayın: son 30 günü denetletip bulguları depodaki bir dosyaya yazdırın. Okuma istekleri anında çalışır. Ajan bir değişiklik önerdiği anda — bütçe kısma, negatif kelime listesi, reklam grubu duraklatma — kuru çalıştırmayı ekrana basar ve terminalde onayınızı bekler.
Sade Türkçe ile sorun
›Google Ads hesaplarımı listele, sonra son 30 günün kampanya performansını harcama, dönüşüm ve EBM sütunlarıyla reports/google-ads.md dosyasına yaz.
›Google Ads'teki dönüşüm eylemlerini bu depodaki kodun gerçekten tetiklediği dönüşüm olaylarıyla karşılaştır; hiç tetiklenmeyenleri söyle.
›Yayındaki tüm arama reklamlarının nihai URL'lerini bu uygulamadaki route'larla karşılaştır; 404 verecek veya yönlendirmeye düşecek olanları işaretle.
›Son 14 günün arama terimleri raporunu çek, sıralı eşlemeli bir negatif kelime listesi hazırla ve uygulamadan önce kuru çalıştırmayı göster.
›Yönetici hesabımın altındaki müşteri hesaplarını tara: dönüşüm takibi eksik olanları ve aktif reklamı bulunmayan kampanyaları bir CSV dosyasına yaz.
›UTM standardımız src/lib/analytics.ts içinde tanımlı — yayındaki kampanyaların izleme şablonlarını buna göre denetle ve uyuşmayanları listele.
›Her pazartesi claude -p ile çalışan, yalnızca Opus Growth raporlama araçlarını izin listesine alan ve geçen haftanın Google ile Microsoft Ads harcamasını tarihli bir markdown dosyasına döken bir cron satırı yaz.
Karşılaştırma
| Opus Growth | claude.ai (tarayıcı) | |
|---|---|---|
| Nerede çalışır | Terminalinizde, zaten üzerinde çalıştığınız projenin içinde. Tarayıcı sekmesi, ayrı uygulama ve koddan kopma yok. | Tarayıcı sekmesi veya Claude Desktop. Planlama, keşif ve bir sohbeti meslektaşınızla paylaşmak için ideal. |
| Bağlayıcı nasıl eklenir | Tek CLI komutu: claude mcp add --transport http opus-growth https://mcp.opus-growth.com | Ayarlar, ardından Connectors, ardından Add custom connector; aynı adres yapıştırılır. Özel bağlayıcı Pro, Max, Team ve Enterprise planlarında bulunur. |
| Yetkilendirme | Oturumda /mcp yazıp Authenticate seçersiniz, tarayıcıda bir kez onaylarsınız. Tarayıcısız veya SSH'li makinede ekrana yazılan adresi kendi bilgisayarınızda açarsınız. | Zaten giriş yapmış olduğunuz tarayıcıda hallolur: tek onay ekranı, ardından reklam hesabı seçimi. |
| Ekiple paylaşım | -s project bayrağı commit edilebilir bir .mcp.json dosyası yazar; depoyu klonlayan herkeste sunucu tanımlı gelir, herkes kendi Google hesabıyla yetki verir. | Herkes bağlayıcıyı kendi ayarlarına ekler. Commit edilecek bir şey yok, ama paylaşılan bir şey de yok. |
| Otomasyon | Okuma araçlarını --allowedTools ile izin listesine aldığınızda claude -p raporlamayı script'lenebilir kılar: tarihli dosyaya haftalık denetim, pull request içinde harcama farkı. | Doğası gereği etkileşimli. Her adımda siz varsınız; analiz için iyi, tekrar eden iş için zahmetli. |
| Reklam hesabı dışında ne görebilir | Deponuzu, kabuğu, testleri ve logları; böylece izleme kodunu, route'ları ve UTM standardını canlı kampanya kurulumuyla karşılaştırabilir. | Yalnızca sohbete yazdığınız, yapıştırdığınız veya yüklediğiniz şeyi. |
| Yazma güvenliği | Kuru çalıştırma, açık onay, denetim kaydı — yukarıda anlatılan kapının aynısı, bağlayıcı tarafından uygulanır. | Birebir aynı; çünkü hepsini aynı barındırılan sunucu uygular. |
| Kimin için | Terminalde yaşayan, hesap işini dönüşümü üreten kodun yanında tekrarlanabilir ve script'lenebilir biçimde yapmak isteyen geliştiriciler ve teknik PPC ekipleri. | Keşif amaçlı analiz yapan, haftalık gözden geçirme yürüten veya telefondan çalışan pazarlamacılar. |
Sıkça sorulan sorular
İki adım. Önce terminalde şunu çalıştırın: claude mcp add --transport http opus-growth https://mcp.opus-growth.com. Sonra Claude Code'u başlatıp /mcp yazın, opus-growth sunucusunu seçip Authenticate deyin — barındırılan OAuth için bir tarayıcı penceresi açılır, Google ile giriş yapar ve kullanmak istediğiniz reklam hesaplarını seçersiniz. Bu andan itibaren oturumda 69 Google Ads aracı vardır; API anahtarı, geliştirici jetonu veya kendi kuracağınız bir sunucu gerekmez.
Yetkilendirme adresi ekrana yazılır; siz de tarayıcınızın bulunduğu yerde, genelde kendi bilgisayarınızda açarsınız. Orada Google ile giriş yapıp erişimi onaylarsınız, barındırılan geri dönüş adresi el sıkışmayı tamamlar ve terminal oturumu bağlı duruma geçer; uzak makinede hiçbir tarayıcı çalışmaz. SSH üzerinden veya dev container içinde Claude Code kullanan herkesin normal akışı budur ve barındırılan uzak bir MCP sunucusunun, yerel kimlik dosyaları bekleyen kendi kurduğunuz stdio sunucusuna üstünlüğü tam olarak buradadır.
Varsayılan olan yerel kapsam, sunucuyu yalnızca içinde bulunduğunuz projede tanımlar. -s user ile kullanıcı kapsamı, makinenizdeki bütün projeler için bir kez tanımlar; serbest çalışan veya tek başına ilerleyen pazarlamacı için olağan tercih budur. -s project ile proje kapsamı, depoya commit edeceğiniz bir .mcp.json dosyası yazar; depoyu klonlayan herkeste sunucu tanımı hazır gelir. O dosyada herkese açık bir adresten başka bir şey bulunmaz: her ekip üyesi kendi Google hesabıyla yetki verir ve yalnızca kendisine açılan reklam hesaplarını görür; yani dosyayı commit etmek hiçbir sır sızdırmaz.
Ekleme komutunu ve tek seferlik Authenticate adımını her makinede veya container imajında çalıştırırsınız; çünkü Claude Code bağlayıcının oturum jetonunu o makinedeki kendi kimlik deposunda tutar, proje dosyalarınızda değil. Depoya giren şey yalnızca bir adrestir. Google kimlik bilgileriniz ise ikisinde de yoktur: Google'ın jetonları bizim sunucularımızda şifreli durur, dolayısıyla kaybolan bir dizüstü bilgisayar hiçbir reklam hesabını açığa çıkarmaz ve Google hesap sayfanızdan erişimi iptal ettiğinizde tüm istemcilerde aynı anda kesilir. Opus Growth hesabınız, planınız ve bağlı reklam hesaplarınız yeni makineye olduğu gibi taşınır.
Raporlama için evet — tek bir bayrakla. claude -p ile başlatılan başsız çalıştırmalar MCP araçlarını kendiliğinden onaylamaz; o çalıştırmanın kullanabileceği Opus Growth araçlarını --allowedTools ile siz adlandırırsınız. Okuma araçlarını (performans raporu, arama terimleri, hesap denetimi) izin listesine alırsanız haftalık rapor, dosyayı yazıp çıkan bir cron işine dönüşür. Yazma araçlarında ise bilinçli davranın: kuru çalıştırma kapısı, çağrıdaki bir onay parametresiyle işler; yani yazma araçlarını açıkça izin listesine aldığınız bir ajan onaylı çağrıyı da gönderebilir. Zamanlanmış işleri salt okunur tutun, değişiklikleri etkileşimli oturumda bir insan onaylasın.
Agency planında evet: yönetici (MCC) yapısı login-customer-id ile çalışır, dolayısıyla tek bir istek yetki verdiğiniz her müşteri hesabını dolaşıp sıralı tek bir liste döndürebilir. Free ve Pro planlarında bağlayıcı tek reklam hesabına kilitlidir — kullandığınız ilk hesaba — yani o planlarda tarama yalnızca o hesabı kapsar; çoklu hesap işi zaten Agency planının varlık sebebidir. Terminal avantajı her iki durumda da aynı kalır: sonuç, ekran görüntüsü aldığınız bir panel değil, fark alıp commit edebileceğiniz bir dosya veya CSV olarak gelir.
İşlemler araç çağrısı başına, ağırlığına göre sayılır. Arama kampanyası kurmak 8, anahtar kelime eklemek 5, hesap denetimi veya anahtar kelime planlayıcı 3, performans ya da arama terimleri raporu 2, hesapları listelemek 1; hesap bağlamak ve bakiyenize bakmak 0. Yani 50 işlem kabaca altı kampanya kurulumu, yaklaşık on altı denetim veya yirmi beş rapor demektir — 7 günlük denemede akışı gerçek bir hesapta kanıtlamaya yeter, bir aylık üretim operasyonuna değil. Sonrasında Pro 49,99 $/ay, Agency 99,99 $/ay olarak USD üzerinden tahsil edilir, dilediğiniz an iptal edersiniz; müşteri panelinden rapor okumak ücretsizdir.
Evet. Opus Growth tek bir barındırılan uzak MCP sunucusudur; Claude Code'da tamamladığınız yetkilendirme, claude.ai'de, Cursor'da, VS Code'da, Windsurf'te, Codex'te veya Gemini CLI'da gördüğünüz hesabın ve bağlı reklam hesaplarının aynısıdır — yalnızca bağlayıcıyı ekleme biçimi değişir. Bu tek yetkilendirme Google Ads (69 araç), Microsoft Advertising (30), TikTok Ads (25) ve LinkedIn Ads (18) ile birlikte ölçümleme tarafında Google Tag Manager, GA4, Search Console ve YouTube'u kapsar; katalog toplamı 221 araçtır. Meta Ads ve Google İşletme Profili hazır ama henüz kapalı: biri platform incelemesini, diğeri Google kota onayını bekliyor.
Hayır. Google Ad Manager, kendi sitenizdeki envanteri satmak için sipariş, satır öğesi ve reklam birimi yöneten yayıncı tarafı reklam sunucusudur ve desteklemiyoruz. Opus Growth, Arama, Performance Max, Demand Gen ve Uygulama kampanyalarını satın aldığınız reklamveren tarafındaki Google Ads'i bağlar — yönetici (MCC) hesapları dahil. Aramanızda Ad Manager yazdıysanız ama kastettiğiniz anahtar kelimelere para harcadığınız hesapsa doğru yerdesiniz.
Diğer sayfalar
Tek komut, tek giriş: kodunuzu yazan ajan, o kod için para harcayan hesabı da denetlesin. claude mcp add --transport http opus-growth https://mcp.opus-growth.com komutunu çalıştırın ve 7 günlük ücretsiz denemeyi başlatın: 50 işlem, tam yazma erişimi, kart bilgisi istemiyoruz.
