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 d'afficher toutes les campagnes des comptes publicitaires connectés à l'aide de list_campaigns.
  • Create search campaigns — Faites créer par votre assistant une campagne Google Search avec mots-clés, budget et page de destination via create_search_campaign.
  • Pause underperforming ads — Demandez à votre assistant de suspendre toute campagne qui dépense trop ou sous-performe avec pause_campaign.
  • Adjust daily budgets — Demandez des modifications de budget à la volée en utilisant update_campaign_budget pour augmenter ou réduire les dépenses.
  • Pull performance metrics — Obtenez impressions, clics, dépenses, conversions et ROAS sur toutes les plateformes avec get_performance.
  • Generate ad creatives — Demandez des images ou vidéos générées par IA pour vos campagnes en utilisant generate_image et generate_video.

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.


Comment Synter se compare

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 les campagnes ou créer de nouveaux assets ». La plupart des serveurs MCP publicitaires tiers ne couvrent qu'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 MCPMCP officiel Google AdsMCP publicitaires tiers typiques
AccèsLecture sur les 19 plateformes, création de campagnes sur 14, actions d'écriture sur 16Lecture seule (version actuelle)Souvent 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_toolRarement
Budgets et mise en pauseVariable
Génération de créatifs IA✅ Images, vidéo, textes
Synchronisation d'audience✅ Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, X
SécuritéConfirmations pour les actions destructricesn/a (lecture seule)Variable
Open source✅ MITVariable

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 en charge en plus les actions d'écriture (mise en pause, mises à jour de budget et de lignes publicitaires, import 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, plus 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 performances 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-la alignée avec package.json, manifest.json et les exemples de configuration de ce README.


⚠️ Avertissement

Votre agent IA sera capable de :

  • Créer des campagnes qui commencent immédiatement à dépenser votre budget
  • Ajuster les enchères qui affectent ce que 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éverser dans vos comptes

Nous avons intégré des confirmations pour les actions destructrices. Mais bon, peut-être ne donnez pas ça à un agent que vous venez tout juste 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 (Streamable HTTP) : 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 Streamable HTTP.

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é avec 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. Consultez le dépôt du plugin ou le guide des plugins Claude. Utilisez ce package MCP directement lorsque vous voulez uniquement les outils, ou que vous connectez un autre client.


Que peut faire votre agent ?

📊 Gestion de 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 analyses

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 de créatifs

OutilDescription
generate_imageGénérer des images publicitaires par IA
generate_videoGénérer des publicités vidéo par IA
upload_imageTéléverser des images comme assets publicitaires

🔧 Utilitaires

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 en publicité ? Pas de problème.

Si vous n'avez jamais diffusé de publicités, 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 qui recherchent 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 apparaît lorsque quelqu'un recherche des mots-clés spécifiques sur Google.

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

Campagnes Display : Annonces image 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 (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

TermeSa signification
ImpressionsCombien de fois votre annonce a été diffusé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 vérification pour la première campagne

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

  1. ✅ Une URL de page d'atterrissage vers laquelle les personnes iront en cliquant
  2. ✅ Une idée de qui vous voulez atteindre (localisation, 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 vos annonces à des personnes qui recherchent déjà ce que vous proposez.


Exemples de conversations

Créer votre première campagne

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

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

  • « La collaboration d'équipe simplifiée »
  • « La 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 :

CampagneDépensesClicsConversionsROAS
Brand Search142 $89124,2x
Competitor Keywords98 $4531,5x
Display Retargeting67 $23482,8x

La campagne « Competitor Keywords » est sous-performante. Voulez-vous que je la mette en pause ou que j'ajuste le ciblage ?

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. Bloquez ces recherches.

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

Générer un créatif publicitaire

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

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

Créé : « Tableau de bord d'automatisation du 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 maintenant 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

Consultez 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 en mode dry-run sauf indication contraire

L'outil universel execute n'exécute jamais une action au 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 exécuter réellement l'action ; pour tout ce qui dépense de l'argent, faites-le uniquement avec l'approbation du propriétaire du compte.


Variables d'environnement

VariableRequisDescription
SYNTER_API_KEYOuiVotre clé API Synter
SYNTER_API_URLNonRemplacement 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 not set »

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

« Invalid or expired API key »

  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é possède la portée tools:write

« No ad accounts connected »

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 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. Vérifiez les journaux du serveur MCP pour 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 propose un serveur MCP officiel pour Google Ads, qui est en lecture seule dans sa version actuelle : il peut interroger des rapports, des métriques et des métadonnées, mais selon la documentation de Google, il « ne peut pas modifier les enchères, suspendre des 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, suspendez des campagnes, gérez les audiences Customer Match, configurez le suivi des conversions et récupérez les données de performance. Le même serveur fournit des rapports sur 18 autres plateformes publicitaires et offre une exécution complète de 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, suspendre les sous-performants, générer des créations et synchroniser les audiences sur 14 plateformes publicitaires (actions d'écriture sur 16), et récupérer des 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 serveur MCP officiel de Google Ads et Synter ?

Deux choses : l'accès en écriture et la couverture des plateformes. Le serveur MCP officiel de Google Ads est en lecture seule dans sa version actuelle et ne couvre que Google Ads. Synter fournit 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 choix solide. Si vous voulez un agent qui peut agir sur ce qu'il trouve, sur Google et partout où vous faites de la publicité, c'est pour cela que nous avons créé 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.