Shortflow
Commencer
Tous les articles
·8 min de lecture·Yom Akakpo

Brancher Claude Code sur ton pipeline TikTok : guide de quinze minutes

L'installation Claude Code, la configuration MCP, les quatre serveurs à connecter en premier, et la conversation type pour tester que tout tourne. Tutoriel de bout en bout, durée chronométrée.

claude-codemcpsetuptutorial

Quinze minutes. C'est le temps que prend, en 2026, de passer d'un terminal vierge à un Claude Code opérationnel qui pilote votre pipeline de publication TikTok via MCP. Ce n'est pas une métaphore — j'ai chronométré la séquence trois fois sur trois machines différentes (deux MacBook Pro et un dev-container Linux). Médiane à 14 minutes 22, écart-type négligeable.

Pour quiconque produit du contenu vidéo et n'a pas encore franchi le pas du MCP, ces quinze minutes représentent le meilleur investissement temps de l'année. Voici la séquence exacte, étape par étape.

Ce que vous allez avoir à la fin

À la fin de ce guide, Claude Code peut :

  • Lister vos comptes sociaux connectés à Shortflow (YouTube, TikTok, Instagram, Facebook, Threads, LinkedIn).
  • Lire votre dossier de renders local et identifier les nouvelles vidéos à publier.
  • Uploader un MP4 dans la médiathèque Shortflow.
  • Créer une publication multi-plateforme programmée.
  • Récupérer les métriques d'une publication existante.
  • Lire et modifier les scripts Markdown ou JSON de vos épisodes.
  • Committer les modifications dans un repo Git si vous en versionnez vos scripts.

Toutes ces opérations dans une seule conversation, depuis le terminal, sans changement d'onglet. C'est précisément la configuration que je fais tourner en production sur huit chaînes depuis trois mois.

Étape 1 — Installer Claude Code (deux minutes)

Si vous n'avez pas encore installé Claude Code, ça se fait en deux commandes. Sur macOS et Linux :

# Téléchargement et installation
curl -fsSL https://claude.com/install.sh | bash

# Vérification
claude --version

Sur Windows, l'installeur exécutable est disponible sur claude.com/code — même résultat, quelques clics.

L'installation déploie le binaire claude dans $HOME/.local/bin et ajoute un alias. La première invocation vous demandera de vous authentifier via votre compte Anthropic. Ce login se fait dans un navigateur, dure trente secondes, et persiste indéfiniment sur la machine.

Ce qui me prenait régulièrement plus que prévu lors de mes premières installations : oublier que le terminal en cours d'exécution n'avait pas rechargé son PATH. Si claude --version retourne « command not found » après l'install, lancez un nouveau terminal — c'est presque toujours ça.

Étape 2 — Comprendre la config MCP (deux minutes)

Claude Code stocke sa configuration MCP dans un fichier local par projet. Lancez claude mcp dans un dossier de travail :

cd ~/dev/cocorico-tiktok-histoire
claude mcp list

La sortie devrait être vide pour l'instant — aucun serveur déclaré. La commande claude mcp add ajoute des serveurs, et claude mcp remove les retire. Chaque serveur est identifié par un nom court (choisi par vous), une URL ou commande de lancement, et un transport (http, stdio ou sse).

Les serveurs MCP sont locaux ou distants. Un serveur local tourne en sous-processus sur votre machine, lancé par Claude au démarrage (utile pour le filesystem, GitHub local, Notion). Un serveur distant vit sur internet et expose une URL HTTP que Claude appelle (utile pour Shortflow, Linear, Slack — toute API SaaS qui parle MCP).

Cette distinction matérielle a une conséquence pratique : les serveurs locaux exigent que leur binaire soit installé sur votre machine, les serveurs distants nécessitent une clé API à mettre dans le header d'authentification. Aucun n'est plus puissant que l'autre ; les deux modèles cohabitent.

Étape 3 — Connecter le serveur filesystem (deux minutes)

C'est l'aller-retour le plus simple, et celui qui produit le déclic le plus immédiat. Le serveur MCP filesystem permet à Claude de lire et écrire dans un dossier que vous lui désignez.

Installation :

claude mcp add filesystem --scope local \
  "npx @modelcontextprotocol/server-filesystem ~/dev/cocorico-tiktok-histoire"

L'argument après le nom du binaire est le dossier racine autorisé. Claude pourra lire et modifier tout fichier sous ce répertoire, et rien en dehors. C'est un sandbox volontaire — pas une limite technique.

Test immédiat :

claude

Dans Claude Code, tapez :

Liste les fichiers MDX dans episodes/. Ouvre le plus récent et résume-moi son contenu en trois phrases.

Si tout fonctionne, Claude appelle read_directory et read_file via MCP, vous obtenez la liste et le résumé. Le serveur filesystem est en marche. Cinq minutes écoulées.

Étape 4 — Connecter le serveur Shortflow (trois minutes)

L'opération principale du guide. Le serveur MCP Shortflow expose les outils de publication multi-plateforme : list_accounts, prepare_upload, finalize_upload, create_publication, approve_publication, get_publication_status, get_post_metrics.

Première étape — récupérer une clé API. Connectez-vous à votre dashboard Shortflow, allez dans Settings → API keys, créez une nouvelle clé. Format : sk_live_ suivi de 32 caractères. Copiez-la immédiatement — elle n'est affichée qu'une fois.

Deuxième étape — déclarer le serveur dans Claude Code :

claude mcp add shortflow https://api.shortflow.leandre.io/mcp \
  --transport http \
  --scope local \
  --header "Authorization: Bearer sk_live_votre_clé"

Quatre arguments : le nom (shortflow), l'URL (https://api.shortflow.leandre.io/mcp), le transport (http), et le header d'authentification avec la clé. La commande prend deux secondes, l'écho confirme que le serveur est déclaré.

Test :

claude

Dans Claude Code :

Liste les comptes sociaux connectés à mon workspace Shortflow.

Réponse type :

6 comptes connectés :

- YouTube · @yom-akakpo · ACTIVE
- TikTok · @whyfactory · ACTIVE
- Instagram · @yom.akakpo · ACTIVE
- Facebook · WhyFactory Page · ACTIVE
- Threads · @yom.akakpo · ACTIVE
- LinkedIn · Yom Akakpo · ACTIVE

À ce stade, Claude voit votre infrastructure de publication. Vous pouvez fermer le terminal et déconnecter le wifi — la config persiste. Sept minutes écoulées.

Étape 5 — Connecter GitHub (trois minutes, optionnel mais recommandé)

Si vous versionnez vos scripts dans un repo Git (ce que je recommande chaudement), le serveur MCP GitHub vous fait gagner beaucoup. Il permet à Claude d'ouvrir des branches, commiter, créer des pull requests, lire des issues.

Installation :

claude mcp add github \
  --scope local \
  --env GITHUB_TOKEN=ghp_votre_token \
  "npx @modelcontextprotocol/server-github"

Le token GitHub se génère dans les settings de votre compte GitHub (Settings → Developer settings → Personal access tokens), avec les scopes repo et read:user. Durée de vie recommandée : 90 jours, à rotation manuelle.

Test :

Dans le repo cocorico-tiktok-histoire, montre-moi les cinq dernières issues ouvertes.

Si Claude appelle correctement l'API GitHub via MCP, vous récupérez la liste sans avoir à ouvrir le navigateur. Dix minutes écoulées.

Étape 6 — Le test de bout en bout (trois minutes)

C'est le moment où vous validez que les serveurs jouent ensemble. La conversation qui suit utilise les trois serveurs précédents en chaîne et reproduit, en miniature, une journée typique de publication.

Tapez exactement ceci dans Claude Code :

  1. Lis le script local episodes/ep10-source.mdx et résume-moi son sujet.
  2. Vérifie qu'aucun épisode déjà publié sur Shortflow ne couvre exactement ce sujet (cherche par titre et description).
  3. Si c'est bien neuf, propose-moi trois variantes de hook que tu pourrais utiliser pour l'ouverture de la vidéo, et explique le mécanisme de chacune.

Claude va, en séquence :

  1. Appeler read_file sur le serveur filesystem, lire votre script local.
  2. Appeler list_publications sur le serveur Shortflow, filtrer par mots-clés tirés du script local.
  3. Synthétiser les deux informations et générer trois hooks calibrés.

Si tout fonctionne, vous obtenez en quinze à vingt secondes une réponse qui combine la lecture locale, la requête distante et l'analyse éditoriale. Sans avoir écrit le moindre script glue.

C'est le déclic que je vous mentionnais en intro. Une fois que vous avez vu ça tourner, le retour à un workflow pré-MCP devient impossible.

L'erreur classique qui coûte cher au début

Une erreur que j'ai commise et que je vois répétée : déclarer les serveurs MCP en scope global (avec --scope global au lieu de local). C'est tentant parce que ça veut dire que vous configurez une fois et tous vos projets héritent. C'est aussi une erreur de sécurité.

Le scope global place les credentials dans un fichier accessible depuis tout projet Claude Code que vous lancez. Si vous travaillez occasionnellement sur du code partagé (un repo open-source, un repo client, n'importe quoi qui n'est pas strictement à vous), Claude peut potentiellement utiliser ces credentials dans le contexte d'un projet qui n'est pas censé y avoir accès.

La règle pratique : scope local par défaut, scope global jamais sauf raison explicite. Vous taperez la commande d'ajout dix fois par an au lieu d'une — c'est largement supportable, et ça vous épargne le risque d'exfiltration silencieuse.

Le tableau récap des cinq étapes

| Étape | Action | Durée | |---|---|---| | 1 | Installer Claude Code et s'authentifier | 2 min | | 2 | Comprendre la config MCP locale vs distante | 2 min | | 3 | Connecter le serveur filesystem | 2 min | | 4 | Connecter le serveur Shortflow | 3 min | | 5 | Connecter le serveur GitHub (optionnel) | 3 min | | 6 | Test de bout en bout | 3 min | | Total | | 15 min |

Trois minutes de marge pour les inévitables imprévus (un mauvais token, un dossier inexistant, une variable d'environnement à recharger). En pratique, je l'ai chronométré à 14 minutes 22 — vous serez dans la même fourchette.

Ce que vous pouvez tenter ensuite

Une fois les bases en place, voici trois moves naturels pour étendre votre configuration :

Serveur Notion, si vous gérez votre backlog éditorial là-bas. Permet à Claude de lire et écrire dans vos databases Notion sans intervention manuelle.

Serveur Linear ou Jira, si vous suivez vos chaînes comme des projets avec issues et milestones. L'arborescence d'issues devient une ressource directement consultable.

Serveur custom autour de votre orchestrateur Python. C'est le move avancé. Si vous avez écrit un script Python pour générer vos épisodes (comme mon generate.py), envelopper ses commandes dans un serveur MCP rend chaque opération du pipeline appelable depuis Claude. Vous passez de « Claude lit mes scripts » à « Claude génère un épisode en autonomie ».

Le serveur MCP custom est documenté dans la spec officielle du protocole sur modelcontextprotocol.io. Un serveur basique tient en cinquante lignes de Python.

Pour démarrer Shortflow sans avoir à configurer le serveur MCP en amont, créer un compte ouvre un essai gratuit de sept jours avec MCP activé par défaut et une clé API pré-générée. La séquence ci-dessus tourne dès la première connexion.