Automatisation
CLI et serveur MCP DraftToDone : générer des livres depuis le terminal ou un agent
Référence de l'outil en ligne de commande et du serveur Model Context Protocol de DraftToDone : installer, s'authentifier, créer un livre, suivre la progression et télécharger les quatre fichiers — depuis un terminal ou un agent IA.
CLI et serveur MCP DraftToDone
Automatisation
Si vous préférez vivre dans un terminal plutôt qu'un tableau de bord — ou si vous êtes un agent IA avec un shell — DraftToDone fournit un outil en ligne de commande et un serveur Model Context Protocol qui exposent tout le pipeline de livres. Même compte, mêmes crédits, mêmes quatre livrables (manuscrit Word, PDF intérieur, image de couverture, PDF de couverture KDP) ; aucun navigateur requis sauf pour payer.
Ceci est une référence pratique. Elle couvre l'installation et l'authentification du CLI, l'ensemble des commandes, les outils MCP équivalents, et la boucle exacte de la niche aux fichiers téléchargés. Copiez les commandes, ajustez la niche, et vous avez un générateur reproductible que vous pouvez scripter ou confier à un agent.
Tout ici parle au même backend que l'application web, donc rien de ce que vous faites au terminal n'est de seconde classe. Le CLI est un client léger sur le serveur MCP, et le serveur MCP est une fine couche sur le même pipeline de génération qui alimente le tableau de bord.
Installer et authentifier le CLI
La voie la plus rapide est npx, qui ne nécessite que Node 18 ou plus récent : lancez « npx drafttodone help » pour voir toutes les commandes. Si vous préférez ne pas utiliser npm du tout, téléchargez le fichier unique directement — « curl -fsSL https://app.drafttodone.io/cli.mjs -o drafttodone.mjs » — et lancez-le avec « node drafttodone.mjs help ». Zéro dépendance dans les deux cas.
Authentifiez-vous une fois : « npx drafttodone signup --email [email protected] --password "min8car" » crée le compte et stocke un jeton de session dans ~/.drafttodone.json. Les utilisateurs de retour lancent « login » avec les mêmes drapeaux. Vous pouvez aussi passer les identifiants via les variables d'environnement DRAFTTODONE_EMAIL et DRAFTTODONE_PASSWORD, pratique dans un job CI ou le bac à sable d'un agent.
Chaque commande accepte --json, qui échange la sortie lisible par un humain contre un objet analysable par machine. Les agents devraient toujours passer --json ; les humains peuvent l'omettre pour des tableaux lisibles. Le jeton stocké peut être remplacé par invocation avec la variable d'environnement DRAFTTODONE_TOKEN si vous jonglez avec plusieurs comptes.
- npx drafttodone help — nécessite Node 18+, zéro dépendance.
- Option sans npm : curl le fichier cli.mjs unique et lancez-le avec node.
- signup/login stockent un jeton de session dans ~/.drafttodone.json.
- --json pour la sortie machine ; variables d'env pour identifiants et jeton.
L'ensemble des commandes
Les commandes principales correspondent une à une au workflow. « status » affiche vos crédits, votre abonnement et votre éligibilité au crédit de partage. « checkout --plan weekly » (ou yearly) affiche une URL Stripe que vous ouvrez dans un navigateur pour payer. « create --niche "..." --lang fr » démarre un livre et renvoie son identifiant ; ajoutez --random pour laisser DraftToDone choisir une niche surprise.
« books » liste vos livres avec statut et compteur de progression. « wait <book-id> » bloque et interroge jusqu'à ce que ce livre soit terminé, en affichant le statut au fil de l'eau — idéal dans un script qui ne doit pas avancer avant que les fichiers existent. « download <book-id> --out ./dossier » récupère les quatre livrables dans un dossier.
Une commande supplémentaire boucle sur le crédit gratuit : « share-claim <url-post-x> » échange un post X public qui mentionne drafttodone.io contre un crédit bonus, une fois par semaine, après avoir un livre terminé. Lancez « help » à tout moment pour la liste complète avec les options.
- status, checkout --plan, create --niche/--random/--lang.
- books (liste + progression), wait <id> (suivi bloquant), download <id> --out.
- share-claim <url-post-x> pour le crédit hebdomadaire gratuit.
- help liste toutes les commandes et drapeaux.
Le serveur MCP et ses outils
Pour les frameworks d'agents, la même fonctionnalité vit à l'endpoint MCP app.drafttodone.io/mcp — un serveur streamable-HTTP sans état, sans OAuth. Dans Claude Code, ajoutez-le avec « claude mcp add --transport http drafttodone https://app.drafttodone.io/mcp ». Dans Hermes Agent, OpenClaw ou tout hôte MCP, enregistrez un serveur distant pointant vers cette URL ; les outils sont découverts automatiquement.
Les huit outils reflètent le CLI : sign_up et log_in renvoient un session_token que tout autre outil prend en argument ; get_status, get_checkout_url, create_book, list_books, get_download_links et claim_share_reward font exactement ce que leur nom indique. Un manifeste de découverte se trouve à app.drafttodone.io/.well-known/mcp.json pour les agents qui sondent le chemin well-known.
Comme le CLI et le serveur MCP partagent un seul backend, vous pouvez développer contre le CLI de façon interactive et déployer le flux identique via MCP en production, ou l'inverse. Il n'y a aucune dérive de comportement à déboguer entre eux.
- Endpoint : app.drafttodone.io/mcp (streamable HTTP, sans état, sans OAuth).
- Claude Code : claude mcp add --transport http drafttodone <url>.
- Huit outils ; sign_up/log_in émettent le session_token requis par les autres.
- Manifeste à /.well-known/mcp.json ; comportement identique au CLI.
Le flux complet, du début à la fin
Une session terminal complète ressemble à ceci : « npx drafttodone signup --email [email protected] --password "min8car" », puis « npx drafttodone checkout --plan weekly » et payez l'URL affichée dans un navigateur. Confirmez l'arrivée des crédits avec « npx drafttodone status ».
Ensuite générez et récupérez : « npx drafttodone create --niche "yoga pour seniors débutants" --lang fr » renvoie un identifiant de livre ; « npx drafttodone wait <book-id> » bloque pendant les 30 à 45 minutes environ de génération côté serveur ; « npx drafttodone download <book-id> --out ./mon-livre » sauvegarde le manuscrit, le PDF intérieur, l'image de couverture et le PDF de couverture KDP.
À partir de là, c'est votre tour : relisez le manuscrit, ajustez ce que vous voulez, puis téléversez sur Amazon KDP avec la déclaration de contenu IA. Le CLI et le serveur MCP vous amènent vite à des fichiers prêts pour la production ; les décisions éditoriales et de publication restent les vôtres, ce qui est exactement leur place.
- signup → checkout (payer au navigateur) → status pour confirmer les crédits.
- create --niche → wait <id> → download <id> --out ./dossier.
- Quatre fichiers arrivent : manuscrit, PDF intérieur, couverture, PDF couverture KDP.
- Relisez et publiez sur KDP avec la déclaration IA — à vous de décider.
Checklist opérationnelle
- Node 18+ disponible, ou le fichier cli.mjs téléchargé.
- Authentifié avec signup/login ; jeton stocké ou défini via variable d'env.
- Crédits confirmés avec status après avoir payé l'URL de checkout.
- Livre créé avec une niche précise et une langue explicite.
- wait utilisé pour bloquer jusqu'à ce que le livre soit terminé (4/4).
- Les quatre fichiers téléchargés dans un dossier connu.
- Manuscrit relu avant téléversement sur KDP avec la déclaration IA.
FAQ
Ai-je besoin de npm pour utiliser le CLI DraftToDone ?
Non. « npx drafttodone » est la voie la plus simple si vous avez Node, mais vous pouvez aussi télécharger le fichier unique avec « curl -fsSL https://app.drafttodone.io/cli.mjs -o drafttodone.mjs » et le lancer avec « node drafttodone.mjs ». Il n'a aucune dépendance et ne nécessite que Node 18 ou plus récent.
Quelle est la différence entre le CLI et le serveur MCP ?
Ce sont deux façades sur le même backend. Le CLI est pour les terminaux et shells (avec un mode --json pour les scripts) ; le serveur MCP à app.drafttodone.io/mcp est pour les frameworks d'agents qui parlent Model Context Protocol. Comportement, règles et tarifs sont identiques, donc aucune dérive entre eux.
Comment ajouter le serveur MCP à Claude Code ?
Lancez « claude mcp add --transport http drafttodone https://app.drafttodone.io/mcp ». Pour Hermes Agent, OpenClaw ou un autre hôte MCP, enregistrez un serveur distant streamable-HTTP pointant vers la même URL ; les outils sont découverts automatiquement au démarrage.
Puis-je scripter la génération de livres en CI ?
Oui. Passez les identifiants via DRAFTTODONE_EMAIL et DRAFTTODONE_PASSWORD, ajoutez --json à chaque commande pour une sortie analysable, et utilisez « wait <book-id> » pour bloquer jusqu'à ce qu'un livre soit terminé avant de télécharger. Le paiement nécessite quand même un humain une fois pour financer le compte.
Où est stocké mon jeton de session ?
Dans ~/.drafttodone.json après signup ou login. Vous pouvez le remplacer par exécution avec la variable d'environnement DRAFTTODONE_TOKEN, utile quand un agent ou un job CI gère le jeton lui-même plutôt que de lire le fichier.