Connectez X Ads à Claude Code en une commande
Claude Code
Connectez X 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 ensuite à vos comptes publicitaires X via 14 outils : performances par compte, campagne ou line item, plus pause, réactivation, budget et enchères sur les campagnes existantes. Claude Code demande confirmation avant d'exécuter chaque outil.
Niveau Manage. Claude Code travaille sur les campagnes que vous gérez déjà. Il ne crée pas de nouvelles campagnes X.
La commande
Claude Code communique avec des serveurs MCP distants via Streamable HTTP. PaidSync en fait partie. Ajoutez-le une fois, et le terminal qui modifie votre code peut aussi analyser et gérer vos campagnes X.
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, d'une valeur de $50, à $0, sans carte.
2Connectez X Ads dans le tableau de bord PaidSync
Cliquez sur Connecter pour X Ads et connectez-vous avec le compte X qui peut ouvrir vos comptes publicitaires, puis autorisez PaidSync. X Ads s'autorise via X OAuth, et PaidSync ne voit jamais votre mot de passe X.
Déjà dans Claude Code ? Demandez-lui d'exécuter connect_x_ads. L'outil renvoie un lien à ouvrir dans votre navigateur.
3Choisissez le compte publicitaire sur lequel Claude Code doit travailler
Dans une session, list_x_accounts affiche tous les comptes publicitaires que votre connexion X peut atteindre, et set_active_x_account choisit celui sur lequel Claude Code travaille.
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 : “Montre-moi les dépenses, impressions et clics X par campagne sur les 7 derniers jours”
Claude Code renvoie dépenses, impressions, clics et engagements pour chaque campagne. La connexion est active.
Le forfait gratuit comprend 100 tâches par mois. Pro à partir de $99 par mois, Team à partir de $249.
Prompts X Ads à tester dans Claude Code
Chaque prompt ci-dessous correspond à des outils du groupe PaidSync X Ads. 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 ? |
|---|---|---|
| “Liste mes comptes publicitaires X et active Acme” | list_x_accounts, set_active_x_account | Non |
| “Montre mes campagnes des 7 derniers jours avec dépenses, impressions, clics et engagements” | get_x_performance | Non |
| “Quels line items ont le plus dépensé sur les 30 derniers jours” | get_x_performance | Non |
| “Liste les line items de cette campagne” | list_x_line_items | Non |
| “Mets en pause la campagne Spring Launch” | list_x_campaigns, pause_x_campaign | Oui, après votre confirmation |
| “Passe le budget quotidien de la campagne Retargeting à 80” | update_x_campaign_budget | Oui, après votre confirmation |
| “Baisse l'enchère du line item Lookalikes à 1.50” | list_x_line_items, update_x_line_item | 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 30 days X performance at line item level and list the line items with the highest spend and no clicks." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/x-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 14 outils X Ads, 7 sont en lecture seule et 5 peuvent écrire. La lecture couvre comptes publicitaires, campagnes, line items, publications sponsorisées et performances.
Lire la suite
L'écriture couvre la pause et la réactivation des campagnes, les budgets quotidiens des campagnes, le statut et les enchères des line items, ainsi que les noms des campagnes et line items.
Les modifications de budget, d'enchère, de nom et de statut via les outils de mise à jour sont simulées par défaut avec dry_run, et PaidSync relit ensuite chaque changement depuis X.
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.
Ce que Claude Code ne peut pas faire sur X
- PaidSync ne crée pas de campagnes, line items ou publications sponsorisées X. Créez-les dans X Ads Manager, puis gérez-les depuis Claude Code.
- Il n'y a pas d'outils d'import de créations.
- PaidSync n'a pas d'outil X pour le ciblage, les audiences personnalisées ou le reporting de conversions.
- Les line items se mettent en pause et se réactivent via
update_x_line_item, et les campagnes viapause_x_campaignetenable_x_campaign. - Les montants sont dans la devise et le fuseau horaire propres au compte publicitaire.
Questions fréquentes
Comment connecter X Ads à Claude Code ?
Inscrivez-vous sur paidsync.ai, connectez X Ads via OAuth dans le tableau de bord, puis exécutez 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 compte PaidSync.
Claude Code peut-il créer des campagnes X ?
Non. X Ads est une plateforme de niveau Manage dans PaidSync. Claude Code peut produire des rapports sur les campagnes existantes, les mettre en pause et les réactiver, et modifier les budgets et les enchères des line items. Les nouvelles campagnes se créent dans X Ads Manager.
Claude Code peut-il modifier les budgets X Ads ?
Oui. update_x_campaign_budget modifie le budget quotidien d'une campagne et update_x_line_item modifie l'enchère d'un line item. Les deux s'affichent d'abord en simulation, et Claude Code demande confirmation avant d'exécuter chaque outil.
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.
Rapports X Ads et gestion des campagnes. Une seule commande dans Claude Code.