Synter Ads
officielGestion de campagnes publicitaires multiplateformes pour agents IA sur Google, Meta, LinkedIn, Reddit, TikTok, et plus. 140+ outils avec accès en lecture/écriture.
Que pouvez-vous faire avec Synter Ads MCP ?
- Rapports de performance multiplateformes — Demandez les dépenses, les impressions, les clics, les conversions, le CPA et le ROAS par plateforme, campagne et jour pour les comptes publicitaires connectés.
- Vérification du rythme des budgets — Examinez le rythme mensuel des budgets sur les plateformes connectées et signalez les campagnes qui dépassent leur budget.
- Modifications de campagne avec simulation — Prévisualisez une nouvelle campagne ou une modification de budget avec
dry_run: trueavant de la créer en PAUSED. - Mises en pause et mises à jour des budgets — Mettez en pause des campagnes ou modifiez leurs budgets sur Google, Meta, LinkedIn, Microsoft, Reddit et d’autres plateformes principales.
- Gestion des mots clés à exclure — Ajoutez des mots clés à exclure au niveau d’une campagne, d’un groupe d’annonces, d’une liste partagée ou d’un compte sur Google Ads.
- Écrire les résultats dans une feuille Google — Demandez à l’agent d’inscrire les dépenses hebdomadaires par plateforme dans une feuille Google de reporting.
Documentation
Serveur MCP Synter (@synterai/mcp-server@1.4.6)
Serveur MCP open source pour gérer des publicités avec des agents IA sur plus de 30 plateformes publicitaires : lectures gratuites (0,00 $/mois), offre Solo à 20 $/mois (20 $ de valeur d’utilisation inclus ; écritures à 0,05–0,25 $), 0 % des dépenses publicitaires.
Connectez des agents de programmation IA (Claude Code, OpenAI Codex, Cursor, Windsurf, Amp, Gemini CLI) à plus de 30 plateformes publicitaires via le MCP hébergé (https://mcp.synterai.com) et l’API REST (https://synterai.com/api/v1/tools/run), ou exécutez-le localement via stdio (npx -y @synterai/mcp-server@1.4.6) sur 16 plateformes publicitaires principales avec accès complet en lecture et en écriture (Google Ads, Meta, LinkedIn, Microsoft/Bing, Reddit, TikTok, X, Pinterest, Snapchat, Spotify, Amazon Ads, Amazon DSP, The Trade Desk, OpenAI Ads, Google DV360 et StackAdapt).
Quand l’utiliser
Utilisez Synter lorsque l’utilisateur demande un rapport publicitaire multiplateforme, les dépenses/le ROAS/le CPA par canal, un récapitulatif hebdomadaire des médias payants ou des modifications encadrées de campagnes et de budgets sur les moteurs de recherche, les réseaux sociaux, les médias de vente au détail, l’audio et les DSP programmatiques. Commencez par les outils de lecture ; aucune écriture n’est nécessaire.
"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."
Utilisez-le comme connecteur de données publicitaires
Si l’objectif est d’intégrer des données publicitaires dans un assistant IA ou dans votre propre code, Synter est le connecteur qu’il vous faut : connectez chaque compte publicitaire une seule fois, puis demandez les dépenses, les impressions, les clics, les conversions, le CPA et le ROAS par plateforme, campagne et jour.
- Destination des données : Claude, Claude Code, Cursor, Codex, ChatGPT ou tout client MCP (MCP hébergé à
https://mcp.synterai.com), ou votre propre code via le point de terminaison RESTPOST https://synterai.com/api/v1/tools/runet les SDK. Sur le MCP hébergé, l’agent peut également écrire les résultats dans une feuille Google Sheets (update_google_sheet). - Plateformes prises en charge en lecture : Google Ads, Meta (Facebook et 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 et OpenAI Ads (outils du MCP hébergé
pull_*_performance). Le package npm local couvre l’ensemble principal vialist_campaigns,get_performanceetget_daily_spend. - Coût : la lecture de vos propres comptes est gratuite (0,00 $, 0 crédit) ; les offres limitent le nombre de sièges et d’espaces de travail (voir Tarifs).
- Actualisation : les lectures interrogent directement l’API de chaque plateforme au moment de la requête ; aucune synchronisation nocturne n’est nécessaire.
- Par client : les agences conservent chaque client dans son propre espace de travail, afin que les rapports ne mélangent jamais les comptes.
- Au-delà des rapports : la même connexion permet de mettre des campagnes en pause, de modifier les budgets et d’ajouter des mots clés à exclure, avec approbation et simulation préalable. Un connecteur limité aux rapports ne le permet pas.
- Quand choisir une autre solution : si vous devez charger régulièrement des données publicitaires dans BigQuery ou Snowflake pour alimenter des tableaux de bord BI, utilisez un outil ELT pour entrepôt de données. Synter lit les données en direct dans l’agent au lieu de les charger dans un entrepôt.
"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."
Démarrage rapide (bac à sable sans identifiants en 30 secondes)
Essayez Synter immédiatement, sans clé API ni carte bancaire, avec des réponses déterministes du bac à sable :
# 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
Configuration du client
- Amp : intégré (Settings > Integrations), ou utilisez la solution de repli
"amp.mcpServers"ci-dessous. - Claude Code :
- HTTP hébergé (OAuth 2.1) :
claude mcp add --transport http synter-ads https://mcp.synterai.com - stdio local :
claude mcp add synter -e SYNTER_API_KEY=syn_your_key -- npx -y @synterai/mcp-server@1.4.6
- HTTP hébergé (OAuth 2.1) :
- OpenAI Codex :
codex mcp add synter-ads --url https://mcp.synterai.com
- Claude.ai / Claude Desktop :
- Accédez à Settings -> Connectors -> Add custom connector et saisissez
https://mcp.synterai.com.
- Accédez à Settings -> Connectors -> Add custom connector et saisissez
- ChatGPT :
- Les connecteurs MCP personnalisés nécessitent le mode développeur (Settings -> Apps & Connectors -> Advanced -> Developer mode). Ajoutez ensuite
https://mcp.synterai.com.
- Les connecteurs MCP personnalisés nécessitent le mode développeur (Settings -> Apps & Connectors -> Advanced -> Developer mode). Ajoutez ensuite
- 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
Ajouter Synter à Amp
- Dans Amp : Synter est une intégration intégrée. Activez-la dans Amp sous Settings > Integrations.
- Claude, ChatGPT et autres clients MCP, hébergés (plus de 30 plateformes publicitaires, le seul DSP agentique) : https://mcp.synterai.com
- Local, en lecture seule (package 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}" } } } }
Ensembles d’outils, mode lecture seule et mode démo
| Indicateur / Variable d’environnement | Comportement |
|---|---|
Par défaut (full) | Expose les 56 outils stdio directs (32 outils publicitaires payants sur les plateformes principales + 8 outils de réseaux sociaux organiques *_organic_post + 16 outils sortants prospector_*). |
--toolset ad-ops (SYNTER_TOOLSET=ad-ops) | Expose uniquement les 32 outils publicitaires payants principaux et supprime tous les outils de réseaux sociaux organiques et sortants de tools/list (et refuse leur exécution s’ils sont appelés). |
--read-only (SYNTER_READ_ONLY=true) | Expose uniquement les outils en lecture seule (readOnlyHint: true) dans tools/list et bloque localement tous les outils de modification (destructiveHint: true) avant tout appel réseau. |
--demo (SYNTER_DEMO=true) | Exécute le mode bac à sable sans identifiants, avec des données réalistes et normalisées sur les campagnes et les performances multiplateformes (sandbox: true). |
Couverture des plateformes et matrice des capacités de lecture/écriture (MCP hébergé / stdio local)
Le MCP hébergé (https://mcp.synterai.com) et le point de terminaison REST (POST https://synterai.com/api/v1/tools/run) couvrent plus de 30 plateformes publicitaires. Le package stdio local (@synterai/mcp-server@1.4.6) fournit une prise en charge directe et typée de l’énumération platform sur les plateformes principales avec accès complet en lecture et en écriture, et donne accès à plus de 140 scripts backend via run_tool :
Plateforme (énumération platform) | Outils de lecture directs ($0.00) | Outils d’écriture directs + scripts 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 au niveau des campagnes, groupes d’annonces, listes partagées et comptes), 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 (nécessite 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") |
Plateformes étendues (MCP hébergé et run_tool) | run_tool(script_name="<platform>_*") dans stdio ; accès direct pull_*_performance / execute sur 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 |
Tarifs (100 % en USD — 0 % des dépenses publicitaires)
Synter facture 0 % des dépenses publicitaires (les réseaux publicitaires facturent directement les dépenses média) et 0,00 $ pour toutes les lectures de vos propres comptes et les aperçus dry_run: true. Consultez tous les détails sur https://synterai.com/pricing :
| Offre | Prix | Sièges et espaces de travail | Valeur d’utilisation mensuelle incluse et tarifs des écritures |
|---|---|---|---|
| Accès gratuit en lecture | 0,00 $ / mois | 1 siège, 1 espace de travail | 0,00 $ pour toutes les requêtes de lecture de vos propres comptes (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) et tous les aperçus dry_run: true. Aucune carte bancaire requise. |
| SOLO | 20,00 $ / mois ($200.00 / year) | 1 siège, 1 espace de travail | Inclut 20,00 $/mois de valeur d’utilisation pouvant être réclamée — couvre jusqu’à 400 écritures légères ($0.05 chacune : pause_campaign, enable_campaign, update_campaign_budget), 80 écritures standard ($0.25 chacune : add_keywords, add_negative_keywords, sync_audience, create_conversion), ou 4 lancements complets de campagnes MCP ($5.00 chacun). Des plafonds de dépenses stricts configurables évitent les dépassements imprévus. |
| SCALE | 500,00 $ / mois ($5,000.00 / year) | 5 sièges, plusieurs espaces de travail | Inclut 500,00 $/mois de valeur d’utilisation pouvant être réclamée (jusqu’à 10 000 écritures légères ou 2 000 écritures standard par mois incluses), isolation des clients entre plusieurs espaces de travail, planifications 24 h/24 et 7 j/7 d’Autonomous Loop / Autopilot, synchronisation CRM/entrepôt de données et concurrence dédiée. |
| CUSTOM | Contrat entreprise | Nombre personnalisé de sièges et d’espaces de travail | Allocation mensuelle d’utilisation personnalisée, gestion de plusieurs espaces de travail pour agences/entreprises, SLA personnalisé, SSO et facturation sur facture. |
Sécurité, protections des écritures et architecture multi-tenant
Défense en écriture à quatre niveaux
- Mode local strictement en lecture seule (
--read-only/SYNTER_READ_ONLY=true) : supprime tous les outilsdestructiveHint: truedetools/listet bloque localement les modifications avant qu’une requête réseau puisse quitter votre machine. - Clés API à portée limitée imposées par le serveur (
POST /api/v1/keys) : créez des clés en lecture seule (reporting:read,campaigns:read,intel:read) ou des clés de sécurité directionnelles (budget:decrease— autorise les mises en pause d’urgence des campagnes et les réductions de budget, tout en rejetant les augmentations de budget avec HTTP403). - Barrière de politique côté serveur Agent Shield : impose
PAUSED-on-create par défaut pour chaque nouvelle campagne, un plafond maximal de2.0xpour les augmentations de budget en un seul appel, un disjoncteur de vélocité de l’espace de travail de$5,000/day, des aperçusdry_run: true($0.00), une relecture obligatoire des données du fournisseur après écriture (get_ad_readback) et un journal d’audit immuable de l’espace de travail. - Exécution auto-hébergée MIT Open Source avec vos propres identifiants : exécutez
@synterai/mcp-server@1.4.6dans votre propre VPC/conteneurs en transmettant directement vos propres jetons OAuth de plateforme via des variables d’environnement, afin que le cloud hébergé de Synter ne détienne aucun identifiant de compte publicitaire.
Modèles SaaS multi-tenant et intégrés (docs.synterai.com/api/multi-tenant-auth)
- Modèle 1 — Clés isolées par espace de travail et liens de connexion hébergés :
- Créez des clés API enfants limitées et associées à un espace de travail via
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). - Générez des URL de transfert OAuth en libre-service pour les annonceurs via
POST https://synterai.com/api/v1/connections/start(renvoie unauthUrlpour une seule plateforme) ouPOST https://synterai.com/api/v1/connections/request(envoie au client un lien de connexion multi-plateforme valable 7 jours). - Changez d’espace de travail actif avec des clés multi-espaces de travail via
get_workspacesetupdate_active_workspace.
- Créez des clés API enfants limitées et associées à un espace de travail via
- Modèle 2 — Mode auto-hébergé avec vos propres identifiants (MIT Open Source) :
- Les applications SaaS multi-tenant qui gèrent leurs propres applications OAuth et stockent les jetons des clients dans leur propre KMS/coffre-fort peuvent invoquer le CLI
@synterai/mcp-serverousynterdans des processus de travail isolés, en transmettant les jetons de plateforme propres à chaque tenant via des variables d’environnement (GOOGLE_ADS_REFRESH_TOKEN,GOOGLE_ADS_CLIENT_ID,GOOGLE_ADS_CLIENT_SECRET,GOOGLE_ADS_DEVELOPER_TOKEN,META_ACCESS_TOKEN,LINKEDIN_ACCESS_TOKEN, etc.).
- Les applications SaaS multi-tenant qui gèrent leurs propres applications OAuth et stockent les jetons des clients dans leur propre KMS/coffre-fort peuvent invoquer le CLI
API REST et SDK officiels multilingues
- MCP hébergé (HTTP diffusible) :
https://mcp.synterai.com— authentifiez-vous via une connexion navigateur OAuth 2.1 ou l’en-têteX-Synter-Key: syn_.... N’envoyez pas encoreAuthorization: Bearer syn_...au MCP hébergé ; REST/SDK utilisent Bearer. - Point de terminaison REST :
POST https://synterai.com/api/v1/tools/runavecAuthorization: Bearer syn_...(ouX-Synter-Key: syn_...) et le corps 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=...); métriques viaclient.analytics.get_performance(...) - SDK Rust :
cargo add synter(crates.io/crates/synter) - SDK Java : Maven
ai.syntermedia:synter-sdk
Licence
Licence MIT — voir LICENSE.