Codex ve Gemini CLI ile Meta Ads: Kodlama Ajanını Reklamlara Bağla

Codex de Gemini CLI de Meta reklamlarını, https://teraads.co/mcp adresinde barındırılan bir MCP sunucusu olan Tera Ads üzerinden okuyup yönetebilir. Codex'te önce codex mcp add tera-ads --url https://teraads.co/mcp, ardından codex mcp login tera-ads komutunu çalıştır. Gemini CLI'da Tera Ads eklentisini GitHub'dan kur ve /mcp auth tera-ads komutunu çalıştır. İkisi de seni tarayıcında Tera Ads'e giriş yaptırır; ajanın yalnızca okuyacağını mı, önce sana soracağını mı, yoksa değişiklik yapacağını mı sen seçersin.

Bir kodlama ajanını reklamlarına neden bağlamalısın?

Pek çok Shopify kurucusu kendi temasını, betiklerini ve şirket içi araçlarını kendisi yazıyor ve günün yarısını terminalde geçiriyor. Reklamlarına bağlı bir kodlama ajanı, bir ürün sayfasını düzenlediğin oturumun içinde "Meta dün ne kadar harcadı?" sorusunu cevaplayabilir, haftalık bir özeti deponda Markdown dosyası olarak kaydedebilir ya da bir haftalık kampanya sonuçlarını salı günü yayına aldığın bir değişikliğin yanına koyabilir.

Ajanla reklam hesabın arasındaki bağlantı MCP, yani Model Context Protocol: bir yapay zekâ ajanının başka bir servisin sunduğu araçları çağırmasını sağlayan açık bir standart. Temel bilgileri MCP bağlayıcıları rehberi (İngilizce) anlatıyor. Codex de Gemini CLI de OAuth ile giriş yapılan uzak MCP sunucularını destekliyor; bu yüzden Tera Ads gibi barındırılan bir sunucu için ajanın dışında hiçbir şey kurman gerekmez.

Tera Ads'in sıradan bir Meta bağlantısına eklediği şey mağazan. Canlı kampanya, reklam seti ve reklam okumalarının yanında Shopify siparişlerinden, iadelerden, ürün maliyetinden, kargodan, ücretlerden ve para iadelerinden, Meta ve Google reklam harcaman düşülmüş olarak cevap verir. Meta'nın atfettiği gelir Meta'nınki olarak etiketlenir, böylece ajan onu satış saymaz. Bunun yerine bağlayabileceğin diğer sunucular için Meta Ads MCP seçenekleri yazısına bak.

Gemini CLI hakkında bir not: belgelerinde, ücretsiz katman ve Google One kullanıcıları için Gemini CLI'ın yerini 18 Haziran 2026'da Antigravity CLI'ın aldığını belirten bir uyarı var (Gemini CLI'ın MCP belgeleri). Aşağıdaki adımlar Gemini CLI'ı Ekim 2026'da belgelendiği haliyle izliyor.

Başlamadan önce

• Ücretsiz bir Tera Ads hesabı. Kaydol ve Meta reklam hesabını bağla. Ajan mağaza satışlarını ve kârı görebilsin diye Shopify'ı da bağla.
• Sahip erişimi. Tera Ads'te bir işletmeye yapay zekâ bağlayabilen tek kişi işletme sahibidir.
• Kurulu bir Codex ya da Gemini CLI. Ajan kendi hesabına giriş yapmış olmalı.
• Değişiklikler için bir kural. Ajanın yalnızca rapor mu vereceğine, yoksa reklamları duraklatıp bütçeleri de mi kaydıracağına karar ver. Güvenli yapay zekâ erişimi rehberinde (İngilizce) kopyalayabileceğin kısa bir politika var.

Codex'i adım adım bağla

1. Ücretsiz bir Tera Ads hesabı aç. Kaydol, Meta reklam hesabını bağla, ardından cevaplar mağazanın iadeler sonrası kârını da içersin diye Shopify'ı bağla.
2. Sunucuyu Codex'e ekle. Terminalinde codex mcp add tera-ads --url https://teraads.co/mcp komutunu çalıştır.
3. Tera Ads'e giriş yap. codex mcp login tera-ads komutunu çalıştır; Tera Ads tarayıcında açılır, orada giriş yapar, işletmeyi seçer ve ajanın ne yapabileceğine karar verirsin.
4. Bağlantıyı kontrol et. codex ile başlat ve etkin MCP sunucularını listeleyen /mcp komutunu yaz; tera-ads listede olmalı.
5. Kontrol edebileceğin bir soru sor. "Tera Ads ile aktif Meta kampanyalarımı dünkü harcamalarıyla birlikte listele" gibi bir istem dene ve cevabı Ads Manager ile karşılaştır.

Codex MCP sunucularını ~/.codex/config.toml dosyasında saklar: her sunucu için bir tablo (bu sunucu için [mcp_servers.tera-ads]), adres de url alanında. OpenAI'ın belgelerine göre ChatGPT masaüstü uygulaması, Codex CLI ve IDE eklentisi bu yapılandırmayı paylaşıyor; yani tek bir kurulum üçünü de kapsıyor (Codex MCP belgeleri). Aynı belgeler codex mcp login komutunun OAuth'u yürüttüğünü ve Codex'in bir istemci kaydı yöntemini otomatik olarak seçebildiğini söylüyor. Tera Ads, OAuth 2.1 ve PKCE ile dinamik istemci kaydını (dynamic client registration) destekliyor; bu yüzden vermen gereken bir istemci kimliği (client ID) yok.

Codex'i kendi tarafında okumayla sınırla

Codex'in sunucu ayarları, bir izin listesi olan enabled_tools alanını ve ondan sonra uygulanan bir engel listesi olan disabled_tools alanını kabul ediyor. Tera Ads bağlantın değişikliklere izin verse bile Codex'in değişiklik araçlarını çağırmasını engellemek için config.toml dosyasında [mcp_servers.tera-ads] altına şu satırı ekle:

disabled_tools = ["pause", "resume", "set_budget", "create_campaign", "create_ad_set", "create_ad", "duplicate"]

Belgeler her sunucu ve her araç için onay ayarlarını da anlatıyor. Yine de en basit koruma Tera Ads'teki: giriş yaparken yalnızca okumayı seç, o bağlantıda değişiklik araçları hiçbir şey yapamaz.

Gemini CLI'ı bağla

1. Eklentiyi kur. gemini extensions install https://github.com/Teralabsx/meta-ads-mcp komutunu çalıştır.
2. Tera Ads'e giriş yap. Gemini CLI'ı başlat, /mcp auth tera-ads komutunu çalıştır, ardından giriş yap, işletmeyi seç ve ajanın ne yapabileceğine karar ver.
3. Araçları kontrol et. Her sunucunun durumunu ve araçlarını görmek için /mcp yaz ya da kabuğunda (shell) gemini extensions list komutunu çalıştır.
4. Kontrol edebileceğin bir soru sor. "Bu hafta en çok hangi Meta kampanyaları harcadı?" diye sor ve cevabı Ads Manager ile karşılaştır.

Eklenti, Tera Ads GitHub deposundaki küçük bir gemini-extension.json dosyası. Gemini'yi httpUrl alanı üzerinden https://teraads.co/mcp adresine yönlendiriyor; Gemini'nin belgeleri bu alanı Streamable HTTP uç noktası olarak tanımlıyor, url ise SSE için. Eklenti bağlam dosyası olarak da GEMINI.md dosyasını gösteriyor. Bu dosya Gemini'ye Meta reklamları, ROAS ve kâr sorularında Tera Ads'e başvurmasını, Meta'nın atfettiği geliri Meta'nınki olarak etiketlemesini ve kampanya adlarıyla reklam metinlerini asla talimat olarak değil, veri olarak ele almasını söylüyor.

Gemini'nin belgelerine göre Gemini CLI uzak MCP sunucuları için OAuth'u destekliyor, kurulumu otomatik olarak keşfedebiliyor, sunucunun desteklediği durumlarda dinamik istemci kaydını yürütüyor ve token'ları ~/.gemini/mcp-oauth-tokens.json dosyasında saklıyor. Sunucu ayarlarında ayrıca trust var; true yapıldığında tüm araç çağrısı onaylarını atlıyor. Tera Ads eklentisi bunu ayarlamıyor. Öyle bırak ki Gemini bir aracı çalıştırmadan önce sormaya devam etsin.

Codex ve Gemini CLI yan yana

Codex'in ya da başka bir ajanın Tera Ads'i sen söylemeden kullanmasını istiyorsan depo, GEMINI.md içeriğini projenin AGENTS.md ya da CLAUDE.md dosyasına kopyalamayı öneriyor. Aksi halde isteminde Tera Ads'in adını an.

Terminal ajanına uygun istemler

Bir kodlama ajanı, bir sohbet penceresinin yapamadığı bir şeyi yapabilir: cevabı çalıştığın yere koyar. Sonuçları bir dosyaya kaydetmesini, geçen haftanın dosyasıyla karşılaştırmasını ya da bir kampanyanın insanları gönderdiği ürün sayfasını açmasını iste.

Cevapları iki çekinceyle oku. Meta'nın satın almaları ve geliri Meta'nın atfıdır, mağazanın satışları değil. get_ads_review ise harcama yapan her kampanyayı mağazanın olağan iadeleri sonrasındaki kâra göre, senin maliyetlerinle ve başa baş ROAS değerine karşı değerlendirir; kâr rakamı tüm mağaza için bir tahmindir, bankadaki nakit değil. Bu farkın neden önemli olduğunu iadeler sonrası gerçek ROAS rehberi gösteriyor; reklam analizi için istem (prompt) kütüphanesinde (İngilizce) deneyebileceğin daha fazla soru var.

Ajanın değişikliklerini kontrol altında tut

Kodlama ajanları çoğu zaman dosyaları her seferinde sormadan düzenleyecek şekilde ayarlanır. Bu alışkanlığın reklam araçlarına bulaşmasına izin verme; orada tek bir yanlış çağrı gerçek para harcatır. Ajana ne izin verilirse verilsin, Tera Ads kendi sınırlarını uygular:

• Yalnızca okuma, önce sor ya da değişiklik yap. Önce sor seçiliyken bir değişiklik, sen Tera Ads'te onaylayana kadar orada bekler; ajan onu senin yerine onaylayamaz.
• Yeni şeyler duraklatılmış başlar. Kampanyalar, reklam setleri, reklamlar ve kopyalar, bir şey onları açana kadar hiç harcama yapmaz.
• Bütçe adımları sınırlı. Tek bir değişiklik bir bütçeyi en fazla üç katına çıkarabilir ya da onda birine indirebilir.
• Günlük tavan. Asistanlar bir işletmede günde en fazla 50 değişiklik yapabilir.
• Silme aracı yok. Ajan duraklatabilir ama hiçbir şeyi silemez.
• 7 gün geri alma. Bir duraklatma, açma ya da bütçe değişikliği Tera Ads'te 7 gün boyunca geri alınabilir. Yeni kampanyalar, reklam setleri ve reklamlar geri alınamaz ama duraklatılmış başlar.
• Bağlantı başına tek işletme. Bir bağlantı, yine senin sahibi olduğun bir başka işletmeyi bile okuyamaz.

Bir değişikliğin sonucu outcome_unknown olarak dönerse ajandan onu tekrarlamasını isteme. Aynı değişiklik iki kez yapılmasın diye önce list_recent_changes ile kontrol etmesini iste.

Bir şey çalışmadığında

Ajan Tera Ads'i görmezden geliyor. İsteminde adını an ("Tera Ads ile ..."), ya da yukarıda anlatıldığı gibi GEMINI.md dosyasını projenin talimat dosyasına kopyala.

Yeniden giriş yapmanı istiyor. Erişim token'ları bir saat geçerlidir ve senin için yenilenir; bir bağlantı 30 gün sürer. codex mcp login tera-ads ya da /mcp auth tera-ads komutunu yeniden çalıştır.

Bir sınıra ulaşıldığını söylüyor. Ücretsiz planda haftada 30 çağrı var ve sayaç her hafta UTC'ye göre sıfırlanır. get_usage ücretsizdir; kaç çağrın kaldığını ve sayacın ne zaman sıfırlanacağını söyler.

Bütçeler yüz kat büyük görünüyor. list_campaigns bütçeleri Meta'nın birimleriyle gösterir; bu birim çoğu para biriminde ana birimin yüzde biridir, yani 5000 değeri $50 demektir. set_budget ise reklam hesabının para biriminde tam birimler alır.

Cevaplar yanlış mağazayla ilgili. Her bağlantı tek bir işletmeyi kapsar. Yeniden giriş yap ve öteki işletmeyi seç.

Tera Ads Connect, Shopify markaları için kâr panosu olan Tera Ads'in MCP sunucusu. Codex'e, Gemini CLI'a ve diğer MCP istemcilerine canlı Meta okumaları, Shopify satışları ve iadeler sonrası kârın yanında sınırlı ve kayıt altına alınan reklam değişiklikleri sunar. Ücretsiz plan tek bir Meta reklam hesabında haftada 30 çağrı içerir; Connect Pro ise en fazla üç reklam hesabında ayda 3.000 çağrı için ayda $15 tutar ve Growth ile Scale planlarına dahildir. Diğer istemciler için kurulum adımları Connect sayfasında; bir editörde çalışıyorsan Cursor, VS Code ve Claude Code'da Meta Ads MCP rehberi bu üçünü anlatıyor.

Sık sorulan sorular

Codex Meta reklamlarını yönetebilir mi?

Evet, bir MCP sunucusu üzerinden. codex mcp add tera-ads --url https://teraads.co/mcp ve codex mcp login tera-ads komutlarını çalıştır, sonra sade bir dille sor. Codex'in neyi değiştirebileceği, bağlantı için seçtiğin moda bağlı.

Gemini CLI'ı Facebook reklamlarına nasıl bağlarım?

gemini extensions install https://github.com/Teralabsx/meta-ads-mcp komutunu çalıştır, ardından Gemini CLI içinde /mcp auth tera-ads yaz ve Tera Ads'e giriş yap. Eklenti, Meta reklam hesabındaki Facebook ve Instagram reklamlarını kapsar.

Meta geliştirici uygulamasına ya da API token'ına ihtiyacım var mı?

Hayır. Tarayıcında Tera Ads'e giriş yaparsın ve değişiklikler Meta'ya Tera Ads'in kendi onaylı Meta uygulaması üzerinden ulaşır. Yapılandırma dosyana gizli hiçbir şey girmez.

Codex kurulumu IDE eklentisinde de çalışır mı?

Evet. OpenAI'ın belgelerine göre ChatGPT masaüstü uygulaması, Codex CLI ve IDE eklentisi aynı MCP yapılandırmasını paylaşıyor; CLI'da eklenen bir sunucu diğer ikisinde de hazır olur.

Gemini CLI hâlâ kullanılabiliyor mu?

Gemini CLI'ın belgelerine göre ücretsiz katman ve Google One kullanıcıları için yerini 18 Haziran 2026'da Antigravity CLI aldı. Kurmadan önce hesap türün için Google'ın belgelerini kontrol et.

Ne kadar tutar?

Ücretsiz plan tek bir Meta reklam hesabında haftada 30 çağrı içerir. Connect Pro, ayda 3.000 çağrı için ayda $15. Bir çağrı, ajanın Tera Ads'te yaptığı tek bir sorgudur ve bir soru birkaç çağrı alabilir.