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 ?

  • List campaigns across platforms — Demandez à votre assistant de récupérer toutes les campagnes des comptes publicitaires connectés avec list_campaigns.
  • Create search campaigns — Utilisez create_search_campaign pour lancer une campagne Google Search avec des mots-clés, des annonces et un budget.
  • Pause underperformers — Arrêtez instantanément toute campagne via pause_campaign lorsque les dépenses ou le ROAS semblent anormaux.
  • Pull performance metrics — Obtenez impressions, clics, dépenses, conversions et ROAS avec get_performance.
  • Generate ad creatives — Faites produire par generate_image ou generate_video des assets publicitaires prêts à être téléversés.
  • Run any of 140+ tools — Accédez directement au catalogue complet de Synter avec run_tool pour des actions avancées.

Documentation

Serveur MCP Synter

npm version License: MIT

Le serveur MCP le plus complet pour la publicité.

Reporting sur 19 plateformes publicitaires et création complète de campagnes sur 14 d'entre elles (actions d'écriture sur 16), couvrant tous les principaux canaux d'achat, avec confirmations intégrées pour les actions destructrices.

Créez des campagnes. Ajustez les budgets. Mettez en pause les campagnes sous-performantes. Générez des créatifs. Récupérez les données de performance. Le tout par conversation naturelle, sur Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, et plus encore.

C'est le premier serveur Model Context Protocol (MCP) qui donne une carte de crédit aux agents IA.

Remarque : Synter-Media-AI/plugin est le dépôt de plugin Claude installable canonique. La copie .claude-plugin/ dans ce dépôt n'est pas la source d'installation.


Comparaison de Synter

Le serveur MCP officiel de Google Ads est en lecture seule par conception : selon la documentation de Google, il est « strictement en lecture seule » et « ne peut pas modifier les enchères, mettre en pause des campagnes ou créer de nouveaux assets ». La plupart des serveurs MCP publicitaires tiers couvrent une seule plateforme. Nous avons construit Synter pour faire les deux moitiés du travail, sur tous les principaux canaux d'achat, à partir d'un seul serveur.

Synter MCPServeur MCP officiel Google AdsServeurs MCP publicitaires tiers typiques
AccèsLecture sur les 19 plateformes, création de campagnes sur 14, actions d'écriture sur 16Lecture seule (version actuelle)Souvent en lecture seule ou écriture partielle
Plateformes19 en reporting, 14 avec création complète de campagnes (listes ci-dessous)Google Ads uniquementGénéralement une seule plateforme
Créer des campagnes✅ Google Search, Display, PMax, Meta, LinkedIn, Reddit, plus via run_tool❌Rarement
Budgets et mise en pause✅❌Variable
Génération créative IA✅ Images, vidéo, textes❌❌
Synchronisation d'audiences✅ Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X❌❌
SécuritéConfirmations pour les actions destructricesn/a (lecture seule)Variable
Open source✅ MIT✅Variable

Couverture du reporting (19 plateformes) : Google Ads, Microsoft Ads (Bing), Meta (Facebook et Instagram), LinkedIn Ads, X (Twitter) Ads, Reddit Ads, TikTok Ads, Snapchat Ads, Pinterest Ads, Spotify Ads, Amazon Ads, Amazon DSP, Walmart Connect, Instacart Ads, Target Roundel, Criteo, The Trade Desk, Display & Video 360, et OpenAI Ads (ChatGPT).

Création complète de campagnes (14 plateformes) : Google Ads, Microsoft Ads, Meta, LinkedIn, X, Reddit, TikTok, Snapchat, Pinterest, Spotify, Amazon Ads (Sponsored Products, Brands et Display), Amazon DSP, The Trade Desk, et OpenAI Ads. Display & Video 360 et StackAdapt prennent également en charge les actions d'écriture (mise en pause, mises à jour de budget et de postes de ligne, téléchargement d'audiences) sans création de campagnes. Les 4 restantes (Walmart Connect, Instacart, Target Roundel et Criteo) sont en reporting uniquement aujourd'hui.

Le package npx fournit des outils typés pour les opérations les plus courantes ainsi qu'un accès run_tool au catalogue complet des 140+ outils Synter. Le serveur distant à https://mcp.syntermedia.ai/mcp/ expose l'ensemble complet des outils hébergés, y compris les extractions de performance pour chaque plateforme ci-dessus.

Pour la découverte MCP de type registre, server.json est la source de vérité lisible par machine. Gardez-le aligné avec package.json, manifest.json et les exemples de configuration de ce README.


⚠️ Avertissement équitable

Votre agent IA sera capable de :

  • Créer des campagnes qui commencent immédiatement à dépenser votre budget
  • Ajuster les enchères qui affectent combien vous payez par clic
  • Mettre en pause des campagnes (parfois c'est une bonne chose)
  • Ajouter des mots-clés qui changent qui voit vos annonces
  • Générer des créatifs et les télécharger sur vos comptes

Nous avons intégré des confirmations pour les actions destructrices. Mais quand même, ne donnez peut-être pas cela à un agent que vous venez de rencontrer.


Démarrage rapide

1. Obtenez votre clé API

Inscrivez-vous sur syntermedia.ai et créez une clé API dans les Paramètres développeur.

2. Configurez votre client IA

Pour Claude Desktop : Ajoutez à ~/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"
      }
    }
  }
}

Pour Cursor : Ajoutez à .cursor/mcp.json dans votre projet :

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Pour Amp : Ajoutez à .amp/settings.json :

{
  "mcpServers": {
    "synter": {
      "command": "npx",
      "args": ["@synterai/mcp-server"],
      "env": {
        "SYNTER_API_KEY": "syn_your_api_key_here"
      }
    }
  }
}

Distant (HTTP streamable) : Pour ChatGPT, n8n, Zapier, ou tout client MCP prenant en charge le transport HTTP :

URL: https://mcp.syntermedia.ai/mcp/
Header: X-Synter-Key: syn_your_api_key_here

Aucune installation locale nécessaire. Fonctionne avec tout client MCP prenant en charge le transport HTTP streamable.

3. Commencez à l'utiliser

Redémarrez votre client IA et commencez à discuter :

« Montre-moi toutes mes campagnes Google Ads »

« Crée une campagne de recherche pour "logiciel de gestion de projet" avec un budget de 50 $/jour »

« Mets en pause la campagne qui dépense trop »


Vous préférez un plugin complet ? (Claude Code / Claude Desktop)

Ce package est le serveur MCP brut. Si vous utilisez Claude Code ou Claude Desktop, le plugin Synter encapsule ce même serveur avec des compétences prêtes à l'emploi (/synter:launch, /synter:audience, /synter:optimize, …), des agents spécialisés et un hook de sécurité d'approbation avant dépense :

/plugin marketplace add Synter-Media-AI/plugin
/plugin install synter@synter

Il fournit également un exécuteur Claude Agent SDK sans interface pour l'automatisation. Voir le dépôt du plugin ou le guide des plugins Claude. Utilisez ce package MCP directement lorsque vous voulez juste les outils, ou que vous connectez un autre client.


Que peut faire votre agent ?

📊 Gestion des campagnes

OutilDescription
list_campaignsLister les campagnes sur toutes les plateformes connectées
create_search_campaignCréer une campagne Google Search avec mots-clés et annonces
create_display_campaignCréer une campagne Google Display avec images
create_pmax_campaignCréer une campagne Performance Max
create_meta_campaignCréer une campagne Facebook/Instagram
create_linkedin_campaignCréer une campagne LinkedIn pour le B2B
create_reddit_campaignCréer une campagne Reddit
pause_campaignMettre en pause n'importe quelle campagne
update_campaign_budgetModifier le budget quotidien

📈 Performance et analytique

OutilDescription
get_performanceObtenir impressions, clics, dépenses, conversions, ROAS
get_daily_spendRépartition des dépenses quotidiennes par plateforme

🎯 Mots-clés et ciblage

OutilDescription
add_keywordsAjouter des mots-clés à une campagne ou un groupe d'annonces
add_negative_keywordsBloquer les termes de recherche indésirables

🔄 Suivi des conversions

OutilDescription
create_conversionConfigurer une action de conversion
list_conversionsLister les actions de conversion existantes
diagnose_trackingVérifier si le suivi est correctement installé

🎨 Génération créative

OutilDescription
generate_imageGénérer par IA des images publicitaires
generate_videoGénérer par IA des annonces vidéo
upload_imageTélécharger des images comme assets publicitaires

🔧 Utilitaire

OutilDescription
list_ad_accountsLister tous les comptes publicitaires connectés
run_toolExécuter directement n'importe lequel des 140+ outils Synter

Pas d'expérience publicitaire ? Pas de problème.

Si vous n'avez jamais fait de publicité auparavant, voici ce que vous devez savoir :

Qu'est-ce qu'une campagne ?

Une campagne est comme un dossier de projet. Elle contient vos annonces, qui les voit et combien vous dépensez.

Campaign: "Q1 Lead Generation"
├── Budget: $50/day
├── Targeting: USA, people searching "project management"
└── Ads: Headlines, descriptions, images

Quelles plateformes puis-je utiliser ?

PlateformeIdéale pourBudget minimum
Google AdsLes personnes recherchant activement votre produit10 $/jour
Meta (Facebook/Instagram)Produits visuels, audiences larges5 $/jour
LinkedInB2B, entreprises, chercheurs d'emploi25 $/jour
RedditCommunautés de niche, utilisateurs férus de technologie5 $/jour
Microsoft (Bing)Données démographiques plus âgées, B2B10 $/jour
TikTokGénération Z, divertissement, e-commerce20 $/jour

Types de campagnes expliqués

Campagnes de recherche : Votre annonce s'affiche lorsque quelqu'un recherche des mots-clés spécifiques sur Google.

  • Exemple : Quelqu'un recherche « meilleur logiciel CRM » → Votre annonce apparaît

Campagnes Display : Annonces image affichées sur des sites web et des applications.

  • Exemple : Bannière publicitaire sur un site d'actualités

Performance Max (PMax) : L'IA de Google affiche vos annonces partout (Search, YouTube, Display, Gmail, Maps).

  • Exemple : Google détermine les meilleurs emplacements pour vous

Campagnes vidéo : Annonces vidéo sur YouTube et les sites partenaires.

  • Exemple : Annonce de 15 secondes avant une vidéo YouTube

Termes courants

TermeCe que cela signifie
ImpressionsCombien de fois votre annonce a été affichée
ClicsCombien de personnes ont cliqué sur votre annonce
CTRTaux de clics (clics ÷ impressions × 100)
CPCCoût par clic
ConversionsActions souhaitées (inscriptions, achats, etc.)
ROASRetour sur dépenses publicitaires (revenus ÷ dépenses)

Liste de contrôle pour la première campagne

Avant de créer votre première campagne, vous aurez besoin de :

  1. ✅ Une URL de page de destination où les gens iront lorsqu'ils cliqueront
  2. ✅ Une idée de qui vous voulez atteindre (emplacement, centres d'intérêt)
  3. ✅ Un budget quotidien avec lequel vous êtes à l'aise (10-50 $ pour commencer)
  4. ✅ Quelques titres et descriptions pour votre annonce

Conseil de pro : Commencez par une campagne de recherche sur Google. C'est la plus facile à comprendre et elle montre des annonces aux personnes qui cherchent déjà ce que vous proposez.


Exemples de conversations

Créez votre première campagne

Vous : Créez une campagne Google Search pour mon produit SaaS. Ciblez les personnes recherchant « logiciel de collaboration d'équipe » et « outils de gestion de projet ». Le budget est de 25 $/jour. La page de destination est https://myapp.com/signup

Agent : Je vais créer une campagne de recherche avec ces mots-clés. Quels titres dois-je utiliser ? Voici quelques suggestions :

  • « Collaboration d'équipe simplifiée »
  • « Gestion de projet pour les équipes modernes »
  • « Commencez gratuitement - Aucune carte de crédit »

Vérifiez les performances

Vous : Comment vont mes campagnes cette semaine ?

Agent : Voici vos performances pour les 7 derniers jours :

CampagneDépensesClicsConversionsROAS
Recherche de marque142 $89124,2x
Mots-clés concurrents98 $4531,5x
Reciblage Display67 $23482,8x

La campagne « Mots-clés concurrents » est sous-performante. Voulez-vous que je la mette en pause ou que j'ajuste le ciblage ?

Ajoutez des mots-clés négatifs

Vous : Je reçois des clics pour « gestion de projet gratuite » mais nous n'avons pas d'offre gratuite. Bloquez cela.

Agent : J'ai ajouté « gratuit » comme mot-clé négatif à votre campagne. Cela empêchera vos annonces de s'afficher pour toute recherche contenant « gratuit ».

Générez un créatif publicitaire

Vous : J'ai besoin d'une image publicitaire Display pour un produit d'automatisation marketing. Thème sombre, professionnel, 1200x628.

Agent : Génération de votre image...

Créé : « Tableau de bord d'automatisation marketing avec visualisation de données sur fond sombre » Asset enregistré et prêt à être utilisé dans votre prochaine campagne Display.


Connectez vos comptes publicitaires

Pour gérer les annonces sur chaque plateforme, vous devrez connecter vos comptes dans Synter :

  1. Allez sur syntermedia.ai/settings/credentials
  2. Cliquez sur « Connecter » à côté de chaque plateforme
  3. Terminez le flux OAuth
  4. Votre agent peut désormais gérer cette plateforme

Plateformes prises en charge (19 ; ✅ = reporting + exécution complète de campagnes, 📊 = reporting) :

  • Google Ads ✅
  • Meta (Facebook/Instagram) ✅
  • LinkedIn Ads ✅
  • Microsoft Ads (Bing) ✅
  • Reddit Ads ✅
  • TikTok Ads ✅
  • X (Twitter) Ads ✅
  • Snapchat Ads ✅
  • Pinterest Ads ✅
  • Spotify Ads ✅
  • Amazon DSP ✅
  • The Trade Desk ✅
  • Amazon Ads 📊
  • Walmart Connect 📊
  • Instacart Ads 📊
  • Target Roundel 📊
  • Criteo 📊
  • Display & Video 360 📊
  • OpenAI Ads (ChatGPT) 📊

Avancé : accès direct aux outils

Pour les utilisateurs avancés, vous pouvez appeler directement n'importe lequel des 140+ outils Synter :

> Use run_tool to call google_ads_list_audiences

Voir la liste complète des outils sur docs.syntermedia.ai/tools ou demandez à votre agent :

> What tools are available for LinkedIn Ads?

Sûr par défaut : execute exécutions à blanc sauf indication contraire

L'outil universel execute n'exécute jamais une action lors du premier appel, sauf si vous y consentez explicitement. Par défaut (dry_run: true), il valide la requête et s'arrête là — rien ne s'exécute, rien ne dépense. Passez dry_run: false pour réellement exécuter l'action ; pour tout ce qui implique une dépense, faites-le uniquement avec l'approbation du propriétaire du compte.


Variables d'environnement

VariableRequiseDescription
SYNTER_API_KEYOuiVotre clé API Synter
SYNTER_API_URLNonRemplacement de l'URL de l'API (par défaut : https://syntermedia.ai)

Développement local

# 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

Dépannage

« SYNTER_API_KEY non définie »

Assurez-vous que votre clé API se trouve dans la section env de votre configuration MCP. La clé doit commencer par syn_.

« Clé API invalide ou expirée »

  1. Vérifiez que vous avez copié la clé complète (elles sont longues !)
  2. Vérifiez que la clé est active sur syntermedia.ai/developer
  3. Assurez-vous que la clé dispose du champ d'application tools:write

« Aucun compte publicitaire connecté »

Vous devez connecter au moins une plateforme publicitaire :

  1. Allez sur syntermedia.ai/settings/credentials
  2. Cliquez sur « Connecter » à côté de Google Ads (ou d'une autre plateforme)
  3. Terminez l'autorisation OAuth

Les outils ne s'affichent pas dans Claude/Cursor

  1. Redémarrez complètement votre client IA (pas seulement un rafraîchissement)
  2. Consultez les journaux du serveur MCP pour détecter les erreurs
  3. Vérifiez le chemin du fichier de configuration et la syntaxe JSON

FAQ

Existe-t-il un serveur MCP pour Google Ads ?

Oui, deux types. Google fournit un serveur MCP Google Ads officiel, qui est en lecture seule dans sa version actuelle : il peut interroger les rapports, les métriques et les métadonnées, mais selon la documentation de Google, il « ne peut pas modifier les enchères, mettre en pause les campagnes ou créer de nouveaux éléments ». Notre serveur MCP couvre Google Ads en lecture et en écriture : créez des campagnes Search, Display et Performance Max, ajoutez des mots-clés et des mots-clés négatifs, ajustez les budgets, mettez en pause les campagnes, gérez les audiences Customer Match, configurez le suivi des conversions et extrayez les données de performance. Le même serveur génère des rapports sur 18 autres plateformes publicitaires et offre une exécution complète des campagnes sur 11 d'entre elles.

Claude ou ChatGPT peuvent-ils gérer mes campagnes publicitaires ?

Oui. Avec le serveur MCP Synter connecté, Claude (Claude Desktop, Claude Code), ChatGPT, Cursor et tout autre client compatible MCP peuvent créer des campagnes, ajuster les budgets, mettre en pause les campagnes sous-performantes, générer des créatifs et synchroniser les audiences sur 14 plateformes publicitaires (actions en écriture sur 16), et extraire les données de performance sur les 19. Claude et les autres clients stdio se connectent via npx @synterai/mcp-server avec un SYNTER_API_KEY ; ChatGPT et les autres clients HTTP se connectent au serveur distant à https://mcp.syntermedia.ai/mcp/ avec un en-tête X-Synter-Key. Les actions destructrices comportent des confirmations intégrées.

Quelle est la différence entre le MCP Google Ads officiel et Synter ?

Deux choses : l'accès en écriture et la couverture des plateformes. Le MCP Google Ads officiel est en lecture seule dans sa version actuelle et ne couvre que Google Ads. Synter génère des rapports sur 19 plateformes et offre une création complète de campagnes sur 14 d'entre elles, notamment Google Ads, Meta, LinkedIn, Microsoft, TikTok, Amazon Ads, Amazon DSP, OpenAI Ads et The Trade Desk. Si vous n'avez besoin que des rapports Google Ads, le serveur officiel est un bon choix. Si vous voulez un agent capable d'agir sur ce qu'il trouve, sur Google et partout ailleurs où vous faites de la publicité, c'est exactement pour cela que nous avons construit Synter.


Ressources


Licence

Licence MIT — voir LICENSE pour plus de détails.


Synter
L'extension MCP qu'ils ne veulent pas que vous utilisiez.
Parce que les agents IA avec des budgets publicitaires changent tout.