Synter Ads

Synter MCP Sunucusu

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

19 reklam platformunda raporlama ve 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ü doğal konuşma yoluyla; Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X ve daha fazlasında.

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

Not: Synter-Media-AI/plugin kurulabilir kanonik Claude eklenti deposudur. Bu depodaki .claude-plugin/ kopyası kurulum kaynağı değildir.

---

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 okunur"dur 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'ı işin her iki yarısını da, tüm büyük satın alma kanallarında, tek bir sunucudan yapmak için geliştirdik.

	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'ünde tam kampanya oluşturma (listeler aşağıda)	Yalnızca Google Ads	Genellikle tek bir platform
Kampanya oluşturma	✅ Google Search, Display, PMax, Meta, LinkedIn, Reddit, run_tool üzerinden 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 yazılmış araçların yanı sıra 140+ Synter aracının tam kataloğuna run_tool erişimi 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. package.json, manifest.json ve bu README'deki kurulum örnekleriyle uyumlu tutun.

---

⚠️ Açık Uyarı

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

• Bütçenizi anında harcamaya başlayan kampanyalar oluşturma
• Tıklama başına ne kadar ödediğinizi etkileyen teklifleri ayarlama
• Kampanyaları duraklatma (bazen bu iyi bir şeydir)
• Reklamlarınızı kimlerin göreceğini değiştiren anahtar kelimeler ekleme
• Yaratıcı içerikler üretme ve bunları hesaplarınıza yükleme

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 Geliştirici Ayarları 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"
      }
    }
  }
}

Uzaktan (Streamable HTTP): ChatGPT, n8n, Zapier veya HTTP taşıması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şıması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 Eklenti 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ı listeler
create_search_campaign	Anahtar kelimeler ve reklamlarla bir Google Arama kampanyası oluşturur
create_display_campaign	Görsellerle bir Google Display kampanyası oluşturur
create_pmax_campaign	Bir Performance Max kampanyası oluşturur
create_meta_campaign	Bir Facebook/Instagram kampanyası oluşturur
create_linkedin_campaign	B2B için bir LinkedIn kampanyası oluşturur
create_reddit_campaign	Bir Reddit kampanyası oluşturur
pause_campaign	Herhangi bir kampanyayı duraklatır
update_campaign_budget	Günlük bütçeyi değiştirir

📈 Performans ve Analitik

Araç	Açıklama
get_performance	Gösterim, tıklama, harcama, dönüşüm, ROAS alır
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 ekler
add_negative_keywords	İstenmeyen arama terimlerini engeller

🔄 Dönüşüm Takibi

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

🎨 Yaratıcı İçerik Üretimi

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

🔧 Yardımcı

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

---

Reklam Deneyiminiz Yok mu? Sorun Değil.

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

Kampanya Nedir?

Bir kampanya bir proje klasörü gibidir. Reklamlarınızı, onları kimlerin göreceğini 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ı: Reklamınız, birisi belirli anahtar kelimeleri Google'da aradığında 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 sitesinde banner reklam

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

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

Video Kampanyaları: YouTube ve partner sitelerde video reklamlar.

• Örnek: Bir YouTube videosundan önce 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)
TBM	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

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

---

Örnek Konuşmalar

İlk Kampanyanızı Oluşturun

Siz: SaaS ürünüm için bir Google Arama kampanyası oluştur. "Ekip işbirliği yazılımı" ve "proje yönetimi araçları" arayan kişileri hedefle. Bütçe günlük $25. 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şlayın - Kredi Kartı Gerekmez"

Performansı Kontrol Edin

Siz: Kampanyalarım bu hafta nasıl gidiyor?

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

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: "ücretsiz" kelimesini kampanyanıza negatif anahtar kelime olarak ekledim. Bu, reklamlarınızın "ücretsiz" içeren herhangi bir aramada gösterilmesini durduracaktır.

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

Siz: Pazarlama otomasyonu ürünü için bir 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 kontrol 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"a tıklayın
3. OAuth akışını tamamlayın
4. Ajanınız artık bu 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: execute Aksi Belirtilmedikçe Kuru Çalıştırma

execute evrensel aracı, siz açıkça 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 parametresini 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 (yalnızca yenilemek değil)
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 sunar; 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 diğer 18 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ığıyla 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 Google Ads, Meta, LinkedIn, Microsoft, TikTok, Amazon Ads, Amazon DSP, OpenAI Ads ve The Trade Desk dahil olmak üzere 14'ünde tam kampanya oluşturma sunar. Yalnızca Google Ads raporlamasına ihtiyacınız varsa, resmi sunucu sağlam bir seçimdir. Bulduklarını Google'da ve reklam verdiğiniz her yerde harekete geçebilen bir aracı istiyorsanız, 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 (Claude Code / Desktop için beceriler, aracılar ve bu MCP)
• Araç Referansı: docs.syntermedia.ai/tools
• MCP Sunucu Karşılaştırması: syntermedia.ai/blog/best-ad-platform-mcp-servers
• Ücretsiz Aracı 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 aracıları her şeyi değiştirir.