Kling 3.0 MCP : utiliser Kling dans Claude, Codex et le CLI

Un regard honnête sur Kling 3.0 MCP : quels serveurs existent réellement, comment en enregistrer un dans Claude Code et Codex CLI, en quoi les trois modèles Kling v3 diffèrent, et comment lancer des lots sans interface avec des prompts multi-plans, des images de référence et le contrôle du mouvement.

Kling 3.0 MCP : utiliser Kling dans Claude, Codex et le CLI
Cristian Da Conceicao
Fondateur de Picasso IA

Vous tapez une phrase dans un terminal, et quelques minutes plus tard un MP4 apparaît dans votre dossier de projet. C’est l’image que se font la plupart des gens lorsqu’ils recherchent Kling 3.0 MCP, et une partie de cette promesse fonctionne déjà. Une autre partie demande une mise en garde honnête, car l’expression regroupe trois choses distinctes : les modèles vidéo Kling v3, le Model Context Protocol, et les agents de code (Claude Code et Codex CLI) qui appellent des outils par son intermédiaire.

Cet article les sépare. Vous verrez ce que fait chaque modèle Kling v3, comment enregistrer un serveur MCP dans Claude Code et dans Codex, comment lancer les mêmes prompts depuis un shell sans interface, et comment écrire des prompts qui passent dès la première ou la deuxième tentative. Lorsque je n’ai pas pu vérifier un point, je le dis au lieu de deviner.

Ce que Kling 3.0 MCP signifie réellement

Le MCP en termes simples

Le Model Context Protocol est une manière standard pour un client d’IA d’appeler des outils externes. Un client comme Claude Code ou Codex CLI démarre ou se connecte à un serveur MCP, demande quels outils il propose, puis les appelle pendant son travail. Un serveur vidéo expose généralement des outils du type « créer une vidéo », « vérifier l’état d’une tâche » et « récupérer le fichier ».

Il existe deux variantes de serveurs. Un serveur stdio est un programme local : le client lance une commande (souvent npx ou uvx) et communique avec elle par l’entrée et la sortie standard. Un serveur HTTP est distant et demande en général un jeton d’accès (bearer token). Dans les deux cas, la configuration suit le même esprit : un nom, une commande ou une URL, et les variables d’environnement dont le serveur a besoin.

Ce qui existe aujourd’hui

Voici la situation telle que je l’ai vérifiée en rédigeant cet article :

  • Aucun serveur officiel de Kling. Je n’ai trouvé aucun serveur MCP publié par Kling lui-même.
  • Un serveur tiers. Les annuaires publics listent mcp-kling, présenté comme un serveur MCP pour la génération de vidéos Kling AI. La fiche indique qu’il se lance avec uvx mcp-kling et lit une variable ACEDATACLOUD_API_TOKEN. Lisez son README pour connaître les versions de Kling qu’il prend en charge avant de vous appuyer dessus.
  • Le connecteur PicassoIA. Il expose quatre modèles : deux pour les images et deux pour la vidéo, PicassoIA Video et Seedance 2.5 Lite. Kling v3 ne figure pas dans cette liste, vous le lancez donc depuis sa page de modèle.

Mettre les trois pistes côte à côte rend les compromis plus faciles à voir :

PisteConfigurationAccès à Kling v3Idéal pour
mcp-kling tiersCommande uvx et jeton d’APIDépend du serveur, vérifiez son READMELancements scriptés depuis un terminal
Connecteur PicassoIAAjout du connecteur dans votre clientAbsent de la liste des quatre modèlesTravail rapide sur images et vidéos depuis un chat
Page de modèle PicassoIAUn navigateur et un compteLes trois modèles Kling v3Test de prompts et rendus finaux

💡 Tip: Considérez chaque serveur MCP comme du code qui s’exécute sur votre machine. Lisez le dépôt, épinglez une version et conservez les jetons dans des variables d’environnement, jamais dans un prompt.

Vue en contre-plongée d’un terminal d’ordinateur portable et d’une tasse de café sur un bureau en bois le matin

Les trois modèles Kling v3

Kling v3 n’est pas un seul modèle sur PicassoIA mais trois, et bien choisir le bon évite la plupart des générations inutiles.

ModèleIdéal pourEntrées principalesSortie
Kling v3 VideoTexte vers vidéo, contrôle de la première et de la dernière imagePrompt, image de début, image de fin, script multi-plansJusqu’à 15 s, 720p ou 1080p
Kling v3 Omni VideoPersonnages cohérents, retouche d’un clip existantJusqu’à 7 images de référence, vidéo de référenceDe 3 à 15 s, 720p ou 1080p
Kling v3 Motion ControlFaire répéter à un personnage immobile un mouvement réelUne image plus une vidéoJusqu’à 10 s ou 30 s, 720p ou 1080p

Vue large d’un petit bureau de production vidéo avec une timeline de montage sur un écran

Kling v3 Video

Kling v3 Video est le choix par défaut. Il transforme un prompt en clip de 15 secondes maximum, en mode standard (720p) ou pro (1080p). Le prompt peut atteindre 2 500 caractères, et le prompt négatif a la même limite. Vous pouvez fixer la première image avec start_image et la dernière avec end_image, ou écrire un script de six plans maximum avec multi_prompt. L’audio natif est désactivé par défaut et s’active avec generate_audio.

Kling v3 Omni Video

Kling v3 Omni Video ajoute des références. Joignez jusqu’à sept images de référence (quatre lorsqu’une vidéo de référence est présente) pour figer l’apparence d’un personnage, d’un objet ou d’un lieu, puis appelez-les dans le prompt avec des marqueurs tels que <<<image_1>>>. Une vidéo de référence de 3 à 10 secondes fonctionne de deux façons : feature reprend le style et le mouvement de caméra, tandis que base modifie un clip existant à partir de votre description écrite.

Kling v3 Motion Control

Kling v3 Motion Control prend une image fixe d’un personnage et une vidéo de référence, puis fait répéter au personnage le mouvement. Réglez character_orientation sur image pour des clips de 10 secondes maximum qui conservent la pose de votre image, ou sur video pour des clips de 30 secondes maximum qui suivent la personne dans la séquence. Les vidéos de référence peuvent être au format MP4 ou MOV, jusqu’à 100 Mo, et keep_original_sound détermine si leur audio est conservé.

Connecter Kling à Claude Code

Claude Code enregistre les serveurs avec claude mcp add. Tout ce qui suit le double tiret est la commande qui démarre le serveur.

Ajouter le serveur

claude mcp add kling --env ACEDATACLOUD_API_TOKEN=$ACEDATACLOUD_API_TOKEN -- uvx mcp-kling

Développer la variable dans votre shell évite que le secret n’apparaisse dans la commande que vous collez dans un chat ou une capture d’écran. Les noms de l’option et de la variable proviennent de la fiche de l’annuaire : vérifiez-les dans le README du serveur.

Vue rapprochée de mains tapant sur un ordinateur portable avec un terminal sombre à l’écran

Vérifier la connexion

Lancez claude mcp list pour voir tous les serveurs et leur état, ou tapez /mcp dans une session. Si Kling apparaît en échec, exécutez à la main, dans un terminal simple, la commande située après le double tiret. La plupart des échecs viennent d’une installation manquante de uvx ou d’un mauvais jeton.

Pour partager la configuration avec une équipe, ajoutez --scope project. Claude Code écrit un fichier .mcp.json à la racine du dépôt, et vous pouvez référencer le jeton sous la forme ${ACEDATACLOUD_API_TOKEN} afin que le secret ne soit jamais versionné.

Une fois le serveur opérationnel, demandez un clip en langage courant :

Utilisez l’outil Kling pour créer un clip de 5 secondes, au format 16:9 : un bateau de pêche quittant un port brumeux à l’aube, travelling avant lent, bourdonnement sourd du moteur. Interrogez l’état jusqu’à la fin, puis donnez-moi l’URL du fichier.

Connecter Kling à Codex CLI

Codex CLI conserve ses réglages MCP dans ~/.codex/config.toml. Vous pouvez modifier ce fichier ou laisser une commande l’écrire à votre place.

Configuration en une commande

codex mcp add kling --env ACEDATACLOUD_API_TOKEN=$ACEDATACLOUD_API_TOKEN -- uvx mcp-kling
codex mcp list

La syntaxe reprend celle de Claude Code : un nom, des paires --env facultatives, un double tiret, puis la commande de lancement. codex mcp list confirme que le serveur a bien été enregistré.

Modifier config.toml à la main

Chaque serveur est une table [mcp_servers.<name>] :

[mcp_servers.kling]
command = "uvx"
args = ["mcp-kling"]
env_vars = ["ACEDATACLOUD_API_TOKEN"]

Ici, env_vars désigne une variable à transmettre depuis votre shell. Si vous préférez stocker une valeur, utilisez plutôt une table [mcp_servers.kling.env], et gardez ce fichier hors du contrôle de version. Un fichier .codex/config.toml local au projet fonctionne aussi, pour les projets que vous avez marqués comme fiables. Les serveurs distants utilisent url et bearer_token_env_var à la place de command.

Vue par-dessus l’épaule d’un développeur lisant la sortie d’une commande sur un grand écran

Lancer Kling depuis la ligne de commande

Les deux agents sont des outils en ligne de commande : la même configuration fonctionne donc sans fenêtre de chat. C’est important lorsque vous voulez vingt clips pendant la nuit plutôt qu’un seul à l’heure du déjeuner. L’agent est aussi plus qu’un simple lanceur. Il peut transformer un script brut en liste de plans, vérifier que les durées s’additionnent, relancer une tâche échouée et nommer chaque fichier de sortie d’après son prompt.

TâcheClaude CodeCodex CLI
Ajouter un serveurclaude mcp addcodex mcp add
Lister les serveursclaude mcp listcodex mcp list
Lancer un planclaude -p "..."codex exec "..."
Emplacement de la configuration.mcp.json ou configuration utilisateur~/.codex/config.toml

Exécutions sans interface

Une exécution sans interface envoie une seule instruction puis se termine. Pré-approuvez les outils Kling, sinon l’appel d’outil est refusé puisque personne n’est là pour l’approuver :

claude -p "Read prompts/harbor.txt, make a 5 second Kling clip from it, wait until it finishes, and print the URL" --allowedTools "mcp__kling"
codex exec "Read prompts/harbor.txt, make a 5 second Kling clip from it, wait until it finishes, and print the URL"

La génération est lente, prévoyez-le. Les exemples d’exécution présentés sur la page Kling v3 Video ont pris environ 5 à 18 minutes chacun, et les exemples Omni entre 2 et 10 minutes environ. Lancez les clips les uns après les autres et journalisez la sortie au lieu de la surveiller.

Ordinateur portable et tasse en céramique sur une table de cuisine en bois à l’aube

Conserver les prompts dans des fichiers

Placez chaque prompt dans son propre fichier texte et bouclez sur le dossier :

mkdir -p out
for f in prompts/*.txt; do
  claude -p "Make a Kling clip from $f and save the result URL to out/$(basename "$f" .txt).url" --allowedTools "mcp__kling"
done

Les fichiers vous donnent un historique, une relecture et une réutilisation. Une liste de plans pour un clip multi-plans n’est qu’un petit fichier JSON à côté du prompt, et un diff montre exactement ce qui a changé entre deux prises.

Vue de dessus d’un bureau avec un ordinateur portable et un carnet de storyboard dessiné à la main

Écrire des prompts que Kling v3 suit

Un bon prompt Kling se lit comme la description d’un plan, pas comme un souhait. Nommez le sujet, l’action, le mouvement de caméra, la lumière et, si l’audio est activé, le son. Une seule idée par plan vaut mieux que cinq idées entassées dans un même plan.

Scripts multi-plans

Kling v3 Video comme Kling v3 Omni Video acceptent un tableau multi_prompt. Chaque plan reçoit son propre prompt et sa propre durée :

[
  {"prompt": "Wide shot of a fishing boat leaving a foggy harbor at dawn", "duration": 5},
  {"prompt": "Close-up of the captain's weathered hands on the wheel", "duration": 5},
  {"prompt": "Aerial shot of the boat heading into open water", "duration": 5}
]

Vous obtenez six plans au maximum, chacun durant au moins une seconde, et les durées doivent correspondre à la durée totale duration du clip. Les trois plans ci-dessus totalisent 15 secondes, donc la durée totale est fixée à 15.

Deux collègues épinglant des cartes de storyboard sur un mur blanc

Séquence de référence et mouvement

Pour Kling v3 Motion Control, la vidéo de référence fait l’essentiel du travail. Filmez un court extrait avec votre téléphone, où le corps entier reste dans le cadre, la caméra reste immobile et le mouvement est net. Associez-le ensuite à une image fixe cadrée de manière similaire. Un portrait en gros plan et une marche en pied se marient rarement.

Un jeune homme filmant une séquence de référence avec une caméra sur trépied sur une terrasse de toit

3 erreurs courantes

  1. Des durées qui ne s’additionnent pas. La page du modèle indique que le total des plans doit égaler duration, donc des plans totalisant 12 secondes face à une duration de 15 rendent la requête invalide. Faites le calcul avant d’envoyer.
  2. Définir un format avec une image de début. Sur Kling v3 Video, le format est ignoré dès que vous fournissez start_image, car le clip suit l’image.
  3. Audio et vidéo de référence ensemble. Sur Kling v3 Omni Video, generate_audio ne peut pas être combiné avec une vidéo de référence. Utilisez plutôt keep_original_sound pour la séquence.

💡 Tip: Testez d’abord chaque idée en mode standard. Il rend en 720p, donc un prompt faible vous coûte une courte attente au lieu d’une exécution en mode pro. Passez en pro pour la prise que vous comptez publier.

Utiliser Kling v3 sur PicassoIA

Si vous préférez éviter la configuration du serveur, la page du modèle fait tourner le même moteur avec des champs de formulaire plutôt que des options en ligne de commande. Voici le parcours pour Kling v3 Video :

  1. Ouvrez la page du modèle et connectez-vous à votre compte.
  2. Choisissez le mode. Standard donne du 720p pour les brouillons, pro donne du 1080p pour la prise finale.
  3. Rédigez le prompt. Restez sous 2 500 caractères et suivez l’ordre sujet, action, caméra, lumière et son.
  4. Réglez la durée et le format. Choisissez 16:9, 9:16 ou 1:1, et une durée allant jusqu’à 15 secondes.
  5. Ajoutez des images si nécessaire. Importez une image de début, et une image de fin si vous voulez figer la dernière image.
  6. Collez une liste de plans dans le champ multi-plans lorsque vous voulez des scènes séparées.
  7. Activez Generate Audio pour l’ambiance sonore, et ajoutez un prompt négatif pour tout ce que vous voulez écarter.
  8. Générez et téléchargez le MP4 lorsque le statut passe à terminé.
RéglageValeursQuand le modifier
Modestandard (720p), pro (1080p)Brouillon en standard, publication en pro
DuréeJusqu’à 15 sPlus courte pour les tests, plus longue pour la version finale
Format16:9, 9:16, 1:1Adaptez-le à la plateforme de publication
Générer l’audioActivé ou désactivé, désactivé par défautÀ activer pour l’ambiance et les effets
Prompt négatifJusqu’à 2 500 caractèresPour supprimer le texte, le scintillement ou les membres en trop

Vue rapprochée d’un poste de montage vidéo avec une image figée d’un randonneur sur une crête

Réaliser votre premier clip Kling v3

Choisissez une petite idée et lancez-la aujourd’hui. Écrivez un script de trois plans de cinq secondes chacun, envoyez-le à Kling v3 Video en mode standard, lisez le résultat, corrigez le plan le plus faible, et seulement ensuite payez le mode pro. Si vous avez une image de personnage et une courte séquence filmée avec votre téléphone, essayez ensuite Kling v3 Motion Control, et utilisez plutôt Kling v3 Omni Video lorsque le même personnage doit apparaître dans plusieurs plans.

Vous voulez rester dans Claude Code ou Codex ? Le connecteur PicassoIA inclut déjà PicassoIA Video et Seedance 2.5 Lite, vous pouvez donc générer des clips depuis le terminal dès aujourd’hui et garder Kling v3 pour les plans qui nécessitent son contrôle multi-plans.

Tenez un court fichier de notes au fil de l’eau. À côté de chaque prompt, notez le mode, la durée et une phrase sur ce qui a fonctionné. Après dix clips, vous disposerez d’une bibliothèque de prompts personnelle qu’aucun gabarit ne peut égaler, et elle s’intègre directement au dossier de prompts du flux de travail en ligne de commande décrit plus haut.

Ouvrez Picasso IA, choisissez un modèle et créez quelque chose. Un clip que vous pouvez regarder vous en apprendra plus sur le prompting que n’importe quelle quantité de lecture.

Partager cet article

Choisissez votre langue