Synter Ads MCP Server

resmi

Manajemen 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

npm version License: MIT

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:

FiturSynterGoogle Ads MCPAmazon Ads MCPLainnya
Platform9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD)Hanya GoogleHanya Amazon1-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 terbukaBervariasi

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

AlatDeskripsi
list_campaignsDaftar kampanye di semua platform yang terhubung
create_search_campaignBuat kampanye Google Search dengan kata kunci dan iklan
create_display_campaignBuat kampanye Google Display dengan gambar
create_pmax_campaignBuat kampanye Performance Max
create_meta_campaignBuat kampanye Facebook/Instagram
create_linkedin_campaignBuat kampanye LinkedIn untuk B2B
create_reddit_campaignBuat kampanye Reddit
pause_campaignJeda kampanye apa pun
update_campaign_budgetUbah anggaran harian

📈 Performa & Analitik

AlatDeskripsi
get_performanceDapatkan impresi, klik, belanja, konversi, ROAS
get_daily_spendRincian belanja harian per platform

🎯 Kata Kunci & Penargetan

AlatDeskripsi
add_keywordsTambahkan kata kunci ke kampanye atau grup iklan
add_negative_keywordsBlokir istilah pencarian yang tidak diinginkan

🔄 Pelacakan Konversi

AlatDeskripsi
create_conversionSiapkan tindakan konversi
list_conversionsDaftar tindakan konversi yang ada
diagnose_trackingPeriksa apakah pelacakan terpasang dengan benar

🎨 Pembuatan Materi Iklan

AlatDeskripsi
generate_imageHasilkan gambar iklan dengan AI (Imagen 4, Flux, SDXL)
generate_videoHasilkan iklan video dengan AI (Veo, Runway, Luma)
upload_imageUnggah gambar sebagai aset iklan

🔧 Utilitas

AlatDeskripsi
list_ad_accountsDaftar semua akun iklan yang terhubung
run_toolJalankan 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?

PlatformTerbaik UntukAnggaran Min
Google AdsOrang yang aktif mencari produk Anda$10/hari
Meta (Facebook/Instagram)Produk visual, audiens luas$5/hari
LinkedInB2B, perusahaan, pencari kerja$25/hari
RedditKomunitas niche, pengguna paham teknologi$5/hari
Microsoft (Bing)Demografi lebih tua, B2B$10/hari
TikTokGen 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

IstilahArtinya
ImpresiBerapa kali iklan Anda ditampilkan
KlikBerapa banyak orang yang mengklik iklan Anda
CTRRasio klik-tayang (klik ÷ impresi × 100)
CPCBiaya per klik
KonversiTindakan yang diinginkan (pendaftaran, pembelian, dll.)
ROASPengembalian belanja iklan (pendapatan ÷ belanja)

Daftar Periksa Kampanye Pertama

Sebelum membuat kampanye pertama Anda, Anda memerlukan:

  1. ✅ URL halaman arahan tempat orang akan pergi ketika mereka mengklik
  2. ✅ Gagasan tentang siapa yang ingin Anda jangkau (lokasi, minat)
  3. ✅ Anggaran harian yang Anda rasa nyaman ($10-50 untuk memulai)
  4. ✅ 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:

KampanyeBelanjaKlikKonversiROAS
Pencarian Merek$14289124.2x
Kata Kunci Pesaing$984531.5x
Penargetan Ulang Display$6723482.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:

  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:

  • 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

VariabelDiperlukanDeskripsi
SYNTER_API_KEYYaKunci API Synter Anda
SYNTER_API_URLTidakTimpa 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"

  1. Periksa apakah Anda menyalin kunci lengkap (kuncinya panjang!)
  2. Verifikasi 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 segarkan)
  2. Periksa log server MCP untuk kesalahan
  3. Verifikasi jalur file konfigurasi dan sintaks JSON

Sumber Daya


Lisensi

Lisensi MIT - lihat LICENSE untuk detailnya.


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