Récupérez les dépenses TikTok Ads, le ROAS et le CTR d'hier en 30 secondes, pour tous les comptes clients, depuis Claude.
Conçu pour les opérateurs paid media qui gèrent plusieurs comptes TikTok Ads. Une seule connexion couvre tous les clients. Auto-hébergez le serveur Python ou évitez entièrement la revue développeur TikTok via le point d'accès hébergé.
- Rapport du matin
Who this is for
Accéder aux données publicitaires de TikTok est plus lourd que sur Facebook. Les marketeurs attendent des jours que TikTok approuve leur application développeur avant qu'un outil de reporting puisse communiquer avec leurs comptes publicitaires.
How this changes your work
Use it with
TikTok Ads MCP works with Claude Desktop, Claude Code, Cursor, Codex, Gemini, Windsurf, OpenClaw, and Hermes — any MCP-compatible AI client. Get it running in seconds.
Pre-configured environment, OAuth handled for you. No command-line work.
Install on ElasticFlow →Managed auth · No laptop setup.
OAuth — authorise in one click
Copy a config snippet into your AI client and restart.
- Exécutez `pip install -e .` ou `uv sync` avant le premier lancement.
- La revue d'application du TikTok Developer Portal est requise pour l'auto-hébergement local.
{
"mcpServers": {
"tiktok-ads": {
"command": "python",
"args": ["/path/to/adsmcp-server/run_server.py"],
"cwd": "/path/to/adsmcp-server",
"env": {
"TIKTOK_APP_ID": "your_app_id",
"TIKTOK_APP_SECRET": "your_app_secret"
}
}
}
}Redémarrez Claude Desktop après avoir modifié claude_desktop_config.json.
Authentication
Steps
- Dire à TikTok que vous voulez lire vos données publicitaires
Allez sur business-api.tiktok.com → My Apps → Create App. Vous enregistrez une app développeur : TikTok l'examine, généralement 1 à 3 jours, avant de la laisser communiquer avec vos comptes publicitaires. Si vous préférez ne pas attendre, le point d'accès hébergé AdsMCP sur adsmcp.com/onboarding a déjà franchi cette étape.
- Copier les deux clés données par TikTok
Une fois l'app approuvée, copiez l'App ID et l'App Secret depuis la console développeur TikTok. Notez aussi votre advertiser ID, le numéro act_… dans TikTok Ads Manager : c'est le premier compte publicitaire sur lequel Claude travaillera.
- Placer les clés dans votre environnement
Ajoutez TIKTOK_APP_ID et TIKTOK_APP_SECRET à votre fichier .env ou au bloc env de la configuration de votre client MCP. Le serveur les lit au démarrage, donc vous ne collez jamais de clés sensibles dans Claude.
- Se connecter à TikTok depuis Claude
Demandez à Claude de démarrer la connexion TikTok. Claude vous donne une URL à usage unique : ouvrez-la, accordez l'accès aux comptes annonceurs concernés, copiez le code retourné par TikTok et rendez-le à Claude dans un prompt. Ensuite Claude renouvelle la connexion automatiquement.
- Basculer entre comptes clients au fil du travail
Quand vous gérez plusieurs clients, demandez à Claude de passer à un autre advertiser ID. Vous vous êtes connecté une fois avec un utilisateur TikTok qui les voit tous ; Claude change de compte à la demande, sans nouvelle connexion.
Scopes explained
| Scope | Why this MCP needs it |
|---|---|
user_info | Confirme quel utilisateur TikTok For Business est connecté, pour déterminer quels comptes annonceurs Claude peut voir. |
campaign.management | Requis pour voir vos campagnes et ad groups, et pour les modifier dans de futures versions. |
ads.reporting | Requis pour récupérer dépenses, ROAS, CTR et conversions : les données de reporting. |
Troubleshooting
~7 min first time
MIT · v0.1.0 · released today