Synter Ads

Synter MCP Sunucusu

Reklamcılık için en kapsamlı MCP sunucusu.

19 reklam platformunda raporlama ve bunların 14'ünde tam kampanya oluşturma (16'sında yazma işlemleri), tüm büyük satın alma kanallarını kapsar ve yıkıcı işlemler için yerleşik onaylar içerir.

Kampanya oluşturun. Bütçeleri ayarlayın. Düşük performans gösterenleri duraklatın. Yaratıcı içerikler üretin. Performans verilerini çekin. Tüm bunları doğal konuşma yoluyla Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X ve daha fazlasında yapın.

Bu, yapay zeka ajanlarına kredi kartı veren ilk Model Context Protocol (MCP) sunucusudur.

---

Synter Nasıl Karşılaştırılır?

Resmi Google Ads MCP sunucusu tasarım gereği salt okunurdur: Google'ın dokümantasyonuna göre "kesinlikle salt okunurdur" ve "teklifleri değiştiremez, kampanyaları duraklatamaz veya yeni varlıklar oluşturamaz." Çoğu üçüncü taraf reklam MCP sunucusu tek bir platformu kapsar. Synter'ı tek bir sunucudan, her büyük satın alma kanalında işin her iki yarısını da yapacak şekilde kurduk.

	Synter MCP	Resmi Google Ads MCP	Tipik üçüncü taraf reklam MCP'leri
Erişim	19 platformda okuma, 14'ünde kampanya oluşturma, 16'sında yazma işlemleri	Salt okunur (mevcut sürüm)	Genellikle salt okunur veya kısmi yazma
Platformlar	19 raporlama, 14 tam kampanya oluşturma (listeler aşağıda)	Yalnızca Google Ads	Genellikle tek platform
Kampanya oluşturma	✅ Google Search, Display, PMax, Meta, LinkedIn, Reddit, run_tool ile daha fazlası	❌	Nadiren
Bütçeler ve duraklatma	✅	❌	Değişir
Yapay zeka yaratıcı içerik üretimi	✅ Görseller, video, metin	❌	❌
Hedef kitle senkronizasyonu	✅ Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X	❌	❌
Güvenlik	Yıkıcı işlemler için onaylar	yok (salt okunur)	Değişir
Açık kaynak	✅ MIT	✅	Değişir

Raporlama kapsamı (19 platform): Google Ads, Microsoft Ads (Bing), Meta (Facebook ve Instagram), LinkedIn Ads, X (Twitter) Ads, Reddit Ads, TikTok Ads, Snapchat Ads, Pinterest Ads, Spotify Ads, Amazon Ads, Amazon DSP, Walmart Connect, Instacart Ads, Target Roundel, Criteo, The Trade Desk, Display & Video 360 ve OpenAI Ads (ChatGPT).

Tam kampanya oluşturma (14 platform): Google Ads, Microsoft Ads, Meta, LinkedIn, X, Reddit, TikTok, Snapchat, Pinterest, Spotify, Amazon Ads (Sponsored Products, Brands ve Display), Amazon DSP, The Trade Desk ve OpenAI Ads. Display & Video 360 ve StackAdapt ayrıca kampanya oluşturma olmadan yazma işlemlerini (duraklatma, bütçe ve satır öğesi güncellemeleri, hedef kitle yükleme) destekler. Kalan 4 platform (Walmart Connect, Instacart, Target Roundel ve Criteo) bugün yalnızca raporlama sunar.

npx paketi, en yaygın işlemler için türlendirilmiş araçlar ve 140+ Synter aracının tam kataloğuna run_tool erişim sunar. https://mcp.syntermedia.ai/mcp/ adresindeki uzak sunucu, yukarıdaki her platform için performans çekmeleri dahil tam barındırılan araç setini kullanıma sunar.

Kayıt defteri tarzı MCP keşfi için server.json makine tarafından okunabilir gerçek kaynaktır. Bunu package.json, manifest.json ve bu README'deki kurulum örnekleriyle hizalı tutun.

---

⚠️ Açık Uyarı

Yapay zeka ajanınız şunları yapabilecek:

• Bütçenizi hemen harcamaya başlayan kampanyalar oluşturmak
• Tıklama başına ne kadar ödediğinizi etkileyen teklifleri ayarlamak
• Kampanyaları duraklatmak (bazen bu iyi bir şeydir)
• Reklamlarınızı kimin gördüğünü değiştiren anahtar kelimeler eklemek
• Yaratıcı içerikler üretmek ve bunları hesaplarınıza yüklemek

Yıkıcı işlemler için onaylar ekledik. Ama yine de, bunu yeni tanıştığınız bir ajana vermeyin.

---

Hızlı Başlangıç

1. API Anahtarınızı Alın

syntermedia.ai adresine kaydolun ve Developer Settings bölümünde bir API anahtarı oluşturun.

2. Yapay Zeka İstemcinizi Yapılandırın

Claude Desktop için: ~/Library/Application Support/Claude/claude_desktop_config.json dosyasına ekleyin:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Cursor için: Projenizdeki .cursor/mcp.json dosyasına ekleyin:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Amp için: .amp/settings.json dosyasına ekleyin:

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Uzak (Streamable HTTP): ChatGPT, n8n, Zapier veya HTTP taşımacılığını destekleyen herhangi bir MCP istemcisi için:

URL: https://mcp.syntermedia.ai/mcp/
Header: X-Synter-Key: syn_your_api_key_here

Yerel kurulum gerekmez. Streamable HTTP taşımacılığını destekleyen herhangi bir MCP istemcisiyle çalışır.

3. Kullanmaya Başlayın

Yapay zeka istemcinizi yeniden başlatın ve sohbet etmeye başlayın:

"Bana tüm Google Ads kampanyalarımı göster"

"'Proje yönetimi yazılımı' için günlük 50$ bütçeli bir arama kampanyası oluştur"

"Aşırı harcama yapan kampanyayı duraklat"

---

Tam bir eklenti mi tercih edersiniz? (Claude Code / Claude Desktop)

Bu paket ham MCP sunucusudur. Claude Code veya Claude Desktop kullanıyorsanız, Synter eklentisi aynı sunucuyu hazır becerilerle (/synter:launch, /synter:audience, /synter:optimize, …), özel ajanlarla ve harcama öncesi onay güvenlik kancasıyla sarar:

/plugin marketplace add Synter-Media-AI/plugin
/plugin install synter@synter

Ayrıca otomasyon için başsız bir Claude Agent SDK çalıştırıcısı içerir. Eklenti deposuna veya Claude Plugin rehberine bakın. Yalnızca araçları istediğinizde veya başka bir istemciye bağlarken bu MCP paketini doğrudan kullanın.

---

Ajanınız Neler Yapabilir?

📊 Kampanya Yönetimi

Araç	Açıklama
list_campaigns	Bağlı tüm platformlardaki kampanyaları listele
create_search_campaign	Anahtar kelimeler ve reklamlarla bir Google Search kampanyası oluştur
create_display_campaign	Görsellerle bir Google Display kampanyası oluştur
create_pmax_campaign	Bir Performance Max kampanyası oluştur
create_meta_campaign	Bir Facebook/Instagram kampanyası oluştur
create_linkedin_campaign	B2B için bir LinkedIn kampanyası oluştur
create_reddit_campaign	Bir Reddit kampanyası oluştur
pause_campaign	Herhangi bir kampanyayı duraklat
update_campaign_budget	Günlük bütçeyi değiştir

📈 Performans ve Analitik

Araç	Açıklama
get_performance	Gösterim, tıklama, harcama, dönüşüm, ROAS al
get_daily_spend	Platforma göre günlük harcama dökümü

🎯 Anahtar Kelimeler ve Hedefleme

Araç	Açıklama
add_keywords	Bir kampanyaya veya reklam grubuna anahtar kelime ekle
add_negative_keywords	İstenmeyen arama terimlerini engelle

🔄 Dönüşüm Takibi

Araç	Açıklama
create_conversion	Bir dönüşüm işlemi kur
list_conversions	Mevcut dönüşüm işlemlerini listele
diagnose_tracking	Takibin doğru kurulup kurulmadığını kontrol et

🎨 Yaratıcı İçerik Üretimi

Araç	Açıklama
generate_image	Yapay zeka ile reklam görselleri üret
generate_video	Yapay zeka ile video reklamlar üret
upload_image	Görselleri reklam varlığı olarak yükle

🔧 Yardımcı Araçlar

Araç	Açıklama
list_ad_accounts	Bağlı tüm reklam hesaplarını listele
run_tool	140+ Synter aracından herhangi birini doğrudan çalıştır

---

Reklam Deneyiminiz Yok mu? Sorun Değil.

Daha önce hiç reklam yönetmediyseniz, bilmeniz gerekenler şunlar:

Kampanya Nedir?

Bir kampanya bir proje klasörü gibidir. Reklamlarınızı, onları kimin gördüğünü ve ne kadar harcadığınızı içerir.

Campaign: "Q1 Lead Generation"
├── Budget: $50/day
├── Targeting: USA, people searching "project management"
└── Ads: Headlines, descriptions, images

Hangi Platformları Kullanabilirim?

Platform	En Uygun Olduğu Durum	Minimum Bütçe
Google Ads	Ürününüzü aktif olarak arayan kişiler	10$/gün
Meta (Facebook/Instagram)	Görsel ürünler, geniş kitleler	5$/gün
LinkedIn	B2B, kurumsal, iş arayanlar	25$/gün
Reddit	Niş topluluklar, teknoloji meraklısı kullanıcılar	5$/gün
Microsoft (Bing)	Yaşlı demografikler, B2B	10$/gün
TikTok	Z kuşağı, eğlence, e-ticaret	20$/gün

Kampanya Türleri Açıklandı

Arama Kampanyaları: Birisi belirli anahtar kelimeleri Google'da aradığında reklamınız gösterilir.

• Örnek: Birisi "en iyi CRM yazılımı" arar → Reklamınız görünür

Display Kampanyaları: Web sitelerinde ve uygulamalarda gösterilen görsel reklamlar.

• Örnek: Bir haber sitesindeki banner reklam

Performance Max (PMax): Google'ın yapay zekası reklamlarınızı her yerde gösterir (Search, YouTube, Display, Gmail, Maps).

• Örnek: Google sizin için en iyi yerleşimleri belirler

Video Kampanyaları: YouTube ve iş ortakı sitelerindeki video reklamlar.

• Örnek: Bir YouTube videosundan önceki 15 saniyelik reklam

Yaygın Terimler

Terim	Anlamı
Gösterim	Reklamınızın kaç kez gösterildiği
Tıklama	Reklamınıza kaç kişinin tıkladığı
TOG	Tıklama oranı (tıklamalar ÷ gösterimler × 100)
TTM	Tıklama başına maliyet
Dönüşüm	İstenen eylemler (kayıt, satın alma vb.)
ROAS	Reklam harcaması getirisi (gelir ÷ harcama)

İlk Kampanya Kontrol Listesi

İlk kampanyanızı oluşturmadan önce şunlara ihtiyacınız olacak:

1. ✅ İnsanların tıkladığında gideceği bir açılış sayfası URL'si
2. ✅ Kimlere ulaşmak istediğinize dair bir fikir (konum, ilgi alanları)
3. ✅ Rahat olduğunuz bir günlük bütçe (başlangıç için 10-50$)
4. ✅ Reklamınız için bazı başlıklar ve açıklamalar

Profesyonel ipucu: Google'da bir Arama kampanyasıyla başlayın. Anlaması en kolay olanıdır ve reklamları sunduğunuz şeyi zaten arayan kişilere gösterir.

---

Örnek Konuşmalar

İlk Kampanyanızı Oluşturun

Siz: SaaS ürünüm için bir Google Search kampanyası oluştur. "Ekip işbirliği yazılımı" ve "proje yönetimi araçları" arayan kişileri hedefle. Bütçe 25$/gün. Açılış sayfası https://myapp.com/signup

Ajan: Bu anahtar kelimelerle bir Arama kampanyası oluşturacağım. Hangi başlıkları kullanayım? İşte bazı öneriler:

• "Ekip İşbirliği Artık Basit"
• "Modern Ekipler için Proje Yönetimi"
• "Ücretsiz Başla - Kredi Kartı Gerekmez"

Performansı Kontrol Edin

Siz: Bu hafta kampanyalarım nasıl gidiyor?

Ajan: Son 7 günün performansı:

Kampanya	Harcama	Tıklama	Dönüşüm	ROAS
Marka Arama	142$	89	12	4.2x
Rakip Anahtar Kelimeler	98$	45	3	1.5x
Display Yeniden Hedefleme	67$	234	8	2.8x

"Rakip Anahtar Kelimeler" kampanyası düşük performans gösteriyor. Duraklatmamı veya hedeflemeyi ayarlamamı ister misiniz?

Negatif Anahtar Kelimeler Ekleyin

Siz: "ücretsiz proje yönetimi" için tıklamalar alıyorum ama ücretsiz bir sürümümüz yok. Bunları engelle.

Ajan: Kampanyanıza "ücretsiz" negatif anahtar kelimesini ekledim. Bu, "ücretsiz" içeren herhangi bir aramada reklamlarınızın gösterilmesini durduracaktır.

Reklam Yaratıcı İçeriği Üretin

Siz: Bir pazarlama otomasyonu ürünü için display reklam görseline ihtiyacım var. Koyu tema, profesyonel, 1200x628.

Ajan: Görselinizi oluşturuyorum...

Oluşturuldu: "Koyu arka planda veri görselleştirmeli pazarlama otomasyonu paneli" Varlık kaydedildi ve bir sonraki Display kampanyanızda kullanıma hazır.

---

Reklam Hesaplarınızı Bağlayın

Her platformda reklamları yönetmek için hesaplarınızı Synter'da bağlamanız gerekecek:

1. syntermedia.ai/settings/credentials adresine gidin
2. Her platformun yanındaki "Bağlan" düğmesine tıklayın
3. OAuth akışını tamamlayın
4. Ajanınız artık o platformu yönetebilir

Desteklenen Platformlar (19; ✅ = raporlama + tam kampanya yürütme, 📊 = raporlama):

• Google Ads ✅
• Meta (Facebook/Instagram) ✅
• LinkedIn Ads ✅
• Microsoft Ads (Bing) ✅
• Reddit Ads ✅
• TikTok Ads ✅
• X (Twitter) Ads ✅
• Snapchat Ads ✅
• Pinterest Ads ✅
• Spotify Ads ✅
• Amazon DSP ✅
• The Trade Desk ✅
• Amazon Ads 📊
• Walmart Connect 📊
• Instacart Ads 📊
• Target Roundel 📊
• Criteo 📊
• Display & Video 360 📊
• OpenAI Ads (ChatGPT) 📊

---

Gelişmiş: Doğrudan Araç Erişimi

Güç kullanıcıları için, 140+ Synter aracından herhangi birini doğrudan çağırabilirsiniz:

> Use run_tool to call google_ads_list_audiences

Tam araç listesini docs.syntermedia.ai/tools adresinde görün veya ajanınıza sorun:

> What tools are available for LinkedIn Ads?

Varsayılan Olarak Güvenli: Aksi Belirtilmedikçe execute Kuru Çalıştırmalar

Evrensel execute aracı, siz izin vermediğiniz sürece ilk çağrıda asla bir işlem çalıştırmaz. Varsayılan olarak (dry_run: true) isteği doğrular ve orada durur — hiçbir şey yürütülmez, hiçbir şey harcanmaz. İşlemi gerçekten çalıştırmak için dry_run: false değerini iletin; para harcayan herhangi bir şey için bunu yalnızca hesap sahibinin onayıyla yapın.

---

Ortam Değişkenleri

Değişken	Zorunlu	Açıklama
SYNTER_API_KEY	Evet	Synter API anahtarınız
SYNTER_API_URL	Hayır	API URL geçersiz kılma (varsayılan: https://syntermedia.ai)

---

Yerel Geliştirme

# Clone and install
git clone https://github.com/Synter-Media-AI/mcp-server.git
cd mcp-server
npm install

# Build
npm run build

# Run locally
SYNTER_API_KEY=syn_your_key_here node dist/index.js

---

Sorun Giderme

"SYNTER_API_KEY ayarlanmadı"

API anahtarınızın MCP yapılandırmanızın env bölümünde olduğundan emin olun. Anahtar syn_ ile başlamalıdır.

"Geçersiz veya süresi dolmuş API anahtarı"

1. Anahtarın tamamını kopyaladığınızı kontrol edin (uzunlar!)
2. Anahtarın syntermedia.ai/developer adresinde aktif olduğunu doğrulayın
3. Anahtarın tools:write kapsamına sahip olduğundan emin olun

"Bağlı reklam hesabı yok"

En az bir reklam platformu bağlamanız gerekir:

1. syntermedia.ai/settings/credentials adresine gidin
2. Google Ads'in (veya başka bir platformun) yanındaki "Bağlan" düğmesine tıklayın
3. OAuth yetkilendirmesini tamamlayın

Araçlar Claude/Cursor'da görünmüyor

1. AI istemcinizi tamamen yeniden başlatın (sadece yenilemeyin)
2. Hatalar için MCP sunucu günlüklerini kontrol edin
3. Yapılandırma dosyası yolunu ve JSON sözdizimini doğrulayın

---

SSS

Google Ads için bir MCP sunucusu var mı?

Evet, iki tür var. Google, resmi bir Google Ads MCP sunucusu sunuyor; bu sunucu mevcut sürümünde salt okunurdur: raporları, metrikleri ve meta verileri sorgulayabilir, ancak Google'ın belgelerine göre "teklifleri değiştiremez, kampanyaları duraklatamaz veya yeni varlıklar oluşturamaz." Bizim MCP sunucumuz Google Ads'i hem okuma hem yazma ile kapsar: Arama, Görüntülü ve Performance Max kampanyaları oluşturun, anahtar kelimeler ve negatif anahtar kelimeler ekleyin, bütçeleri ayarlayın, kampanyaları duraklatın, Customer Match kitlelerini yönetin, dönüşüm takibi kurun ve performans verilerini çekin. Aynı sunucu 18 diğer reklam platformunda raporlama yapar ve 11'inde tam kampanya yürütme sunar.

Claude veya ChatGPT reklam kampanyalarımı yönetebilir mi?

Evet. Synter MCP sunucusu bağlıyken Claude (Claude Desktop, Claude Code), ChatGPT, Cursor ve MCP uyumlu diğer tüm istemciler 14 reklam platformunda kampanya oluşturabilir, bütçeleri ayarlayabilir, düşük performans gösterenleri duraklatabilir, yaratıcı içerikler üretebilir ve kitleleri senkronize edebilir (16'sında yazma işlemleri) ve 19 platformun tamamında performans verilerini çekebilir. Claude ve diğer stdio istemcileri npx @synterai/mcp-server üzerinden bir SYNTER_API_KEY ile bağlanır; ChatGPT ve diğer HTTP istemcileri https://mcp.syntermedia.ai/mcp/ adresindeki uzak sunucuya bir X-Synter-Key başlığı ile bağlanır. Yıkıcı işlemlerde yerleşik onaylar bulunur.

Resmi Google Ads MCP ile Synter arasındaki fark nedir?

İki şey: yazma erişimi ve platform kapsamı. Resmi Google Ads MCP, mevcut sürümünde salt okunurdur ve yalnızca Google Ads'i kapsar. Synter 19 platformda raporlama yapar ve bunların 14'ünde tam kampanya oluşturma sunar: Google Ads, Meta, LinkedIn, Microsoft, TikTok, Amazon Ads, Amazon DSP, OpenAI Ads ve The Trade Desk dahil. Yalnızca Google Ads raporlamasına ihtiyacınız varsa, resmi sunucu sağlam bir seçimdir. Bulduklarını harekete geçirebilen bir ajan istiyorsanız - Google'da ve reklam verdiğiniz her yerde - Synter'ı bunun için geliştirdik.

---

Kaynaklar

• Synter Kılavuzu: syntermedia.ai/manual
• API Dokümantasyonu: docs.syntermedia.ai
• Claude Eklentisi: github.com/Synter-Media-AI/plugin (beceriler, ajanlar ve Claude Code / Masaüstü için bu MCP)
• Araç Referansı: docs.syntermedia.ai/tools
• MCP Sunucu Karşılaştırması: syntermedia.ai/blog/best-ad-platform-mcp-servers
• Ücretsiz Ajan Becerileri (47 açık kaynak): github.com/Synter-Media-AI/free-skills (ayrıca skills.sh üzerinde)
• Destek: hello@syntermedia.ai

---

Lisans

MIT Lisansı - ayrıntılar için LICENSE bölümüne bakın.

---

Kullanmanızı istemedikleri MCP uzantısı.
Çünkü reklam bütçeli AI ajanları her şeyi değiştirir.