Synter Ads MCP Server

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.

GitHub

Documentation

Serveur MCP Synter

L'extension MCP que Claude ne veut pas que vous utilisiez.

Parce qu'une fois installée, votre agent IA peut dépenser de l'argent réel.

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

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

Pourquoi Synter ?

La plupart des serveurs MCP publicitaires sont en lecture seule et mono-plateforme. Synter est le seul serveur MCP de gestion publicitaire multi-plateforme avec des capacités complètes de lecture et d'écriture :

Fonctionnalité	Synter	Google Ads MCP	Amazon Ads MCP	Autres
Plateformes	9+ (Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X, StackAdapt, TTD)	Google uniquement	Amazon uniquement	1-2
Créer des campagnes	✅	❌ Lecture seule	✅ Amazon uniquement	❌
Ajuster les budgets	✅	❌	✅	❌
Mettre en pause des campagnes	✅	❌	✅	❌
Génération créative IA	✅ (Imagen 4, Veo, Flux)	❌	❌	❌
Optimisation des enchères	✅	❌	❌	❌
Stratège IA	✅	❌	❌	❌
Open source	✅	✅	❌	Variable

Un seul serveur MCP. Toutes les plateformes publicitaires. Lecture et écriture.

⚠️ Avertissement

Votre agent IA pourra :

Créer des campagnes qui commencent immédiatement à dépenser votre budget
Ajuster les enchères qui affectent le coût 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éations et les télécharger sur vos comptes

Nous avons intégré des confirmations pour les actions destructrices. Mais quand même — ne confiez peut-être pas ça à 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 diffusable) — 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 diffusable.

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 enveloppe 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 crochet 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 headless Claude Agent SDK pour l'automatisation. Voir le dépôt du plugin ou le guide du plugin Claude. Utilisez ce package MCP directement lorsque vous voulez juste les outils, ou pour connecter 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 de recherche Google avec mots-clés et annonces
`create_display_campaign`	Créer une campagne Display Google 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 analyses

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 des images publicitaires par IA (Imagen 4, Flux, SDXL)
`generate_video`	Générer des annonces vidéo par IA (Veo, Runway, Luma)
`upload_image`	Télécharger des images comme ressources publicitaires

🔧 Utilitaires

Outil	Description
`list_ad_accounts`	Lister tous les comptes publicitaires connectés
`run_tool`	Exécuter directement l'un des 140+ outils Synter

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

Si vous n'avez jamais diffusé d'annonces, 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éal pour	Budget minimum
Google Ads	Personnes recherchant activement votre produit	10 $/jour
Meta (Facebook/Instagram)	Produits visuels, audiences larges	5 $/jour
LinkedIn	B2B, entreprise, chercheurs d'emploi	25 $/jour
Reddit	Communautés de niche, utilisateurs férus de technologie	5 $/jour
Microsoft (Bing)	Démographie plus âgée, 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 quand 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 illustrées diffusées sur des sites web et applications.

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

Performance Max (PMax) — L'IA de Google diffuse vos annonces partout (Recherche, YouTube, Display, Gmail, Maps).

Exemple : Google détermine les meilleurs emplacements pour vous

Campagnes vidéo — Annonces vidéo sur YouTube et sites partenaires.

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

Termes courants

Terme	Signification
Impressions	Nombre de fois où votre annonce a été affichée
Clics	Nombre de personnes ayant 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 les dépenses publicitaires (revenus ÷ dépenses)

Checklist 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 en cliquant
✅ Une idée de qui vous voulez atteindre (localisation, 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 les annonces aux personnes qui recherchent déjà ce que vous proposez.

Exemples de conversations

Créer votre première campagne

Vous : Crée une campagne de recherche Google pour mon produit SaaS. Cible 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 - Sans carte de crédit"

Vérifier les performances

Vous : Comment se portent mes campagnes cette semaine ?

Agent : Voici vos performances des 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 ?

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

Ajouter 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. Bloque-les.

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

Générer une création publicitaire

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

Agent : Génération de votre image avec Imagen 4...

Créé : "Tableau de bord d'automatisation marketing avec visualisation de données sur fond sombre" Ressource enregistrée et prête à être utilisée 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 maintenant gérer cette plateforme

Plateformes prises en charge :

Google Ads ✅
Meta (Facebook/Instagram) ✅
LinkedIn Ads ✅
Microsoft Ads (Bing) ✅
Reddit Ads ✅
TikTok Ads ✅
X (Twitter) Ads ✅
StackAdapt ✅
The Trade Desk ✅

Avancé : Accès direct aux outils

Pour les utilisateurs avancés, vous pouvez appeler directement l'un 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?

Variables d'environnement

Variable	Requise	Description
`SYNTER_API_KEY`	Oui	Votre clé API Synter
`SYNTER_API_URL`	Non	Remplacement de l'URL 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é a la portée 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 une autre plateforme)
Terminez l'autorisation OAuth

Les outils n'apparaissent pas dans Claude/Cursor

Redémarrez complètement votre client IA (pas seulement actualiser)
Vérifiez les journaux du serveur MCP pour les erreurs
Vérifiez le chemin du fichier de configuration et la syntaxe JSON

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 : [email protected]

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.