Synter Ads

Server MCP Synter

Server MCP paling lengkap untuk periklanan.

Pelaporan di 19 platform iklan dan pembuatan kampanye penuh di 14 platform (tindakan tulis di 16), mencakup semua saluran pembelian utama, dengan konfirmasi bawaan untuk tindakan destruktif.

Buat kampanye. Sesuaikan anggaran. Jeda kampanye yang kurang performa. Hasilkan kreatif. Tarik data performa. Semua melalui percakapan alami, di Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, dan lainnya.

Ini adalah server Model Context Protocol (MCP) pertama yang memberikan kartu kredit kepada agen AI.

Catatan: Synter-Media-AI/plugin adalah repositori plugin Claude kanonik yang dapat diinstal. Salinan .claude-plugin/ di repositori ini bukan sumber instalasi.

---

Perbandingan Synter

Server MCP Google Ads resmi bersifat read-only secara desain: menurut dokumentasi Google, server tersebut "secara ketat read-only" dan "tidak dapat mengubah bid, menjeda kampanye, atau membuat aset baru." Sebagian besar server MCP iklan pihak ketiga hanya mencakup satu platform. Kami membangun Synter untuk melakukan kedua bagian pekerjaan ini, di semua saluran pembelian utama, dari satu server.

	Synter MCP	MCP Google Ads Resmi	MCP Iklan Pihak Ketiga Umum
Akses	Baca di semua 19 platform, pembuatan kampanye di 14, tindakan tulis di 16	Read-only (rilis saat ini)	Sering read-only atau tulis parsial
Platform	19 pelaporan, 14 dengan pembuatan kampanye penuh (daftar di bawah)	Hanya Google Ads	Biasanya satu platform
Buat kampanye	✅ Google Search, Display, PMax, Meta, LinkedIn, Reddit, lainnya melalui run_tool	❌	Jarang
Anggaran dan jeda	✅	❌	Bervariasi
Generasi kreatif AI	✅ Gambar, video, teks	❌	❌
Sinkronisasi audiens	✅ Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X	❌	❌
Keamanan	Konfirmasi untuk tindakan destruktif	n/a (read-only)	Bervariasi
Open source	✅ MIT	✅	Bervariasi

Cakupan pelaporan (19 platform): Google Ads, Microsoft Ads (Bing), Meta (Facebook dan 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, dan OpenAI Ads (ChatGPT).

Pembuatan kampanye penuh (14 platform): Google Ads, Microsoft Ads, Meta, LinkedIn, X, Reddit, TikTok, Snapchat, Pinterest, Spotify, Amazon Ads (Sponsored Products, Brands, dan Display), Amazon DSP, The Trade Desk, dan OpenAI Ads. Display & Video 360 dan StackAdapt juga mendukung tindakan tulis (jeda, pembaruan anggaran dan line-item, unggah audiens) tanpa pembuatan kampanye. 4 platform lainnya (Walmart Connect, Instacart, Target Roundel, dan Criteo) saat ini hanya pelaporan.

Paket npx menyertakan alat bertipe untuk operasi paling umum plus akses run_tool ke katalog lengkap 140+ alat Synter. Server jarak jauh di https://mcp.syntermedia.ai/mcp/ mengekspos set alat terhosting penuh, termasuk penarikan performa untuk setiap platform di atas.

Untuk penemuan MCP bergaya registry, server.json adalah sumber kebenaran yang dapat dibaca mesin. Jaga agar tetap selaras dengan package.json, manifest.json, dan contoh pengaturan di README ini.

---

⚠️ Peringatan Adil

Agen AI Anda akan dapat:

• Membuat kampanye yang langsung mulai menghabiskan anggaran Anda
• Menyesuaikan bid yang memengaruhi berapa banyak Anda membayar per klik
• Menjeda kampanye (terkadang itu hal yang baik)
• Menambahkan kata kunci yang mengubah siapa yang melihat iklan Anda
• Menghasilkan kreatif dan mengunggahnya ke akun Anda

Kami membangun konfirmasi untuk tindakan destruktif. Tapi tetap saja, mungkin jangan berikan ini ke agen yang baru Anda kenal.

---

Mulai Cepat

1. Dapatkan Kunci API Anda

Daftar di syntermedia.ai dan buat kunci API di Developer Settings.

2. Konfigurasi Klien AI Anda

Untuk Claude Desktop: Tambahkan ke ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Untuk Cursor: Tambahkan ke .cursor/mcp.json di proyek Anda:

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

Untuk Amp: Tambahkan ke .amp/settings.json:

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

Remote (Streamable HTTP): Untuk ChatGPT, n8n, Zapier, atau klien MCP apa pun yang mendukung transport HTTP:

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

Tidak perlu instalasi lokal. Berfungsi dengan klien MCP apa pun yang mendukung transport Streamable HTTP.

3. Mulai Menggunakannya

Mulai ulang klien AI Anda dan mulai mengobrol:

"Tunjukkan semua kampanye Google Ads saya"

"Buat kampanye pencarian untuk 'perangkat lunak manajemen proyek' dengan anggaran $50/hari"

"Jeda kampanye yang membelanjakan berlebihan"

---

Lebih suka plugin lengkap? (Claude Code / Claude Desktop)

Paket ini adalah server MCP mentah. Jika Anda menggunakan Claude Code atau Claude Desktop, plugin Synter membungkus server yang sama ini dengan skill siap pakai (/synter:launch, /synter:audience, /synter:optimize, …), agen khusus, dan hook keamanan persetujuan-sebelum-belanjakan:

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

Ini juga menyertakan runner Claude Agent SDK headless untuk otomatisasi. Lihat repositori plugin atau panduan Claude Plugin. Gunakan paket MCP ini secara langsung saat Anda hanya menginginkan alatnya, atau menghubungkan klien lain.

---

Apa yang Bisa Dilakukan Agen Anda?

📊 Manajemen Kampanye

Alat	Deskripsi
list_campaigns	Daftar kampanye di semua platform yang terhubung
create_search_campaign	Buat kampanye Google Search dengan kata kunci dan iklan
create_display_campaign	Buat kampanye Google Display dengan gambar
create_pmax_campaign	Buat kampanye Performance Max
create_meta_campaign	Buat kampanye Facebook/Instagram
create_linkedin_campaign	Buat kampanye LinkedIn untuk B2B
create_reddit_campaign	Buat kampanye Reddit
pause_campaign	Jeda kampanye apa pun
update_campaign_budget	Ubah anggaran harian

📈 Performa & Analitik

Alat	Deskripsi
get_performance	Dapatkan tayangan, klik, belanja, konversi, ROAS
get_daily_spend	Rincian belanja harian per platform

🎯 Kata Kunci & Penargetan

Alat	Deskripsi
add_keywords	Tambahkan kata kunci ke kampanye atau grup iklan
add_negative_keywords	Blokir istilah pencarian yang tidak diinginkan

🔄 Pelacakan Konversi

Alat	Deskripsi
create_conversion	Siapkan tindakan konversi
list_conversions	Daftar tindakan konversi yang ada
diagnose_tracking	Periksa apakah pelacakan terpasang dengan benar

🎨 Generasi Kreatif

Alat	Deskripsi
generate_image	Hasilkan gambar iklan dengan AI
generate_video	Hasilkan iklan video dengan AI
upload_image	Unggah gambar sebagai aset iklan

🔧 Utilitas

Alat	Deskripsi
list_ad_accounts	Daftar semua akun iklan yang terhubung
run_tool	Jalankan salah satu dari 140+ alat Synter secara langsung

---

Tidak Punya Pengalaman Iklan? Tidak Masalah.

Jika Anda belum pernah menjalankan iklan sebelumnya, ini yang perlu Anda ketahui:

Apa itu Kampanye?

Kampanye itu seperti folder proyek. Berisi iklan Anda, siapa yang melihatnya, dan berapa banyak yang Anda belanjakan.

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

Platform Apa yang Bisa Saya Gunakan?

Platform	Terbaik Untuk	Anggaran Minimum
Google Ads	Orang yang aktif mencari produk Anda	$10/hari
Meta (Facebook/Instagram)	Produk visual, audiens luas	$5/hari
LinkedIn	B2B, perusahaan, pencari kerja	$25/hari
Reddit	Komunitas niche, pengguna paham teknologi	$5/hari
Microsoft (Bing)	Demografi lebih tua, B2B	$10/hari
TikTok	Gen Z, hiburan, e-commerce	$20/hari

Jenis Kampanye Dijelaskan

Kampanye Pencarian: Iklan Anda muncul saat seseorang mencari kata kunci tertentu di Google.

• Contoh: Seseorang mencari "perangkat lunak CRM terbaik" → Iklan Anda muncul

Kampanye Display: Iklan gambar ditampilkan di situs web dan aplikasi.

• Contoh: Iklan banner di situs berita

Performance Max (PMax): AI Google menampilkan iklan Anda di mana saja (Search, YouTube, Display, Gmail, Maps).

• Contoh: Google mencari tahu penempatan terbaik untuk Anda

Kampanye Video: Iklan video di YouTube dan situs mitra.

• Contoh: Iklan 15 detik sebelum video YouTube

Istilah Umum

Istilah	Artinya
Tayangan	Berapa kali iklan Anda ditampilkan
Klik	Berapa banyak orang yang mengklik iklan Anda
CTR	Rasio klik-tayang (klik ÷ tayangan × 100)
CPC	Biaya per klik
Konversi	Tindakan yang diinginkan (pendaftaran, pembelian, dll.)
ROAS	Pengembalian belanja iklan (pendapatan ÷ belanja)

Daftar Periksa Kampanye Pertama

Sebelum membuat kampanye pertama Anda, Anda perlu:

1. ✅ URL halaman arahan tempat orang akan pergi saat mengklik
2. ✅ Ide tentang siapa yang ingin Anda jangkau (lokasi, minat)
3. ✅ Anggaran harian yang Anda nyaman ($10-50 untuk memulai)
4. ✅ Beberapa judul dan deskripsi untuk iklan Anda

Tips pro: Mulailah dengan kampanye Search di Google. Itu yang paling mudah dipahami dan menampilkan iklan kepada orang yang sudah mencari apa yang Anda tawarkan.

---

Contoh Percakapan

Buat Kampanye Pertama Anda

Anda: Buat kampanye Google Search untuk produk SaaS saya. Targetkan orang yang mencari "perangkat lunak kolaborasi tim" dan "alat manajemen proyek". Anggaran $25/hari. Halaman arahan adalah https://myapp.com/signup

Agen: Saya akan membuat kampanye Search dengan kata kunci tersebut. Judul apa yang harus saya gunakan? Berikut beberapa saran:

• "Kolaborasi Tim Menjadi Sederhana"
• "Manajemen Proyek untuk Tim Modern"
• "Mulai Gratis - Tanpa Kartu Kredit"

Periksa Performa

Anda: Bagaimana performa kampanye saya minggu ini?

Agen: Ini performa Anda selama 7 hari terakhir:

Kampanye	Belanja	Klik	Konversi	ROAS
Brand Search	$142	89	12	4.2x
Kata Kunci Kompetitor	$98	45	3	1.5x
Retargeting Display	$67	234	8	2.8x

Kampanye "Kata Kunci Kompetitor" kurang performa. Ingin saya jeda atau sesuaikan penargetannya?

Tambahkan Kata Kunci Negatif

Anda: Saya mendapat klik untuk "manajemen proyek gratis" tapi kami tidak punya tier gratis. Blokir itu.

Agen: Ditambahkan "gratis" sebagai kata kunci negatif ke kampanye Anda. Ini akan menghentikan iklan Anda muncul untuk pencarian apa pun yang mengandung "gratis".

Hasilkan Kreatif Iklan

Anda: Saya butuh gambar iklan display untuk produk otomatisasi pemasaran. Tema gelap, profesional, 1200x628.

Agen: Menghasilkan gambar Anda...

Dibuat: "Dasbor otomatisasi pemasaran dengan visualisasi data di latar belakang gelap" Aset disimpan dan siap digunakan di kampanye Display berikutnya.

---

Hubungkan Akun Iklan Anda

Untuk mengelola iklan di setiap platform, Anda perlu menghubungkan akun Anda di Synter:

1. Buka syntermedia.ai/settings/credentials
2. Klik "Connect" di samping setiap platform
3. Selesaikan alur OAuth
4. Agen Anda sekarang dapat mengelola platform tersebut

Platform yang Didukung (19; ✅ = pelaporan + eksekusi kampanye penuh, 📊 = pelaporan):

• 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) 📊

---

Lanjutan: Akses Alat Langsung

Untuk pengguna tingkat lanjut, Anda dapat memanggil salah satu dari 140+ alat Synter secara langsung:

> Use run_tool to call google_ads_list_audiences

Lihat daftar alat lengkap di docs.syntermedia.ai/tools atau tanyakan agen Anda:

> What tools are available for LinkedIn Ads?

Aman Secara Default: execute Dry-Run Kecuali Diinstruksikan Lain

Alat universal execute tidak pernah menjalankan aksi pada panggilan pertama kecuali Anda memilih untuk ikut serta. Secara default (dry_run: true), alat ini memvalidasi permintaan dan berhenti di sana — tidak ada yang dieksekusi, tidak ada yang mengeluarkan biaya. Berikan dry_run: false untuk benar-benar menjalankan aksi; untuk hal apa pun yang mengeluarkan uang, lakukan itu hanya dengan persetujuan pemilik akun.

---

Variabel Lingkungan

Variabel	Wajib	Deskripsi
SYNTER_API_KEY	Ya	Kunci API Synter Anda
SYNTER_API_URL	Tidak	Penggantian URL API (default: https://syntermedia.ai)

---

Pengembangan Lokal

# 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

---

Pemecahan Masalah

"SYNTER_API_KEY not set"

Pastikan kunci API Anda ada di bagian env dari konfigurasi MCP Anda. Kunci tersebut harus diawali dengan syn_.

"Invalid or expired API key"

1. Periksa bahwa Anda menyalin kunci lengkap (kuncinya panjang!)
2. Verifikasi bahwa kunci aktif di syntermedia.ai/developer
3. Pastikan kunci memiliki cakupan tools:write

"No ad accounts connected"

Anda perlu menghubungkan setidaknya satu platform iklan:

1. Buka syntermedia.ai/settings/credentials
2. Klik "Connect" di samping Google Ads (atau platform lain)
3. Selesaikan otorisasi OAuth

Alat tidak muncul di Claude/Cursor

1. Mulai ulang klien AI Anda sepenuhnya (bukan hanya muat ulang)
2. Periksa log server MCP untuk melihat kesalahan
3. Verifikasi jalur file konfigurasi dan sintaks JSON

---

FAQ

Apakah ada server MCP untuk Google Ads?

Ya, ada dua jenis. Google merilis server MCP Google Ads resmi, yang bersifat read-only dalam rilis saat ini: server tersebut dapat meminta laporan, metrik, dan metadata, tetapi menurut dokumentasi Google, server tersebut "tidak dapat mengubah bid, menjeda kampanye, atau membuat aset baru." Server MCP kami mencakup Google Ads dengan akses baca dan tulis: buat kampanye Search, Display, dan Performance Max, tambahkan kata kunci dan kata kunci negatif, sesuaikan anggaran, jeda kampanye, kelola audiens Customer Match, atur pelacakan konversi, dan tarik data performa. Server yang sama melaporkan di 18 platform iklan lainnya dan menawarkan eksekusi kampanye penuh di 11 di antaranya.

Bisakah Claude atau ChatGPT mengelola kampanye iklan saya?

Ya. Dengan server MCP Synter terhubung, Claude (Claude Desktop, Claude Code), ChatGPT, Cursor, dan klien lain yang kompatibel dengan MCP dapat membuat kampanye, menyesuaikan anggaran, menjeda kampanye yang berkinerja buruk, membuat kreatif, dan menyinkronkan audiens di 14 platform iklan (aksi tulis di 16), serta menarik data performa di seluruh 19 platform. Claude dan klien stdio lainnya terhubung melalui npx @synterai/mcp-server dengan SYNTER_API_KEY; ChatGPT dan klien HTTP lainnya terhubung ke server jarak jauh di https://mcp.syntermedia.ai/mcp/ dengan header X-Synter-Key. Aksi yang merusak memiliki konfirmasi bawaan.

Apa perbedaan antara MCP Google Ads resmi dan Synter?

Dua hal: akses tulis dan cakupan platform. MCP Google Ads resmi bersifat read-only dalam rilis saat ini dan hanya mencakup Google Ads. Synter melaporkan di 19 platform dan menawarkan pembuatan kampanye penuh di 14 di antaranya, termasuk Google Ads, Meta, LinkedIn, Microsoft, TikTok, Amazon Ads, Amazon DSP, OpenAI Ads, dan The Trade Desk. Jika Anda hanya membutuhkan pelaporan Google Ads, server resmi adalah pilihan yang solid. Jika Anda menginginkan agen yang dapat bertindak berdasarkan apa yang ditemukannya, di Google dan di semua tempat lain tempat Anda beriklan, itulah tujuan kami membangun Synter.

---

Sumber Daya

• Manual Synter: syntermedia.ai/manual
• Dokumentasi API: docs.syntermedia.ai
• Plugin Claude: github.com/Synter-Media-AI/plugin (keterampilan, agen & MCP ini untuk Claude Code / Desktop)
• Referensi Alat: docs.syntermedia.ai/tools
• Perbandingan Server MCP: syntermedia.ai/blog/best-ad-platform-mcp-servers
• Keterampilan Agen Gratis (47 open-source): github.com/Synter-Media-AI/free-skills (juga di skills.sh)
• Dukungan: hello@syntermedia.ai

---

Lisensi

Lisensi MIT - lihat LICENSE untuk detail.

---

Ekstensi MCP yang tidak ingin mereka gunakan.
Karena agen AI dengan anggaran iklan mengubah segalanya.