Synter Ads MCP Server

resmi

Google, Meta, LinkedIn, Reddit, TikTok ve daha fazlasında AI ajanları için çapraz platform reklam kampanyası yönetimi. Okuma/yazma erişimine sahip 140'tan fazla araç.

GitHub

Dokümantasyon

Synter MCP Sunucusu

Claude'un kullanmanızı istemediği MCP eklentisi.

Çünkü bir kez yüklediğinizde, yapay zeka ajanınız gerçek para harcayabilir.

Kampanyalar oluşturun. Bütçeleri ayarlayın. Düşük performans gösterenleri duraklatın. Kreatifler oluşturun. Performans verilerini çekin. Hepsi doğal konuşma yoluyla—Google, Meta, LinkedIn, Microsoft, Reddit, TikTok ve daha fazlasında.

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

Neden Synter?

Çoğu reklamcılık MCP sunucusu salt okunur ve tek platformludur. Synter, tam okuma + yazma yeteneklerine sahip tek çapraz platform reklam yönetimi MCP sunucusudur:

Özellik	Synter	Google Ads MCP	Amazon Ads MCP	Diğerleri
Platformlar	9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD)	Yalnızca Google	Yalnızca Amazon	1-2
Kampanya oluşturma	✅	❌ Salt okunur	✅ Yalnızca Amazon	❌
Bütçe ayarlama	✅	❌	✅	❌
Kampanya duraklatma	✅	❌	✅	❌
Yapay zeka kreatif üretimi	✅ (Imagen 4, Veo, Flux)	❌	❌	❌
Teklif optimizasyonu	✅	❌	❌	❌
Yapay Zeka Stratejisti	✅	❌	❌	❌
Açık kaynak	✅	✅	❌	Değişir

Tek bir MCP sunucusu. Her reklam platformu. Okuma ve yazma.

⚠️ Adil Uyarı

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

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

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

Hızlı Başlangıç

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

syntermedia.ai adresinden kaydolun ve Geliştirici Ayarları bölümünden 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 (Akışlı HTTP) — ChatGPT, n8n, Zapier veya HTTP aktarımı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. Akışlı HTTP aktarımı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"

"Fazla 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 bu aynı sunucuyu hazır beceriler (/synter:launch, /synter:audience, /synter:optimize, …), özel ajanlar 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ı da sunar. Eklenti deposuna veya Claude Eklenti kılavuzuna bakın. Yalnızca araçları istediğinizde veya başka bir istemci bağladığınızda bu MCP paketini doğrudan kullanın.

Ajanınız Ne 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 Arama kampanyası oluştur
`create_display_campaign`	Görsellerle bir Google Görüntülü Reklam 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österimleri, tıklamaları, harcamayı, dönüşümleri, 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 eylemi ayarla
`list_conversions`	Mevcut dönüşüm eylemlerini listele
`diagnose_tracking`	Takibin doğru kurulup kurulmadığını kontrol et

🎨 Kreatif Üretimi

Araç	Açıklama
`generate_image`	Yapay zeka ile reklam görselleri oluştur (Imagen 4, Flux, SDXL)
`generate_video`	Yapay zeka ile video reklamlar oluştur (Veo, Runway, Luma)
`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'tan fazla Synter aracından herhangi birini doğrudan çalıştır

Reklam Deneyiminiz Yok mu? Sorun Değil.

Daha önce hiç reklam yayınlamadıysanız, bilmeniz gerekenler:

Kampanya Nedir?

Bir kampanya, bir proje klasörü gibidir. Reklamlarınızı, onları kimin göreceğini ve ne kadar harcayacağı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 İyi Olduğu Alan	Min 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)	Daha yaşlı demografi, 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

Görüntülü Reklam 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, Görüntülü Reklam, Gmail, Haritalar).

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

Video Kampanyaları — YouTube ve partner sitelerinde video reklamlar.

Örnek: Bir YouTube videosundan önce 15 saniyelik reklam

Yaygın Terimler

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

İlk Kampanya Kontrol Listesi

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

✅ İnsanların tıkladığında gideceği bir açılış sayfası URL'si
✅ Kime ulaşmak istediğinize dair bir fikir (konum, ilgi alanları)
✅ Rahat olduğunuz bir günlük bütçe (başlangıç için 10-50$)
✅ 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ı 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ı kullanmalıyım? İşte bazı öneriler:

"Ekip İşbirliği Basitleştirildi"

"Modern Ekipler için Proje Yönetimi"

"Ücretsiz Başlayın - Kredi Kartı Yok"

Performansı Kontrol Edin

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

Ajan: İşte son 7 günlük performansınız:

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

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

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

Negatif Anahtar Kelimeler Ekleyin

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

Ajan: Kampanyanıza negatif anahtar kelime olarak "ücretsiz" eklendi. Bu, reklamlarınızın "ücretsiz" içeren herhangi bir aramada gösterilmesini durduracak.

Reklam Kreatifi Oluşturun

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

Ajan: Imagen 4 ile görseliniz oluşturuluyor...

Oluşturuldu: "Koyu arka planda veri görselleştirmeli pazarlama otomasyonu panosu" Varlık kaydedildi ve bir sonraki Görüntülü Reklam kampanyanızda kullanıma hazır.

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

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

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

Desteklenen Platformlar:

Google Ads ✅
Meta (Facebook/Instagram) ✅
LinkedIn Ads ✅
Microsoft Ads (Bing) ✅
Reddit Ads ✅
TikTok Ads ✅
X (Twitter) Ads ✅
StackAdapt ✅
The Trade Desk ✅

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

Uzman kullanıcılar için 140'tan fazla 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örebilir veya ajanınıza sorabilirsiniz:

> What tools are available for LinkedIn Ads?

Ortam Değişkenleri

Değişken	Gerekli	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ı"

Tam anahtarı kopyaladığınızı kontrol edin (uzundurlar!)
Anahtarın syntermedia.ai/developer adresinde aktif olduğunu doğrulayın
Anahtarın tools:write kapsamına sahip olduğundan emin olun

"Bağlı reklam hesabı yok"

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

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

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

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

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, ajanlar ve 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: [email protected]

Lisans

MIT Lisansı - ayrıntılar için LICENSE dosyasına bakın.

Kullanmanızı istemedikleri MCP eklentisi.
Çünkü reklam bütçeli yapay zeka ajanları her şeyi değiştirir.