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 ?
- 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_campaignpour 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_campaignlorsque 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_imageougenerate_videodes assets publicitaires prêts à être téléversés. - Run any of 140+ tools — Accédez directement au catalogue complet de Synter avec
run_toolpour des actions avancées.
Documentation
Serveur MCP Synter
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/pluginest 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 MCP | Serveur MCP officiel Google Ads | Serveurs MCP publicitaires tiers typiques | |
|---|---|---|---|
| Accès | Lecture sur les 19 plateformes, création de campagnes sur 14, actions d'écriture sur 16 | Lecture seule (version actuelle) | Souvent en lecture seule ou écriture partielle |
| Plateformes | 19 en reporting, 14 avec création complète de campagnes (listes ci-dessous) | Google Ads uniquement | Gé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 destructrices | n/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
| Outil | Description |
|---|---|
list_campaigns | Lister les campagnes sur toutes les plateformes connectées |
create_search_campaign | Créer une campagne Google Search avec mots-clés et annonces |
create_display_campaign | Créer une campagne Google Display avec images |
create_pmax_campaign | Créer une campagne Performance Max |
create_meta_campaign | Créer une campagne Facebook/Instagram |
create_linkedin_campaign | Créer une campagne LinkedIn pour le B2B |
create_reddit_campaign | Créer une campagne Reddit |
pause_campaign | Mettre en pause n'importe quelle campagne |
update_campaign_budget | Modifier le budget quotidien |
📈 Performance et analytique
| Outil | Description |
|---|---|
get_performance | Obtenir impressions, clics, dépenses, conversions, ROAS |
get_daily_spend | Répartition des dépenses quotidiennes par plateforme |
🎯 Mots-clés et ciblage
| Outil | Description |
|---|---|
add_keywords | Ajouter des mots-clés à une campagne ou un groupe d'annonces |
add_negative_keywords | Bloquer les termes de recherche indésirables |
🔄 Suivi des conversions
| Outil | Description |
|---|---|
create_conversion | Configurer une action de conversion |
list_conversions | Lister les actions de conversion existantes |
diagnose_tracking | Vérifier si le suivi est correctement installé |
🎨 Génération créative
| Outil | Description |
|---|---|
generate_image | Générer par IA des images publicitaires |
generate_video | Générer par IA des annonces vidéo |
upload_image | Télécharger des images comme assets publicitaires |
🔧 Utilitaire
| Outil | Description |
|---|---|
list_ad_accounts | Lister tous les comptes publicitaires connectés |
run_tool | Exé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 ?
| Plateforme | Idéale pour | Budget minimum |
|---|---|---|
| Google Ads | Les personnes recherchant activement votre produit | 10 $/jour |
| Meta (Facebook/Instagram) | Produits visuels, audiences larges | 5 $/jour |
| B2B, entreprises, chercheurs d'emploi | 25 $/jour | |
| Communautés de niche, utilisateurs férus de technologie | 5 $/jour | |
| Microsoft (Bing) | Données démographiques plus âgées, B2B | 10 $/jour |
| TikTok | Génération Z, divertissement, e-commerce | 20 $/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
| Terme | Ce que cela signifie |
|---|---|
| Impressions | Combien de fois votre annonce a été affichée |
| Clics | Combien de personnes ont cliqué sur votre annonce |
| CTR | Taux de clics (clics ÷ impressions × 100) |
| CPC | Coût par clic |
| Conversions | Actions souhaitées (inscriptions, achats, etc.) |
| ROAS | Retour 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 :
- ✅ Une URL de page de destination où les gens iront lorsqu'ils cliqueront
- ✅ Une idée de qui vous voulez atteindre (emplacement, centres d'intérêt)
- ✅ Un budget quotidien avec lequel vous êtes à l'aise (10-50 $ pour commencer)
- ✅ 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 :
Campagne Dépenses Clics Conversions ROAS Recherche de marque 142 $ 89 12 4,2x Mots-clés concurrents 98 $ 45 3 1,5x Reciblage Display 67 $ 234 8 2,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 :
- Allez sur syntermedia.ai/settings/credentials
- Cliquez sur « Connecter » à côté de chaque plateforme
- Terminez le flux OAuth
- 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
| Variable | Requise | Description |
|---|---|---|
SYNTER_API_KEY | Oui | Votre clé API Synter |
SYNTER_API_URL | Non | Remplacement 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 »
- Vérifiez que vous avez copié la clé complète (elles sont longues !)
- Vérifiez que la clé est active sur syntermedia.ai/developer
- Assurez-vous que la clé dispose du champ d'application
tools:write
« Aucun compte publicitaire connecté »
Vous devez connecter au moins une plateforme publicitaire :
- Allez sur syntermedia.ai/settings/credentials
- Cliquez sur « Connecter » à côté de Google Ads (ou d'une autre plateforme)
- Terminez l'autorisation OAuth
Les outils ne s'affichent pas dans Claude/Cursor
- Redémarrez complètement votre client IA (pas seulement un rafraîchissement)
- Consultez les journaux du serveur MCP pour détecter les erreurs
- 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
- Manuel Synter : syntermedia.ai/manual
- Documentation API : docs.syntermedia.ai
- Plugin Claude : github.com/Synter-Media-AI/plugin (compétences, agents et ce MCP pour Claude Code / Desktop)
- Référence des outils : docs.syntermedia.ai/tools
- Comparaison des serveurs MCP : syntermedia.ai/blog/best-ad-platform-mcp-servers
- Compétences d'agent gratuites (47 open-source) : github.com/Synter-Media-AI/free-skills (également sur skills.sh)
- Support : hello@syntermedia.ai
Licence
Licence MIT — voir LICENSE pour plus de détails.
L'extension MCP qu'ils ne veulent pas que vous utilisiez.
Parce que les agents IA avec des budgets publicitaires changent tout.