Connectez TikTok Ads à Claude Code en une commande
Claude Code
Connectez TikTok 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 à vos comptes annonceurs TikTok via 24 outils : performances par annonceur, campagne, groupe et annonce, plus pause, activation, budget et enchères des campagnes existantes. Claude Code demande avant chaque outil.
Niveau Manage. Claude Code travaille sur les campagnes que vous gérez déjà. Il ne crée pas de nouvelles campagnes TikTok.
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 TikTok.
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 TikTok Ads dans le tableau de bord PaidSync
Cliquez sur Connecter pour TikTok Ads et connectez-vous avec le compte TikTok qui a accès à vos comptes annonceurs. TikTok Ads s'autorise via TikTok OAuth. PaidSync stocke les jetons chiffrés au repos avec AES-256-GCM.
Déjà dans Claude Code ? Demandez-lui d'exécuter connect_tiktok_ads. L'outil renvoie un lien OAuth à ouvrir dans votre navigateur.
3Choisissez l'annonceur sur lequel Claude Code doit travailler
Dans une session, list_tiktok_advertisers affiche tous les comptes annonceurs que votre connexion TikTok peut atteindre, et set_active_tiktok_advertiser choisit celui sur lequel Claude Code travaille. Les écritures TikTok exigent d'abord un annonceur 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 : “Montre-moi les dépenses et conversions TikTok par campagne sur les 7 derniers jours”
Claude Code renvoie impressions, clics, CTR, CPC, CPM, dépenses et conversions 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 TikTok Ads dans Claude Code
Chaque prompt ci-dessous correspond à des outils du groupe PaidSync TikTok Ads. Claude Code choisit l'outil. La dernière colonne indique si l'appel peut modifier quoi que ce soit dans le compte annonceur.
| Demande | Outils appelés | Modifie votre compte ? |
|---|---|---|
| “Liste mes comptes annonceurs TikTok et active Acme” | list_tiktok_advertisers, set_active_tiktok_advertiser | Non |
| “Montre dépenses, CTR et conversions par campagne sur les 7 derniers jours” | get_tiktok_performance | Non |
| “Descends au niveau annonce pour la meilleure campagne” | get_tiktok_performance, list_tiktok_ads | Non |
| “Liste les groupes d'annonces de cette campagne avec statut et budget” | list_tiktok_adgroups | Non |
| “Mets en pause la campagne au pire coût par conversion” | pause_tiktok_campaign | Oui, après votre confirmation |
| “Passe le budget de la campagne Spring Sale à $150” | update_tiktok_campaign_budget | Oui, après votre confirmation |
| “Baisse l'enchère de ce groupe d'annonces à $0.80” | update_tiktok_adgroup | 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 TikTok performance at ad level and list the ads with the highest spend and no conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/tiktok-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 24 outils TikTok Ads, 11 sont en lecture seule et 11 peuvent écrire. La lecture couvre annonceurs, campagnes, groupes d'annonces, annonces et performances.
Lire la suite
L'écriture couvre la pause et la réactivation des campagnes, les budgets de campagne, les noms de campagne, ainsi que le statut, le budget, l'enchère et le nom des groupes d'annonces.
Les changements de groupe d'annonces et les changements de budget et de nom de campagne sont simulés par défaut avec dry_run. Mettre en pause ou réactiver une campagne n'a pas de simulation et exige une confirmation explicite.
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 fait pas sur TikTok
- PaidSync ne crée pas de campagnes, groupes d'annonces ni annonces TikTok. Créez-les dans TikTok Ads Manager, puis gérez-les depuis Claude Code.
- PaidSync n'a pas d'outils d'audiences ni d'import de créations pour TikTok.
update_tiktok_campaignne modifie que le nom. Le statut passe parpause_tiktok_campaignetenable_tiktok_campaign, et le budget parupdate_tiktok_campaign_budget.- Une modification du prix d'enchère d'un groupe d'annonces ne s'applique que si le groupe utilise un type d'enchère personnalisé.
- Le reporting TikTok a environ une à deux heures de retard : une vérification à 9 h affiche des données jusqu'à 7 h ou 8 h environ.
Questions fréquentes
Connecter TikTok Ads à Claude Code ?
Inscrivez-vous sur paidsync.ai, connectez TikTok Ads via TikTok 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 TikTok ?
Oui. PaidSync crée des campagnes, groupes d’annonces et annonces vidéo TikTok, tous en pause. Claude Code peut aussi faire des rapports sur les campagnes existantes, les mettre en pause et les activer, et modifier les budgets et les enchères des groupes d’annonces.
Claude Code peut-il modifier les budgets TikTok ?
Oui. update_tiktok_campaign_budget modifie le budget d'une campagne et update_tiktok_adgroup modifie le budget d'un groupe d'annonces. Les deux commencent par une 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 et gestion de campagnes TikTok. Une commande dans Claude Code.