Synter Ads

officiel

Gestion 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: true avant 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.

npm version License: MIT Add Synter to Amp

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 REST POST https://synterai.com/api/v1/tools/run et 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 via list_campaigns, get_performance et get_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
  • 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.
  • ChatGPT :
    • Les connecteurs MCP personnalisés nécessitent le mode développeur (Settings -> Apps & Connectors -> Advanced -> Developer mode). Ajoutez ensuite https://mcp.synterai.com.
  • 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

  1. Dans Amp : Synter est une intégration intégrée. Activez-la dans Amp sous Settings > Integrations.
  2. Claude, ChatGPT et autres clients MCP, hébergés (plus de 30 plateformes publicitaires, le seul DSP agentique) : https://mcp.synterai.com
  3. 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’environnementComportement
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_budgetcreate_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_budgetcreate_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_budgetpause_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_budgetcreate_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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_budgetpause_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.comCM360, 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 :

OffrePrixSièges et espaces de travailValeur d’utilisation mensuelle incluse et tarifs des écritures
Accès gratuit en lecture0,00 $ / mois1 siège, 1 espace de travail0,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.
SOLO20,00 $ / mois ($200.00 / year)1 siège, 1 espace de travailInclut 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.
SCALE500,00 $ / mois ($5,000.00 / year)5 sièges, plusieurs espaces de travailInclut 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.
CUSTOMContrat entrepriseNombre personnalisé de sièges et d’espaces de travailAllocation 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

  1. Mode local strictement en lecture seule (--read-only / SYNTER_READ_ONLY=true) : supprime tous les outils destructiveHint: true de tools/list et bloque localement les modifications avant qu’une requête réseau puisse quitter votre machine.
  2. 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 HTTP 403).
  3. Barrière de politique côté serveur Agent Shield : impose PAUSED-on-create par défaut pour chaque nouvelle campagne, un plafond maximal de 2.0x pour les augmentations de budget en un seul appel, un disjoncteur de vélocité de l’espace de travail de $5,000/day, des aperçus dry_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.
  4. Exécution auto-hébergée MIT Open Source avec vos propres identifiants : exécutez @synterai/mcp-server@1.4.6 dans 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)

  1. 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 un authUrl pour une seule plateforme) ou POST 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_workspaces et update_active_workspace.
  2. 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-server ou synter dans 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.).

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ête X-Synter-Key: syn_.... N’envoyez pas encore Authorization: Bearer syn_... au MCP hébergé ; REST/SDK utilisent Bearer.
  • Point de terminaison REST : POST https://synterai.com/api/v1/tools/run avec Authorization: Bearer syn_... (ou X-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 via client.analytics.get_performance(...)
  • SDK Rust : cargo add synter (crates.io/crates/synter)
  • SDK Java : Maven ai.syntermedia:synter-sdk

Licence

Licence MIT — voir LICENSE.