Synter Ads MCP Server
resmiManajemen kampanye iklan lintas platform untuk agen AI di Google, Meta, LinkedIn, Reddit, TikTok, dan lainnya. 140+ alat dengan akses baca/tulis.
Dokumentasi
Server MCP Synter
Ekstensi MCP yang Claude tidak ingin Anda gunakan.
Karena begitu Anda memasangnya, agen AI Anda dapat membelanjakan uang sungguhan.
Buat kampanye. Sesuaikan anggaran. Jeda yang berkinerja buruk. Hasilkan materi iklan. Tarik data performa. Semua melalui percakapan alami—di Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, dan lainnya.
Ini adalah server Model Context Protocol (MCP) pertama yang memberikan kartu kredit kepada agen AI.
Mengapa Synter?
Kebanyakan server MCP periklanan bersifat hanya-baca dan platform tunggal. Synter adalah satu-satunya server MCP manajemen iklan lintas platform dengan kemampuan baca + tulis penuh:
| Fitur | Synter | Google Ads MCP | Amazon Ads MCP | Lainnya |
|---|---|---|---|---|
| Platform | 9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD) | Hanya Google | Hanya Amazon | 1-2 |
| Buat kampanye | ✅ | ❌ Hanya-baca | ✅ Hanya Amazon | ❌ |
| Sesuaikan anggaran | ✅ | ❌ | ✅ | ❌ |
| Jeda kampanye | ✅ | ❌ | ✅ | ❌ |
| Pembuatan materi iklan AI | ✅ (Imagen 4, Veo, Flux) | ❌ | ❌ | ❌ |
| Optimasi tawaran | ✅ | ❌ | ❌ | ❌ |
| Ahli Strategi AI | ✅ | ❌ | ❌ | ❌ |
| Sumber terbuka | ✅ | ✅ | ❌ | Bervariasi |
Satu server MCP. Setiap platform iklan. Baca dan tulis.
⚠️ Peringatan
Agen AI Anda akan dapat:
- Membuat kampanye yang segera mulai membelanjakan anggaran Anda
- Menyesuaikan tawaran 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 materi iklan dan mengunggahnya ke akun Anda
Kami menyediakan konfirmasi untuk tindakan destruktif. Namun tetap saja—mungkin jangan berikan ini kepada agen yang baru Anda kenal.
Mulai Cepat
1. Dapatkan Kunci API Anda
Daftar di syntermedia.ai dan buat kunci API di Pengaturan Pengembang.
2. Konfigurasikan 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 (HTTP Streamable) — 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. Bekerja dengan klien MCP apa pun yang mendukung transport HTTP Streamable.
3. Mulai Menggunakannya
Mulai ulang klien AI Anda dan mulailah mengobrol:
"Tampilkan semua kampanye Google Ads saya"
"Buat kampanye pencarian untuk 'perangkat lunak manajemen proyek' dengan anggaran $50/hari"
"Jeda kampanye yang kelebihan anggaran"
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-belanja:
/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 Plugin Claude. Gunakan paket MCP ini secara langsung ketika Anda hanya ingin alatnya, atau sedang menghubungkan klien lain.
Apa yang Dapat 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 impresi, 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 |
🎨 Pembuatan Materi Iklan
| Alat | Deskripsi |
|---|---|
generate_image | Hasilkan gambar iklan dengan AI (Imagen 4, Flux, SDXL) |
generate_video | Hasilkan iklan video dengan AI (Veo, Runway, Luma) |
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 Ada Pengalaman Iklan? Tidak Masalah.
Jika Anda belum pernah menjalankan iklan sebelumnya, inilah yang perlu Anda ketahui:
Apa itu Kampanye?
Kampanye itu seperti folder proyek. Ini 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 Dapat 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 |
| B2B, perusahaan, pencari kerja | $25/hari | |
| 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 ketika seseorang mengetik kata kunci tertentu di Google.
- Contoh: Seseorang mencari "perangkat lunak CRM terbaik" → Iklan Anda muncul
Kampanye Display — Iklan gambar ditampilkan di seluruh situs web dan aplikasi.
- Contoh: Iklan spanduk di situs berita
Performance Max (PMax) — AI Google menampilkan iklan Anda di mana-mana (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 |
|---|---|
| Impresi | Berapa kali iklan Anda ditampilkan |
| Klik | Berapa banyak orang yang mengklik iklan Anda |
| CTR | Rasio klik-tayang (klik ÷ impresi × 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 memerlukan:
- ✅ URL halaman arahan tempat orang akan pergi ketika mereka mengklik
- ✅ Gagasan tentang siapa yang ingin Anda jangkau (lokasi, minat)
- ✅ Anggaran harian yang Anda rasa nyaman ($10-50 untuk memulai)
- ✅ Beberapa judul dan deskripsi untuk iklan Anda
Kiat pro: Mulailah dengan kampanye Pencarian di Google. Ini 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. Judul apa yang harus saya gunakan? Berikut beberapa saran:
- "Kolaborasi Tim Menjadi Mudah"
- "Manajemen Proyek untuk Tim Modern"
- "Mulai Gratis - Tanpa Kartu Kredit"
Periksa Performa
Anda: Bagaimana kinerja kampanye saya minggu ini?
Agen: Berikut performa Anda selama 7 hari terakhir:
Kampanye Belanja Klik Konversi ROAS Pencarian Merek $142 89 12 4.2x Kata Kunci Pesaing $98 45 3 1.5x Penargetan Ulang Display $67 234 8 2.8x Kampanye "Kata Kunci Pesaing" berkinerja buruk. Ingin saya jeda atau sesuaikan penargetannya?
Tambahkan Kata Kunci Negatif
Anda: Saya mendapatkan klik untuk "manajemen proyek gratis" tetapi kami tidak memiliki tingkat gratis. Blokir itu.
Agen: Menambahkan "gratis" sebagai kata kunci negatif ke kampanye Anda. Ini akan menghentikan iklan Anda muncul untuk pencarian apa pun yang mengandung "gratis".
Hasilkan Materi Iklan
Anda: Saya perlu gambar iklan display untuk produk otomatisasi pemasaran. Tema gelap, profesional, 1200x628.
Agen: Menghasilkan gambar Anda dengan Imagen 4...
Dibuat: "Dasbor otomatisasi pemasaran dengan visualisasi data pada latar belakang gelap" Aset disimpan dan siap digunakan di kampanye Display Anda berikutnya.
Hubungkan Akun Iklan Anda
Untuk mengelola iklan di setiap platform, Anda perlu menghubungkan akun Anda di Synter:
- Buka syntermedia.ai/settings/credentials
- Klik "Hubungkan" di samping setiap platform
- Selesaikan alur OAuth
- Agen Anda sekarang dapat mengelola platform tersebut
Platform yang Didukung:
- Google Ads ✅
- Meta (Facebook/Instagram) ✅
- LinkedIn Ads ✅
- Microsoft Ads (Bing) ✅
- Reddit Ads ✅
- TikTok Ads ✅
- X (Twitter) Ads ✅
- StackAdapt ✅
- The Trade Desk ✅
Lanjutan: Akses Alat Langsung
Untuk pengguna mahir, 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?
Variabel Lingkungan
| Variabel | Diperlukan | Deskripsi |
|---|---|---|
SYNTER_API_KEY | Ya | Kunci API Synter Anda |
SYNTER_API_URL | Tidak | Timpa 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 disetel"
Pastikan kunci API Anda ada di bagian env dari konfigurasi MCP Anda. Kuncinya harus dimulai dengan syn_.
"Kunci API tidak valid atau kedaluwarsa"
- Periksa apakah Anda menyalin kunci lengkap (kuncinya panjang!)
- Verifikasi kunci aktif di syntermedia.ai/developer
- Pastikan kunci memiliki cakupan
tools:write
"Tidak ada akun iklan yang terhubung"
Anda perlu menghubungkan setidaknya satu platform iklan:
- Buka syntermedia.ai/settings/credentials
- Klik "Hubungkan" di samping Google Ads (atau platform lain)
- Selesaikan otorisasi OAuth
Alat tidak muncul di Claude/Cursor
- Mulai ulang klien AI Anda sepenuhnya (bukan hanya segarkan)
- Periksa log server MCP untuk kesalahan
- Verifikasi jalur file konfigurasi dan sintaks JSON
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 sumber terbuka): github.com/Synter-Media-AI/free-skills — juga di skills.sh
- Dukungan: [email protected]
Lisensi
Lisensi MIT - lihat LICENSE untuk detailnya.
Ekstensi MCP yang mereka tidak ingin Anda gunakan.
Karena agen AI dengan anggaran iklan mengubah segalanya.