MCP Meta Ads dans Cursor, VS Code et Claude Code : guide de configuration

Vous pouvez intégrer Meta Ads à Cursor, VS Code ou Claude Code en ajoutant une seule adresse de serveur MCP distant, https://teraads.co/mcp, puis en vous connectant à Tera Ads dans votre navigateur. Rien à installer ni à héberger. Cursor et VS Code demandent une courte entrée JSON, Claude Code une seule commande ; ensuite, les trois lisent vos campagnes en direct et le bénéfice après retours de votre boutique Shopify. Pour chaque connexion, vous choisissez si votre IA lit seulement, vous demande d'abord ou fait des modifications.

Pourquoi connecter Meta Ads à votre éditeur de code

Si vous développez vous-même le thème de votre boutique Shopify, vos scripts ou vos outils internes, vous passez déjà vos journées dans votre éditeur. Un agent IA qui s'y trouve peut répondre à une question sur vos publicités sans détour par Ads Manager, écrire la réponse dans un fichier de votre dépôt, ou vérifier si la page de destination que vous venez de modifier est bien celle vers laquelle vos meilleures publicités envoient du trafic.

Le MCP, ou Model Context Protocol, est le standard ouvert qui rend cela possible : l'agent de l'éditeur appelle des outils exposés par un serveur, et le serveur dialogue avec la plateforme publicitaire. Les connecteurs MCP expliqués (en anglais) détaille son fonctionnement. La documentation de Cursor cite stdio, SSE et Streamable HTTP comme transports pris en charge et indique qu'il gère OAuth pour les serveurs qui l'exigent (documentation MCP de Cursor). Claude Code se connecte aux serveurs distants avec OAuth via sa commande /mcp (documentation MCP de Claude Code). Un serveur hébergé n'exige donc aucune clé collée dans un fichier de configuration.

Tera Ads Connect est un serveur de ce type, conçu pour les marques Shopify. En plus des lectures Meta en direct, il répond à partir de votre boutique : commandes, retours, coût des produits, livraison, frais et remboursements, moins vos dépenses publicitaires Meta et Google. Le chiffre d'affaires attribué par Meta est étiqueté comme celui de Meta, pour que votre IA ne le prenne pas pour des ventes. Pour une vue d'ensemble des serveurs que vous pourriez utiliser à la place, le guide des options MCP pour Meta Ads les compare.

Avant de commencer

• Un compte Tera Ads gratuit. Inscrivez-vous et connectez votre compte publicitaire Meta. Connectez aussi Shopify, pour que votre IA voie les ventes et le bénéfice de la boutique.
• Un accès propriétaire. Seul le propriétaire de l'entreprise peut connecter une IA à une entreprise dans Tera Ads.
• Votre éditeur. Cursor, VS Code avec sa vue de chat, ou Claude Code dans le terminal.
• Une décision sur les modifications. Décidez si l'IA se contentera de rendre compte ou si elle pourra aussi mettre des publicités en pause et modifier des budgets. Le guide de l'accès sécurisé des IA (en anglais) propose une courte politique à copier.

La configuration en cinq étapes

1. Créez un compte Tera Ads gratuit. Inscrivez-vous, connectez votre compte publicitaire Meta, puis Shopify, pour que les réponses incluent le bénéfice après retours de votre boutique.
2. Ajoutez l'adresse du serveur dans votre éditeur. Collez https://teraads.co/mcp dans les réglages MCP de Cursor ou de VS Code, ou lancez une commande dans Claude Code ; les sections ci-dessous donnent l'entrée exacte pour chacun.
3. Connectez-vous à Tera Ads dans votre navigateur. L'éditeur ouvre Tera Ads, où vous vous connectez et choisissez l'entreprise, une seule, à partager.
4. Choisissez ce que votre IA a le droit de faire. Optez pour lecture seule, « me demander d'abord » ou faire des modifications pour cette connexion ; vous pourrez passer de l'un à l'autre des deux derniers modes plus tard, sous AI connections dans Tera Ads.
5. Posez une question que vous pouvez vérifier. Commencez par quelque chose comme « Combien ai-je dépensé sur Meta hier ? » et comparez la réponse avec Ads Manager avant de vous fier à quoi que ce soit de plus important.

La connexion utilise OAuth 2.1 avec PKCE, et le serveur prend en charge l'enregistrement dynamique des clients : votre éditeur s'enregistre lui-même, et vous ne manipulez jamais d'identifiant client ni de secret. Tera Ads ne stocke les jetons que sous forme de hachages à sens unique. Les jetons d'accès durent une heure et sont renouvelés pour vous ; une connexion dure 30 jours, après quoi vous vous reconnectez.

Cursor

Cursor lit les serveurs MCP dans un fichier JSON. Sa documentation indique que ~/.cursor/mcp.json, dans votre dossier personnel, rend les outils disponibles partout, et que .cursor/mcp.json, dans un projet, les réserve à ce projet (documentation MCP de Cursor). Ajoutez cette entrée, celle que Tera Ads publie sous configs/cursor/mcp.json dans son dépôt GitHub :

{"mcpServers": {"tera-ads": {"url": "https://teraads.co/mcp"}}}

Si le fichier liste déjà d'autres serveurs, ajoutez l'entrée "tera-ads" dans l'objet mcpServers existant au lieu de le remplacer. Quand Cursor vous le demande, connectez-vous à Tera Ads dans votre navigateur. Aucune clé d'API ni en-tête à ajouter.

Par défaut, Cursor demande votre accord avant d'utiliser un outil MCP. Sa documentation décrit aussi une liste d'outils autorisés qui s'exécutent sans demander. Si vous l'utilisez, n'y mettez que des outils de lecture comme get_insights et get_profit, et laissez les outils de modification (pause, resume, set_budget, duplicate et les outils de création) soumis à confirmation.

VS Code

VS Code vous propose deux méthodes :

• MCP: Add Server. Ouvrez la Command Palette, lancez MCP: Add Server, choisissez HTTP, collez https://teraads.co/mcp et donnez au serveur l'ID tera-ads.
• Un fichier d'espace de travail. Ajoutez l'entrée de configs/vscode/mcp.json du dépôt dans .vscode/mcp.json : {"servers": {"tera-ads": {"type": "http", "url": "https://teraads.co/mcp"}}}. VS Code utilise servers là où Cursor utilise mcpServers : ne copiez donc pas le fichier d'un éditeur dans l'autre.

La documentation MCP de VS Code oriente désormais les nouvelles configurations vers son parcours guidé et précise que les fichiers .vscode/mcp.json d'espace de travail restent disponibles pour la compatibilité : les deux méthodes fonctionnent. Démarrez le serveur, connectez-vous à Tera Ads quand VS Code vous le demande, puis activez Tera Ads sous Configure Tools, dans la zone de saisie du chat. La documentation de VS Code conseille de n'approuver que les actions que vous comprenez, la bonne habitude pour toute demande qui touche à un budget.

Claude Code

Une seule commande ajoute le serveur :

claude mcp add --transport http tera-ads https://teraads.co/mcp

Lancez Claude Code, tapez /mcp, choisissez tera-ads et connectez-vous à Tera Ads dans votre navigateur. La documentation de Claude Code indique que /mcp lance la connexion OAuth et que les jetons sont stockés et renouvelés automatiquement ; claude mcp list montre si chaque serveur est connecté ou demande une authentification.

Par défaut, le serveur est ajouté avec la portée locale : pour vous seul, dans le projet en cours. Ajoutez --scope user pour l'avoir dans tous vos projets, ou --scope project pour l'écrire dans un fichier .mcp.json partagé via le contrôle de version. Un fichier partagé ne partage que l'adresse. Chacun se connecte séparément, et seul le propriétaire de l'entreprise peut connecter une IA à une entreprise Tera Ads.

Le plugin et ses six skills

Pour ajouter le serveur avec des flux de travail prêts à l'emploi, installez plutôt Tera Ads comme plugin. Lancez claude plugin marketplace add Teralabsx/meta-ads-mcp, puis claude plugin install tera-ads@tera-ads. La documentation des plugins de Claude Code indique qu'un plugin ajoute ses skills, agents, hooks et serveurs MCP, et que ses skills apparaissent sous la forme /<plugin>:<skill> : la première du tableau ci-dessous s'appelle donc /tera-ads:profit-check.

La même documentation indique que les plugins des marketplaces tierces ne se mettent pas à jour automatiquement par défaut. Pour récupérer une nouvelle version, lancez claude plugin update tera-ads@tera-ads.

Les trois éditeurs côte à côte

Que demander en premier

Commencez par des questions dont vous pouvez vérifier la réponse dans Ads Manager en une minute. Une fois que les chiffres concordent, passez à celles qui demandent les données de votre boutique. La bibliothèque de prompts pour l'analyse publicitaire et les questions à poser à l'IA sur vos publicités (toutes deux en anglais) en proposent d'autres.

Gardez deux choses en tête en lisant les réponses. D'abord, les achats et le chiffre d'affaires de Meta relèvent de l'attribution de Meta, pas des ventes de votre boutique ; pourquoi Meta Ads et Shopify ne sont pas d'accord (en anglais) explique l'écart. Ensuite, get_ads_review juge chaque campagne qui a dépensé sur le bénéfice après les retours habituels de votre boutique, à vos propres coûts, par rapport à votre ROAS seuil de rentabilité. Le bénéfice lui-même est une estimation pour toute la boutique, calculée à partir de vos commandes avec votre réglage de marge, pas de l'argent en banque.

Gardez la main sur les modifications de vos publicités

Les modifications se contrôlent à deux endroits : votre éditeur, qui peut demander avant chaque exécution d'outil, et Tera Ads, qui décide de ce que la connexion a le droit de faire.

• Lecture seule, demander d'abord ou faire des modifications. En mode demander d'abord, une modification attend dans Tera Ads que vous l'y approuviez, et votre IA ne peut pas l'approuver à votre place.
• Tout ce qui est nouveau démarre en pause. Campagnes, ensembles de publicités, publicités et copies ne dépensent rien tant que rien ne les active.
• Les paliers de budget sont plafonnés. Une seule modification peut au plus tripler un budget ou le réduire à un dixième.
• Un plafond quotidien. Les assistants peuvent faire au plus 50 modifications par jour sur une même entreprise.
• Aucun outil de suppression. Votre IA peut mettre en pause, mais ne peut rien supprimer.
• Annulation pendant 7 jours. Une mise en pause, une activation ou une modification de budget peut être annulée dans Tera Ads pendant 7 jours. Les nouvelles campagnes, les nouveaux ensembles de publicités et les nouvelles publicités ne peuvent pas être annulés, mais ils démarrent en pause.
• Une entreprise par connexion. Une connexion ne peut pas lire une autre entreprise, même si elle vous appartient aussi.

Les noms de campagne et les textes publicitaires arrivent à votre IA comme des données, et Tera Ads lui indique de ne pas suivre les instructions qu'ils contiennent. La documentation de Claude Code fait le même constat de façon générale : les serveurs qui récupèrent du contenu extérieur peuvent vous exposer à l'injection de prompts, donc ne connectez que des serveurs de confiance. Si vous voulez voir chaque modification avant qu'elle ait lieu, choisissez demander d'abord.

En cas de problème

Le serveur indique qu'il faut se connecter. Dans Claude Code, lancez /mcp et choisissez tera-ads ; claude mcp list signale qu'une authentification est nécessaire tant que ce n'est pas fait. Dans Cursor et VS Code, redémarrez le serveur et terminez la connexion dans le navigateur.

Les outils n'apparaissent pas dans le chat de VS Code. Ouvrez Configure Tools dans la zone de saisie du chat et activez Tera Ads.

Votre IA dit qu'une limite est atteinte. L'offre gratuite donne 30 appels par semaine, remis à zéro chaque semaine en UTC. Demandez à votre IA de lancer get_usage, qui est gratuit et indique combien d'appels il reste et quand le compteur repart à zéro.

Les budgets semblent cent fois trop élevés. list_campaigns affiche les budgets dans les unités de Meta, des centièmes pour la plupart des devises : 5000 signifie donc 50 $. set_budget prend des unités entières de la devise de votre compte.

Les réponses portent sur la mauvaise boutique. Chaque connexion couvre une seule entreprise. Reconnectez-vous et choisissez l'autre entreprise.

Tera Ads Connect est le serveur MCP de Tera Ads, le tableau de bord du bénéfice pour les marques Shopify. Il donne à votre éditeur des lectures Meta en direct, les ventes Shopify et le bénéfice après retours, ainsi que des modifications publicitaires limitées et journalisées. L'offre gratuite comprend 30 appels par semaine sur un compte publicitaire Meta, et Connect Pro coûte 15 $ par mois pour 3 000 appels par mois sur trois comptes publicitaires au maximum ; il est inclus dans les offres Growth et Scale. Les étapes de configuration pour chaque client se trouvent sur la page Connect. Si vous travaillez avec des agents en terminal, le guide Meta Ads dans Codex et Gemini CLI couvre ces deux outils ; pour les assistants de chat, voyez comment connecter Facebook Ads à ChatGPT et utiliser Claude avec Meta Ads.

Questions fréquentes

Le MCP Meta Ads fonctionne-t-il dans Cursor ?

Oui. Cursor prend en charge les serveurs MCP distants avec connexion OAuth. Ajoutez l'entrée Tera Ads à ~/.cursor/mcp.json ou .cursor/mcp.json, puis connectez-vous à Tera Ads quand Cursor vous le demande.

Comment ajouter le MCP Meta Ads à VS Code ?

Lancez MCP: Add Server, choisissez HTTP et collez https://teraads.co/mcp, ou ajoutez l'entrée à .vscode/mcp.json. Démarrez le serveur, connectez-vous, puis activez Tera Ads sous Configure Tools dans le chat.

Quelle est la commande Claude Code pour le MCP Meta Ads ?

claude mcp add --transport http tera-ads https://teraads.co/mcp. Tapez ensuite /mcp dans Claude Code et connectez-vous. Pour avoir six skills publicitaires prêtes à l'emploi, installez le plugin avec claude plugin marketplace add Teralabsx/meta-ads-mcp et claude plugin install tera-ads@tera-ads.

Faut-il une clé d'API ou une application développeur Meta ?

Non. Vous vous connectez à Tera Ads dans votre navigateur, et les modifications parviennent à Meta via l'application Meta approuvée de Tera Ads. Rien de secret ne va dans votre fichier de configuration.

L'IA de mon éditeur peut-elle modifier mes publicités ?

Seulement si vous l'autorisez pour cette connexion. Même dans ce cas, tout ce qui est nouveau démarre en pause, une seule modification de budget peut au plus tripler le budget ou le réduire à un dixième, et une mise en pause, une activation ou une modification de budget peut être annulée dans Tera Ads pendant 7 jours.

Combien ça coûte ?

L'offre gratuite comprend 30 appels par semaine sur un compte publicitaire Meta. Connect Pro coûte 15 $ par mois pour 3 000 appels par mois. Un appel est une consultation que votre IA fait dans Tera Ads, et une seule question peut en demander plusieurs.