Synter Ads

Synter MCP Server

Server MCP paling lengkap untuk periklanan.

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

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

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

---

Perbandingan Synter

Server MCP Google Ads resmi hanya-baca secara desain: menurut dokumentasi Google, server tersebut "ketat hanya-baca" dan "tidak dapat mengubah tawaran, 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	Hanya-baca (rilis saat ini)	Sering hanya-baca atau tulis parsial
Platform	19 pelaporan, 14 dengan pembuatan kampanye lengkap (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
Pembuatan kreatif AI	✅ Gambar, video, teks	❌	❌
Sinkronisasi audiens	✅ Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X	❌	❌
Keamanan	Konfirmasi untuk tindakan destruktif	n/a (hanya-baca)	Bervariasi
Sumber terbuka	✅ 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 menyediakan 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 kumpulan alat terhosting penuh, termasuk penarikan kinerja 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

Agen AI Anda akan dapat:

• Membuat kampanye yang langsung mulai menghabiskan anggaran Anda
• Menyesuaikan tawaran yang memengaruhi berapa banyak yang Anda bayar 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 Pengaturan Pengembang.

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"
      }
    }
  }
}

Jarak Jauh (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 keterampilan siap pakai (/synter:launch, /synter:audience, /synter:optimize, …), agen khusus, dan pengait keamanan persetujuan-sebelum-pengeluaran:

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

Plugin ini juga menyertakan runner Claude Agent SDK headless untuk otomatisasi. Lihat repositori plugin atau panduan Plugin Claude. Gunakan paket MCP ini secara langsung saat Anda hanya menginginkan alatnya, atau saat 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

📈 Kinerja & Analitik

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

🎯 Kata Kunci & Penargetan

Alat	Deskripsi
add_keywords	Tambahkan kata kunci ke kampanye atau grup iklan
add_negative_keywords	Blokir istilah penelusuran 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

🎨 Pembuatan 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

---

Belum Punya Pengalaman Iklan? Tidak Masalah.

Jika Anda belum pernah menjalankan iklan sebelumnya, berikut 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 Min
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 yang ditampilkan di berbagai situs web dan aplikasi.

• Contoh: Iklan banner di situs berita

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

• Contoh: Google menentukan 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 ÷ pengeluaran)

Daftar Periksa Kampanye Pertama

Sebelum membuat kampanye pertama Anda, Anda perlu:

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

Tips pro: Mulailah dengan kampanye Pencarian 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 Pencarian dengan kata kunci tersebut. Headline apa yang harus saya gunakan? Berikut beberapa saran:

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

Periksa Kinerja

Anda: Bagaimana kinerja kampanye saya minggu ini?

Agen: Berikut kinerja Anda selama 7 hari terakhir:

Kampanye	Pengeluaran	Klik	Konversi	ROAS
Brand Search	$142	89	12	4.2x
Competitor Keywords	$98	45	3	1.5x
Display Retargeting	$67	234	8	2.8x

Kampanye "Competitor Keywords" berkinerja buruk. Ingin saya jeda atau sesuaikan penargetannya?

Tambahkan Kata Kunci Negatif

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

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

Buat Kreatif Iklan

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

Agen: Membuat gambar Anda...

Dibuat: "Dasbor otomasi 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 "Hubungkan" 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 ke agen Anda:

> What tools are available for LinkedIn Ads?

Aman secara Default: execute Dry-Run Kecuali Diinstruksikan Lain

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

---

Variabel Lingkungan

Variable	Required	Description
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 tidak diatur"

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

"Kunci API tidak valid atau kedaluwarsa"

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

"Tidak ada akun iklan yang terhubung"

Anda perlu menghubungkan setidaknya satu platform iklan:

1. Buka syntermedia.ai/settings/credentials
2. Klik "Hubungkan" 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 menyegarkan)
2. Periksa log server MCP untuk mencari kesalahan
3. Verifikasi jalur file konfigurasi dan sintaks JSON

---

FAQ

Apakah ada server MCP untuk Google Ads?

Ya, ada dua jenis. Google merilis server Google Ads MCP resmi, yang bersifat hanya-baca dalam rilis saat ini: dapat menanyakan laporan, metrik, dan metadata, tetapi menurut dokumentasi Google, server tersebut "tidak dapat mengubah tawaran, 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, siapkan pelacakan konversi, dan tarik data performa. Server yang sama melaporkan 18 platform iklan lainnya dan menawarkan eksekusi kampanye penuh di 11 platform tersebut.

Bisakah Claude atau ChatGPT mengelola kampanye iklan saya?

Ya. Dengan server Synter MCP 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, menghasilkan konten 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 bersifat destruktif memiliki konfirmasi bawaan.

Apa perbedaan antara Google Ads MCP resmi dan Synter?

Dua hal: akses tulis dan cakupan platform. Google Ads MCP resmi bersifat hanya-baca dalam rilis saat ini dan hanya mencakup Google Ads. Synter melaporkan 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 memerlukan 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 alasan 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 detailnya.

---

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