Synter Ads
resmiManajemen kampanye iklan lintas platform untuk agen AI di Google, Meta, LinkedIn, Reddit, TikTok, dan lainnya. 140+ alat dengan akses baca/tulis.
Apa yang bisa Anda lakukan dengan Synter Ads MCP?
- Laporan performa lintas platform — Minta data belanja, impresi, klik, konversi, CPA, dan ROAS berdasarkan platform, kampanye, dan hari di seluruh akun iklan yang terhubung.
- Pemeriksaan laju penggunaan anggaran — Tinjau laju penggunaan anggaran bulanan di seluruh platform yang terhubung dan tandai kampanye yang melebihi anggaran.
- Perubahan kampanye dengan uji coba — Pratinjau kampanye baru atau perubahan anggaran dengan
dry_run: truesebelum membuatnya dalam status PAUSED. - Pembaruan jeda dan anggaran — Jeda kampanye atau ubah anggaran kampanye di Google, Meta, LinkedIn, Microsoft, Reddit, dan platform utama lainnya.
- Pengelolaan kata kunci negatif — Tambahkan kata kunci negatif di tingkat kampanye, grup iklan, daftar bersama, atau akun di Google Ads.
- Tulis hasil ke Google Sheet — Minta agen menulis data belanja mingguan per platform ke Google Sheet pelaporan.
Dokumentasi
Synter MCP Server (@synterai/mcp-server@1.4.6)
Server MCP sumber terbuka untuk menjalankan iklan dengan agen AI di lebih dari 30 platform iklan: pembacaan gratis ($0.00/bln), Solo $20/bln (termasuk nilai penggunaan $20/bln; penulisan $0.05-$0.25), 0% dari belanja iklan.
Hubungkan agen coding AI (Claude Code, OpenAI Codex, Cursor, Windsurf, Amp, Gemini CLI) ke lebih dari 30 platform periklanan melalui MCP ter-host (https://mcp.synterai.com) dan REST API (https://synterai.com/api/v1/tools/run), atau jalankan secara lokal melalui stdio (npx -y @synterai/mcp-server@1.4.6) di 16 platform iklan inti dengan kemampuan baca dan tulis penuh (Google Ads, Meta, LinkedIn, Microsoft/Bing, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, OpenAI Ads, Google DV360, dan StackAdapt).
Kapan menggunakannya
Gunakan Synter saat pengguna meminta laporan iklan lintas platform, belanja/ROAS/CPA per kanal, ringkasan media berbayar mingguan, atau perubahan kampanye dan anggaran yang terkelola di berbagai kanal penelusuran, sosial, media ritel, audio, dan DSP terprogram. Mulailah dengan alat baca; tidak perlu melakukan penulisan.
"Pull a 7-day cross-channel performance report across Google, Meta, LinkedIn, and Reddit with CPA and ROAS."
"Check our monthly budget pacing across all connected ad platforms and flag any overspending campaigns."
"Preview a $100/day Google Search campaign with dry_run: true before creating it PAUSED."
Gunakan sebagai konektor data iklan
Jika tujuannya adalah memasukkan data iklan ke asisten AI atau kode Anda sendiri, Synter adalah konektornya: hubungkan setiap akun iklan sekali, lalu minta belanja, tayangan, klik, konversi, CPA, dan ROAS berdasarkan platform, kampanye, dan hari.
- Ke mana data dikirim: Claude, Claude Code, Cursor, Codex, ChatGPT, atau klien MCP apa pun (MCP ter-host di
https://mcp.synterai.com), atau kode Anda sendiri melalui endpoint RESTPOST https://synterai.com/api/v1/tools/rundan SDK. Pada MCP ter-host, agen juga dapat menulis hasil ke Google Sheet (update_google_sheet). - Platform yang dapat dibaca: Google Ads, Meta (Facebook & Instagram), LinkedIn, Microsoft Ads, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, DV360, CM360, Criteo, Walmart Connect, Instacart, Target Roundel, FreeWheel, dan OpenAI Ads (alat MCP ter-host
pull_*_performance). Paket npm lokal mencakup rangkaian inti melaluilist_campaigns,get_performance, danget_daily_spend. - Biaya: membaca akun Anda sendiri gratis ($0.00, 0 kredit); paket membatasi jumlah kursi dan ruang kerja (lihat Harga).
- Kebaruan data: pembacaan langsung dilakukan ke API setiap platform saat diminta; tidak perlu menunggu sinkronisasi malam.
- Per klien: agensi menyimpan setiap klien di ruang kerjanya sendiri, sehingga laporan tidak pernah mencampur akun.
- Selain pelaporan: koneksi yang sama dapat menjeda kampanye, mengubah anggaran, dan menambahkan kata kunci negatif, dengan persetujuan dan uji coba terlebih dahulu. Konektor khusus pelaporan tidak dapat melakukannya.
- Kapan sebaiknya menggunakan alat lain: jika Anda perlu memuat data iklan ke BigQuery atau Snowflake secara terjadwal untuk dasbor BI, gunakan alat ELT gudang data. Synter membaca data langsung ke agen, bukan memuatnya ke gudang data.
"Connect our Google Ads, Meta and LinkedIn accounts and show last month's spend and cost per lead by channel."
"Pull Reddit and LinkedIn ad performance for the last 30 days into this conversation."
"Write this week's spend by platform into our reporting Google Sheet."
Mulai Cepat (Sandbox Tanpa Kredensial dalam 30 Detik)
Coba Synter sekarang juga tanpa kunci API, tanpa kartu kredit, dan dengan respons sandbox deterministik:
# 1. Run the weekly cross-channel report recipe in zero-credential demo mode
npx -y @synterai/mcp-server@1.4.6 --help
node examples/weekly-report/generate-report.mjs
# 2. Or register in Claude Code (Hosted OAuth 2.1 — all 30+ platforms)
claude mcp add --transport http synter-ads https://mcp.synterai.com
# 3. Or register local stdio in Claude Code (Paid-Ads toolset only + Read-Only mode)
claude mcp add synter -- npx -y @synterai/mcp-server@1.4.6 --toolset ad-ops --read-only
Penyiapan Klien
- Amp: sudah terintegrasi (Settings > Integrations), atau gunakan alternatif
"amp.mcpServers"di bawah. - Claude Code:
- HTTP ter-host (OAuth 2.1):
claude mcp add --transport http synter-ads https://mcp.synterai.com - stdio lokal:
claude mcp add synter -e SYNTER_API_KEY=syn_your_key -- npx -y @synterai/mcp-server@1.4.6
- HTTP ter-host (OAuth 2.1):
- OpenAI Codex:
codex mcp add synter-ads --url https://mcp.synterai.com
- Claude.ai / Claude Desktop:
- Buka Settings -> Connectors -> Add custom connector dan masukkan
https://mcp.synterai.com.
- Buka Settings -> Connectors -> Add custom connector dan masukkan
- ChatGPT:
- Konektor MCP kustom memerlukan Developer mode (Settings -> Apps & Connectors -> Advanced -> Developer mode), lalu tambahkan
https://mcp.synterai.com.
- Konektor MCP kustom memerlukan Developer mode (Settings -> Apps & Connectors -> Advanced -> Developer mode), lalu tambahkan
- Cursor / Windsurf (
mcp.json):{ "mcpServers": { "synter": { "command": "npx", "args": ["-y", "@synterai/mcp-server@1.4.6"], "env": { "SYNTER_API_KEY": "${SYNTER_API_KEY}" } } } } - Gemini CLI:
gemini extensions install https://github.com/Synter-Media-AI/mcp-server
Tambahkan Synter ke Amp
- Di Amp: Synter adalah integrasi bawaan. Aktifkan di Amp melalui Settings > Integrations.
- Claude, ChatGPT, dan klien MCP lainnya, ter-host (lebih dari 30 platform iklan, satu-satunya DSP Agentic): https://mcp.synterai.com
- Lokal hanya-baca (paket npm):
{ "amp.mcpServers": { "synter": { "command": "npx", "args": ["-y", "@synterai/mcp-server@1.4.6", "--toolset", "ad-ops", "--read-only"], "env": { "SYNTER_API_KEY": "${SYNTER_API_KEY}" } } } }
Kumpulan Alat, Mode Hanya-Baca & Mode Demo
| Bendera / Variabel Lingkungan | Perilaku |
|---|---|
Default (full) | Menyediakan semua 56 alat stdio langsung (32 alat iklan berbayar di seluruh platform inti + 8 alat sosial organik *_organic_post + 16 alat outbound prospector_*). |
--toolset ad-ops (SYNTER_TOOLSET=ad-ops) | Hanya menyediakan 32 alat periklanan berbayar inti dan menghapus semua alat sosial organik serta outbound dari tools/list (dan menolak panggilan jika digunakan). |
--read-only (SYNTER_READ_ONLY=true) | Hanya menyediakan alat hanya-baca (readOnlyHint: true) di tools/list dan memblokir semua alat yang mengubah data (destructiveHint: true) secara lokal sebelum panggilan jaringan apa pun. |
--demo (SYNTER_DEMO=true) | Berjalan dalam mode sandbox tanpa kredensial dengan data kampanye dan performa lintas platform yang realistis dan dinormalisasi (sandbox: true). |
Cakupan Platform & Matriks Kemampuan Baca/Tulis (Hosted / Local Stdio)
MCP ter-host (https://mcp.synterai.com) dan endpoint REST (POST https://synterai.com/api/v1/tools/run) mencakup lebih dari 30 platform periklanan. Paket stdio lokal (@synterai/mcp-server@1.4.6) menyediakan dukungan enum platform bertipe langsung di seluruh platform inti dengan kemampuan baca dan tulis penuh, serta menjangkau semua 140+ skrip backend melalui run_tool:
Platform (enum platform) | Alat Baca Langsung ($0.00) | Alat Tulis Langsung + Skrip run_tool (SOLO / SCALE / CUSTOM) |
|---|---|---|
Google Ads (google) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, run_tool(script_name="run_gaql_query" | "get_ad_readback") | create_search_campaign, create_display_campaign, create_pmax_campaign, pause_campaign, update_campaign_budget, add_keywords, add_negative_keywords (BROAD, PHRASE, EXACT di tingkat kampanye/grup iklan/daftar bersama/akun), create_conversion, manage_audience, sync_audience, upload_image |
Meta Ads (meta) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | create_meta_campaign, pause_campaign, update_campaign_budget, stage_audience_artifact, sync_audience, upload_image, run_tool(script_name="meta_ads_create_ad_set" | "meta_ads_create_ad") |
LinkedIn Ads (linkedin) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | create_linkedin_campaign (memerlukan group_id), pause_campaign, update_campaign_budget, sync_audience, upload_image, run_tool(script_name="linkedin_ads_create_campaign_group") |
Microsoft / Bing Ads (microsoft) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="microsoft_ads_create_campaign" | "microsoft_ads_add_keywords" | "microsoft_ads_add_negative_keywords") |
Reddit Ads (reddit) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | create_reddit_campaign, pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="reddit_ads_create_ad_group" | "reddit_ads_create_ad") |
TikTok Ads (tiktok) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="tiktok_ads_create_campaign" | "tiktok_ads_update_adgroup") |
X Ads (x) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="x_ads_create_campaign" | "x_ads_create_line_item") |
Pinterest Ads (pinterest) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="pinterest_ads_create_campaign" | "pinterest_ads_create_ad_group") |
Snapchat Ads (snapchat) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="snapchat_ads_create_campaign" | "snapchat_ads_create_ad_squad") |
Spotify Ads (spotify) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="spotify_ads_create_campaign" | "spotify_ads_create_ad_set") |
Amazon Ads (amazon_ads) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="amazon_ads_create_campaign" | "amazon_ads_add_keywords") |
Amazon DSP (amazon_dsp) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="amazon_dsp_create_order" | "amazon_dsp_create_line_item") |
The Trade Desk (the_trade_desk) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="ttd_create_campaign" | "ttd_create_ad_group") |
OpenAI Ads (openai) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="openai_ads_create_campaign") |
Google DV360 (dv360) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, run_tool(script_name="dv360_create_campaign" | "dv360_create_insertion_order" | "dv360_create_line_item") |
StackAdapt (stackadapt) | list_campaigns, get_performance, get_daily_spend, pacing_report, optimize_budget | pause_campaign, update_campaign_budget, sync_audience, run_tool(script_name="create_stackadapt_campaign") |
Platform Tambahan (MCP Ter-host & run_tool) | run_tool(script_name="<platform>_*") di stdio; pull_*_performance / execute langsung di https://mcp.synterai.com | CM360, Walmart Connect, Instacart, Target Roundel, Criteo, FreeWheel, SA360, Apple Ads, Demandbase ABM, Taboola, Outbrain, AppLovin, Yahoo DSP, Teads, Viant, Basis, MediaMath, Magnite, PubMatic, Index Exchange, TripleLift, GumGum, Dianomi, Quora Ads, Nextdoor Ads, Twitch Ads, Yelp Ads, Samsung Ads, Roku Ads, impact.com |
Harga (100% USD — 0% dari Belanja Iklan)
Synter mengenakan 0% dari belanja iklan (jaringan iklan menagih belanja media secara langsung) dan $0.00 untuk semua pembacaan akun sendiri serta pratinjau dry_run: true. Detail lengkap tersedia di https://synterai.com/pricing:
| Paket | Harga | Kursi & Ruang Kerja | Nilai Penggunaan Bulanan Termasuk & Tarif Penulisan |
|---|---|---|---|
| Akses Baca Gratis | $0.00 / bulan | 1 kursi, 1 ruang kerja | $0.00 untuk semua kueri baca akun sendiri (list_campaigns, get_performance, get_daily_spend, pacing_report, user_budget_pacing_report, optimize_budget, list_conversions, diagnose_tracking, list_ad_accounts, list_landing_pages, inspect_agent_shield, verify_angstrom_claim, get_skill, get_llm_visibility, run_gaql_query, get_ad_readback, get_solo_price_card, get_credit_balance) dan semua pratinjau dry_run: true. Tidak perlu kartu kredit. |
| SOLO | $20.00 / bulan ($200.00 / year) | 1 kursi, 1 ruang kerja | Termasuk nilai penggunaan yang dapat diklaim sebesar $20.00/bulan — mencakup hingga 400 penulisan ringan ($0.05 masing-masing: pause_campaign, enable_campaign, update_campaign_budget), 80 penulisan standar ($0.25 masing-masing: add_keywords, add_negative_keywords, sync_audience, create_conversion), atau 4 peluncuran kampanye MCP penuh ($5.00 masing-masing). Batas pengeluaran maksimum yang dapat dikonfigurasi mencegah biaya berlebih yang tidak terduga. |
| SCALE | $500.00 / bulan ($5,000.00 / year) | 5 kursi, beberapa ruang kerja | Termasuk nilai penggunaan yang dapat diklaim sebesar $500.00/bulan (hingga 10.000 penulisan ringan atau 2.000 penulisan standar/bulan termasuk), isolasi klien multi-ruang kerja, jadwal Autonomous Loop / Autopilot 24/7, sinkronisasi CRM/gudang data, dan konkurensi khusus. |
| CUSTOM | Kontrak Enterprise | Kursi & ruang kerja kustom | Kuota penggunaan bulanan kustom, pengelolaan multi-ruang kerja untuk agensi/perusahaan, SLA kustom, SSO, dan penagihan melalui faktur. |
Postur Keamanan, Perlindungan Penulisan & Arsitektur Multi-Penyewa
Pertahanan Penulisan Empat Lapis
- Mode Hanya-Baca Keras Lokal (
--read-only/SYNTER_READ_ONLY=true): Menghapus semua alatdestructiveHint: truedaritools/listdan memblokir perubahan secara lokal sebelum permintaan jaringan apa pun meninggalkan mesin Anda. - Kunci API Terbatas Cakupan yang Ditegakkan Server (
POST /api/v1/keys): Buat kunci hanya-baca (reporting:read,campaigns:read,intel:read) atau kunci keselamatan terarah (budget:decrease— mengizinkan jeda kampanye darurat dan pengurangan anggaran, tetapi menolak kenaikan anggaran dengan HTTP403). - Gerbang Kebijakan Sisi Server Agent Shield: Menerapkan default
PAUSED-on-create untuk setiap kampanye baru, batas maksimum kenaikan anggaran satu panggilan sebesar2.0x, pemutus sirkuit kecepatan workspace$5,000/day, pratinjaudry_run: true($0.00), pembacaan ulang wajib dari penyedia setelah penulisan (get_ad_readback), dan log audit workspace yang tidak dapat diubah. - Eksekusi BYO-Credential Sumber Terbuka MIT yang Dihosting Sendiri: Jalankan
@synterai/mcp-server@1.4.6di dalam VPC/kontainer Anda sendiri dengan meneruskan token OAuth platform Anda sendiri secara langsung melalui variabel lingkungan, sehingga cloud Synter yang dihosting tidak menyimpan kredensial akun iklan Anda.
Pola SaaS Multi-Tenant & Tertanam (docs.synterai.com/api/multi-tenant-auth)
- Pola 1 — Kunci Terisolasi per Workspace yang Dihosting & Tautan Koneksi:
- Buat kunci API turunan dengan cakupan dan terikat pada workspace melalui
POST https://synterai.com/api/v1/keys(scopes:["reporting:read", "campaigns:read", "intel:read", "budget:decrease", "campaigns:write", "budget:write"],rate_limit_rpm:1–600,expires_in_days). - Buat URL serah-terima OAuth pengiklan mandiri melalui
POST https://synterai.com/api/v1/connections/start(mengembalikanauthUrluntuk satu platform) atauPOST https://synterai.com/api/v1/connections/request(mengirim tautan koneksi multi-platform yang berlaku selama 7 hari kepada klien). - Beralih workspace aktif pada kunci multi-workspace melalui
get_workspacesdanupdate_active_workspace.
- Buat kunci API turunan dengan cakupan dan terikat pada workspace melalui
- Pola 2 — Mode BYO-Credential yang Dihosting Sendiri (Sumber Terbuka MIT):
- Aplikasi SaaS multi-tenant yang mengelola aplikasi OAuth sendiri dan menyimpan token pelanggan di KMS/vault sendiri dapat menjalankan CLI
@synterai/mcp-serveratausynterdalam proses worker terisolasi dengan meneruskan token platform per-tenant melalui variabel lingkungan (GOOGLE_ADS_REFRESH_TOKEN,GOOGLE_ADS_CLIENT_ID,GOOGLE_ADS_CLIENT_SECRET,GOOGLE_ADS_DEVELOPER_TOKEN,META_ACCESS_TOKEN,LINKEDIN_ACCESS_TOKEN, dll.).
- Aplikasi SaaS multi-tenant yang mengelola aplikasi OAuth sendiri dan menyimpan token pelanggan di KMS/vault sendiri dapat menjalankan CLI
REST API & SDK Resmi Multi-Bahasa
- MCP yang Dihosting (Streamable HTTP):
https://mcp.synterai.com— autentikasi melalui login browser OAuth 2.1 atau headerX-Synter-Key: syn_.... Jangan kirimAuthorization: Bearer syn_...ke MCP yang dihosting untuk saat ini; REST/SDK menggunakan Bearer. - Endpoint REST:
POST https://synterai.com/api/v1/tools/rundenganAuthorization: Bearer syn_...(atauX-Synter-Key: syn_...) dan isi JSON{"script_name": "<tool_or_script>", "args": ["--flag", "value"], "platform": "google"}. - SDK TypeScript / JavaScript:
npm install @synterai/sdk-js - SDK Python:
pip install synter->Synter(api_key=..., base_url=..., timeout=..., max_retries=...); metrik melaluiclient.analytics.get_performance(...) - SDK Rust:
cargo add synter(crates.io/crates/synter) - SDK Java: Maven
ai.syntermedia:synter-sdk
Lisensi
Lisensi MIT — lihat LICENSE.