Brancher la génération vidéo à Claude Code par MCP tient en une commande. L'empêcher de dépenser plus que prévu demande cinq minutes de plus, et c'est la partie que la plupart des guides sautent. Celui-ci fait les deux : ajouter un serveur MCP hébergé, vérifier la connexion par un appel qui ne coûte rien, puis poser quatre limites : des règles de permission, un prix demandé avant chaque appel payant, un plafond de dépense sur la clé et un solde prépayé qui refuse ce qu'il ne peut pas couvrir.
Le serveur pris en exemple est celui d'Aitachyon, le studio que je fais tourner, parce que je sais exactement ce que ses outils renvoient. Tout ce qui concerne Claude Code lui-même (portées, règles de permission, limites de sortie) vient de la documentation actuelle d'Anthropic et vaut pour n'importe quel serveur hébergé.
Ce que vous branchez
Un serveur MCP hébergé, c'est une URL. La spécification MCP (révision 2026-07-28) fait de Streamable HTTP l'un de ses deux transports standard : chaque message est un POST HTTP vers un point d'entrée unique, et la réponse revient sous forme d'objet JSON ou de flux d'événements propre à cette requête. Rien ne tourne sur votre machine.
Le serveur expose des outils, que le client liste avec tools/list et exécute avec tools/call, Claude remplissant les arguments à partir de votre demande. Le chapitre Tools de la spécification demande qu'il y ait toujours un humain dans la boucle, capable de refuser un appel d'outil, et que le client montre les paramètres avant d'appeler le serveur. Dans Claude Code, cet humain, c'est vous, à travers les demandes de permission et les règles. Pour un outil qui dépense de l'argent à chaque appel, cette étape compte.
Étape 1 : créer une clé plafonnée
Sur le serveur d'exemple, la clé se crée dans l'application, rubrique API & MCP. Elle ressemble à ait_…, ne s'affiche qu'une fois et sert aussi bien au serveur MCP qu'à l'API HTTP. Le compte est prépayé à partir de 10 $, sans abonnement.
Créez une clé par agent ou par projet, avec un plafond de dépense par jour ou par mois. Un appel qui dépasserait le plafond est refusé, et chaque clé affiche ce qu'elle a dépensé (guide d'installation et FAQ du serveur MCP). Un plafond de 10 $ par jour, par exemple, laisse passer un lot de dix clips Kling v3 de 5 secondes, soit 10 × 5 s × 0,168 $ = 8,40 $ au tarif sans son du 1er novembre 2026, et arrête la boucle qui voudrait relancer le lot.
Étape 2 : ajouter le serveur et choisir sa portée
La commande, avec votre clé à la place du marqueur :
claude mcp add --transport http aitachyon https://aitachyon.com/api/mcp \
--header "Authorization: Bearer ait_your_token"
Elle suit la forme générale donnée par la documentation MCP de Claude Code : claude mcp add --transport http <name> <url>, avec --header pour un serveur qui prend une clé fixe. La commande enregistre la configuration sans vérifier l'identifiant : une faute de frappe ne se verra qu'au moment de la connexion. L'option -s ou --scope décide où l'entrée est rangée :
- local, par défaut : ce projet seulement, dans
~/.claude.json, visible de vous seul.
- project : écrite dans
.mcp.json à la racine du projet, faite pour être versionnée. Claude Code demande une approbation avant d'utiliser un serveur de portée projet en session interactive.
- user : tous les projets de votre machine, toujours dans
~/.claude.json.
Une clé écrite en clair va en portée local ou user. Pour partager le serveur via .mcp.json, écrivez l'en-tête Bearer ${AITACHYON_KEY} et laissez chacun définir la variable : Claude Code remplace ${VAR} dans l'URL et les en-têtes d'un serveur distant. Seule exception, une liste fixe de variables d'identifiants (celles de Claude Code comme ANTHROPIC_API_KEY, celles de votre fournisseur cloud, et d'autres comme NPM_TOKEN) y sont lues comme vides, pour qu'un dépôt ne puisse pas les envoyer au serveur qu'il désigne. Une variable au nom de votre choix est remplacée normalement.
Étape 3 : vérifier la connexion par un appel gratuit
Dans le terminal, claude mcp list affiche chaque serveur avec son état (connecté, authentification requise, échec de connexion), et claude mcp get aitachyon donne le détail de l'échec sur une ligne Issue. En session, /mcp indique combien d'outils expose chaque serveur. Posez ensuite une question qui ne coûte rien :
Quel est mon solde Aitachyon, et quels projets ai-je ?
Cette demande appelle get_me, un outil gratuit. Il répond avec le solde (en dollars sur un compte prépayé, en crédits sur un forfait), le forfait, vos projets avec leur identifiant (la plupart des outils de génération exigent un projectId) et la grille des coûts. Une erreur 401 signifie que la clé manque, est mal recopiée ou a été révoquée : vérifiez que l'en-tête est bien Authorization: Bearer ait_…, ou créez une nouvelle clé et ajoutez de nouveau le serveur.
Étape 4 : écrire des règles de permission pour les outils payants
Dans son mode par défaut, Claude Code demande l'autorisation à la première utilisation de chaque outil. Un outil de génération approuvé une fois puis oublié, c'est ainsi qu'une session rend plus que prévu. Écrivez donc les règles vous-même, dans .claude/settings.json pour un projet ou ~/.claude/settings.json pour tous. La documentation des permissions donne la syntaxe : mcp__aitachyon__* couvre tous les outils du serveur, mcp__aitachyon__generate_scene un seul. Les règles sont évaluées dans cet ordre : deny, puis ask, puis allow, et la première qui correspond l'emporte, quelle que soit sa précision.
Cet ordre dicte le réglage. Une règle ask sur tout le serveur ferait aussi demander l'autorisation pour les outils gratuits, puisqu'un ask l'emporte sur un allow. Autorisez donc les outils gratuits par leur nom et placez les outils coûteux sous ask :
{
"permissions": {
"allow": [
"mcp__aitachyon__get_me",
"mcp__aitachyon__models_explore",
"mcp__aitachyon__job_status",
"mcp__aitachyon__transactions"
],
"ask": [
"mcp__aitachyon__generate_scene",
"mcp__aitachyon__video_*",
"mcp__aitachyon__avatar_generate"
]
}
}
Les règles ask et deny acceptent un joker dans le nom d'outil : mcp__aitachyon__video_* couvre l'upscale, le recadrage, le lipsync, le doublage, le motion control et le détourage. Les règles allow n'acceptent un joker qu'après le préfixe littéral mcp__<server>__, et un allow mcp__* sans serveur est ignoré. Une image coûte quelques centimes, je laisse donc images_generate à la demande par défaut. Dans un dépôt où personne ne doit générer de média, un deny sur mcp__aitachyon__* retire les outils du serveur, et mcp__* tous les outils MCP.
Un piège : un fichier de réglages ne peut pas filtrer sur un paramètre d'outil MCP. Au chargement, Claude Code ignore toute règle mcp__ écrite avec des parenthèses et la signale dans la fenêtre des réglages invalides et dans claude doctor. Une règle sur un paramètre ne fonctionne qu'en deny passé en ligne de commande, par exemple claude --disallowedTools "mcp__aitachyon__generate_scene(resolution:1080p)" pour une session qui ne doit jamais rendre en 1080p. Au 1er novembre 2026, un clip Seedance 2.5 de 10 secondes coûte 11,37 $ en 1080p contre 4,62 $ en 720p.
Étape 5 : demander le prix avant un appel payant
Chaque outil payant du serveur d'exemple accepte getCost: true : il renvoie le prix estimé et ne lance rien. Il suffit de le demander en clair, comme dans cette consigne tirée du guide d'installation :
Fais un clip Seedance 2.5 de 5 secondes en 720p de notre produit sur un plan de travail de cuisine, en 16:9. Donne-moi le prix avant de le lancer.
L'estimation est exprimée en crédits, l'unité de la grille des outils ; sur un compte prépayé, une ligne précise que le travail est facturé en dollars, au tarif par seconde affiché sur la page du modèle. Au 1er novembre 2026, c'est 0,4624 $ la seconde en 720p, soit 5 × 0,4624 $ = 2,31 $ pour ce clip. C'est une estimation : le montant exact revient avec le résultat. Avec les règles ask ci-dessus, vous approuvez l'estimation, puis l'appel réel, et c'est à la seconde demande que vous comparez.
Pour en faire une habitude, ajoutez une ligne au CLAUDE.md du projet : « Avant tout appel Aitachyon payant, lance-le d'abord avec getCost et demande-moi si un lot dépasse 5 dollars. »
Ce que renvoie un appel
La spécification Tools autorise un résultat à contenir du texte, des images, de l'audio, des liens vers des ressources ou des ressources intégrées, plus un contenu structuré facultatif, et une erreur que le modèle peut corriger revient dans le résultat avec isError: true. Le serveur d'exemple répond en texte avec des liens, pas avec les fichiers eux-mêmes : images_generate renvoie l'URL de l'image et son identifiant, generate_scene l'URL du mp4 avec le mode, la présence de son et le montant facturé.
Les liens comptent, car Claude Code avertit quand le résultat d'un outil MCP dépasse 10 000 tokens et le plafonne à 25 000 par défaut (la variable MAX_MCP_OUTPUT_TOKENS change ce plafond) ; un résultat texte plus long est enregistré dans un fichier et remplacé par son chemin. Une vidéo envoyée en base64 ne passerait jamais.
Un rendu encore en cours au bout de 45 secondes environ revient avec le statut « rendering » et un chemin de suivi, que Claude Code interroge avec l'outil gratuit job_status pendant que le rendu continue. Quand le solde ne peut pas payer, l'appel est refusé avant de partir, et l'outil demande à l'agent de ne pas réessayer ni basculer en douce vers un modèle moins cher, mais de lire le solde avec get_me et de vous signaler ce qui manque. Un travail échoué est remboursé au centime, et l'outil gratuit transactions montre chaque remboursement relié à son travail.
Le brancher depuis claude.ai ou ChatGPT
La spécification d'autorisation MCP est facultative ; quand un serveur l'utilise, elle repose sur OAuth 2.1, avec le jeton dans l'en-tête Authorization à chaque requête et jamais dans l'URL. Depuis le 10 novembre 2026, le serveur d'exemple propose une connexion OAuth 2.1 en plus de la clé fixe : les connecteurs de claude.ai et de ChatGPT peuvent donc se brancher sur https://aitachyon.com/api/mcp, comme Claude Code, Cursor et Claude Desktop.
- Sur claude.ai : Paramètres, Connecteurs, Ajouter un connecteur personnalisé, avec l'URL https://aitachyon.com/api/mcp. Sur ChatGPT : Paramètres, Apps et connecteurs, activez le mode développeur, puis créez un connecteur avec cette URL et l'authentification OAuth.
- Cliquez sur Connecter, connectez-vous à votre compte Aitachyon dans la fenêtre qui s'ouvre, puis autorisez l'accès.
- Dans une conversation, activez le connecteur et demandez votre solde : l'outil gratuit get_me répond.
Les tarifs modèle par modèle et le calcul de lots entiers sont dans le prix des API de génération vidéo, et la comparaison entre paiement à l'appel et crédits dans crédits IA ou paiement à l'appel.