Connecter Meta Ads à Claude Code en une commande
Claude Code
Connectez Meta Ads à Claude Code : lancez claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp, tapez /mcp et connectez-vous à PaidSync.ai.
Claude Code accède alors à vos comptes Meta via 92 outils : performances par placement, âge, pays et appareil, groupes d'annonces, audiences, visuels, création de campagnes. Claude Code demande avant chaque outil, et la plupart des écritures Meta passent d'abord en simulation.
Une commande. OAuth, sans clé. Gratuit : 100 tâches/mois, valeur $50, sans carte.
La commande
Claude Code dialogue avec les serveurs MCP distants via Streamable HTTP. PaidSync en fait partie. Ajoutez-le une fois, et le terminal qui modifie votre code peut aussi lire et modifier vos comptes publicitaires Meta.
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpPar défaut, cela enregistre le serveur pour le projet courant seulement. Ajoutez --scope user pour le rendre disponible dans tous les projets de votre machine.
Exécutez claude mcp list pour confirmer qu'il est là, puis lancez une session et tapez /mcp pour vous connecter.
Configuration en 5 étapes
1Inscrivez-vous sur paidsync.ai/signup
Cela prend 10 secondes. Connexion avec Google ou e-mail. Le forfait gratuit offre 100 tâches par mois à $0, sans carte.
2Connectez Meta Ads dans le tableau de bord PaidSync
Cliquez sur Connecter pour Meta Ads et connectez-vous avec le compte Facebook qui gère votre Business Manager. Meta Ads s'autorise via Facebook OAuth avec les permissions ads_read et ads_management. PaidSync stocke les jetons chiffrés au repos avec AES-256-GCM.
Déjà dans Claude Code ? Demandez-lui d'exécuter connect_facebook_ads. L'outil renvoie un lien OAuth à ouvrir dans votre navigateur.
3Choisissez le compte publicitaire sur lequel Claude Code doit travailler
Après la connexion, PaidSync liste les comptes publicitaires Meta accessibles avec cet identifiant. Cochez ceux qui appartiennent à cet espace de travail. Dans une session, list_fb_ad_accounts les affiche et set_fb_ad_account choisit le compte actif.
4Ajoutez PaidSync à Claude Code
Dans votre terminal, lancez :
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpDémarrez une session, tapez /mcp, choisissez paidsync et connectez-vous avec votre compte PaidSync dans la fenêtre du navigateur qui s'ouvre. Claude Code stocke le jeton OAuth pour vous. Aucune clé n'est collée nulle part.
Vous configurez pour une équipe ? Validez un .mcp.json à la racine du dépôt pour que chaque ingénieur ait le même connecteur :
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}Vous préférez une clé API, par exemple pour des exécutions sans interface ? Envoyez-la dans un en-tête, jamais dans l'URL, où elle finirait dans les journaux :
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"Dans un .mcp.json validé, ajoutez "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } pour que la clé reste dans l'environnement de chaque ingénieur et n'entre jamais dans git. Appliquer un changement à Google Ads exige toujours la connexion OAuth. Sur les autres plateformes, une clé peut aussi appliquer des changements, donc traitez-la comme un mot de passe et préférez OAuth.
5Testez la connexion
Dans une session Claude Code, demandez : “Show me last 7 days Meta performance by campaign”
Claude Code renvoie dépense, impressions, clics, CTR, CPC et ROAS de chaque campagne du compte publicitaire actif. La connexion est active.
Le forfait gratuit comprend 100 tâches par mois. Pro à partir de $99 par mois, Team à partir de $249.
Prompts Meta Ads dans Claude Code
Chaque prompt ci-dessous correspond à des outils du groupe Meta Ads de PaidSync. Claude Code choisit l'outil. La dernière colonne indique si l'appel peut modifier quoi que ce soit dans le compte publicitaire.
| Demande | Outils appelés | Modifie votre compte ? |
|---|---|---|
| “Show last 7 days campaign performance with spend, CTR, CPC and ROAS” | get_fb_performance | Non |
| “Which placements drove the cheapest conversions this month?” | get_fb_performance_by_placement | Non |
| “Rank every ad by CTR for the last 14 days” | get_fb_ad_performance | Non |
| “How is budget pacing this month on the active account?” | get_fb_budget_pacing | Non |
| “Pause the three ad sets with the highest cost per result” | get_fb_adset_performance, pause_fb_adset | Oui, après votre confirmation |
| “Duplicate the best ad set into the Prospecting campaign with its ads” | duplicate_fb_adset | Oui, après votre confirmation |
| “Create a 1 percent lookalike of the Purchasers audience in the US” | create_fb_lookalike_audience | Oui, après votre confirmation |
| “Draft a Sales campaign with a $50 daily budget and show me the preview” | create_fb_campaign | Oui, après votre confirmation |
Exécuter sans interface avec claude -p
L'option -p lance Claude Code sans la session interactive. Connectez-vous une fois via /mcp et le jeton OAuth stocké est repris. Un rapport qui atterrit dans un fichier ressemble à ceci :
claude -p "Pull last 7 days Meta performance by placement and list the placements with the highest cost per result." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/meta-ads-$(date +%F).jsonLes lectures s'exécutent directement, et les écritures aussi. --allowedTools "mcp__paidsync" autorise tous les outils PaidSync, écritures comprises, sans invite.
Pour une tâche sans surveillance, n'autorisez que les outils de lecture nécessaires, chacun par son nom sous la forme mcp__paidsync__tool_name.
Ce qui se lit et ce qui s'écrit
Sur les 92 outils Meta Ads, 53 lisent seulement et 36 peuvent écrire.
La lecture couvre la performance au niveau campagne, groupe d'annonces et annonce, les répartitions par âge et genre, pays, appareil, emplacement et période, le rythme du budget, les pixels, les catalogues et le journal d'activité du compte.
Lire la suite
Les écritures couvrent les campagnes, groupes d'annonces, annonces, visuels, audiences, formulaires de leads, règles automatisées et calendriers de budget. Chacune est prévisualisée par défaut avec dry_run, sauf upload_fb_ad_image et upload_fb_ad_video, qui s'appliquent dès le premier appel.
Via MCP, l'étape d'approbation est l'invite propre à Claude Code. Il demande une confirmation avant d'exécuter un outil, sauf si vous l'avez autorisé avec --allowedTools ou dans vos paramètres. PaidSync ajoute des contrôles de son côté. Les suppressions, mises en pause et changements de budget exigent confirm_destructive, et un contrôle de règles avant écriture bloque les arguments dangereux. La carte d'approbation, et l'annulation sur une carte appliquée dont la modification a un inverse sûr, ne s'appliquent que dans l'espace de travail PaidSync.
Ajouter à ChatGPT : ouvrez PaidSync.ai dans l'annuaire des plugins de ChatGPT, installez-le, puis connectez-vous.
Ajouter à Claude : ouvrez PaidSync.ai dans l'annuaire des connecteurs de Claude, cliquez sur Connecter, puis connectez-vous.
Limites à connaître
delete_fb_campaignetdelete_fb_audiencesont définitifs. Mettez plutôt en pause si vous voulez garder l'historique.- Un groupe d'annonces dupliqué arrive en pause et, par défaut, sans ses annonces. Passez
deep_copypour copier aussi les annonces. get_fb_leadsrenvoie des noms, e-mails et numéros de téléphone. Si vous écrivez le résultat dans un fichier d'un dépôt, gardez ce fichier hors du contrôle de version.- L'emplacement du budget décide du reste. Un budget sur la campagne signifie que Meta le répartit entre les groupes d'annonces. Sans budget sur la campagne, chaque groupe d'annonces porte le sien.
Questions fréquentes
Comment connecter Meta Ads à Claude Code ?
Inscrivez-vous sur paidsync.ai, connectez Meta Ads via Facebook OAuth dans le tableau de bord, puis lancez claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp dans votre terminal. Tapez /mcp dans une session, choisissez paidsync et connectez-vous avec votre identifiant PaidSync.
Claude Code peut-il créer des campagnes Meta ?
Oui. Meta Ads est une plateforme de niveau Build dans PaidSync. Claude Code peut créer des campagnes, groupes d'annonces, annonces et audiences. La plupart des écritures sont d'abord prévisualisées en simulation, et Claude Code demande avant d'exécuter chaque outil. Les imports d'images et de vidéos s'appliquent dès le premier appel.
Quelles permissions Meta PaidSync demande-t-il ?
PaidSync demande ads_read et ads_management via Facebook OAuth. Cela couvre la lecture et l'écriture sur les campagnes, groupes d'annonces, annonces, audiences et données de performance des comptes publicitaires que vous connectez.
Cela fonctionne-t-il en mode sans interface avec claude -p ?
Oui. Une fois connecté via /mcp, claude -p réutilise le jeton OAuth stocké. Les lectures s'exécutent directement. Les écritures demandent de la prudence. Personne n'est là pour répondre à l'invite de Claude Code : tout outil d'écriture que vous avez autorisé avec --allowedTools s'exécute donc directement. Pour une tâche sans surveillance, n'autorisez que les outils de lecture nécessaires.
Est-ce gratuit ?
Oui. Le forfait gratuit coûte $0 pour 100 tâches par mois, sans carte. Pro démarre à $99 par mois et Team à $249 par mois.
92 outils Meta Ads. Une commande dans Claude Code.