Le MCP Hoox :
Hoox dans Claude
Connecte Claude Desktop à Hoox en quelques minutes. Génère des dizaines de vidéos UGC en langage naturel — sans écrire une seule ligne de code.
C'est quoi
le MCP Hoox ?
Tu as appris à utiliser Hoox manuellement. Tu maîtrises les avatars, les scripts, les exports. Maintenant, imagine que tu puisses donner des instructions à Claude en langage naturel, et que Claude se charge de tout faire dans Hoox à ta place — créer les avatars, générer les scripts, lancer les vidéos, les exporter — en boucle, sur des dizaines d'éléments à la fois.
C'est exactement ce que permet le MCP Hoox (Model Context Protocol). Un pont direct entre Claude Desktop et la plateforme Hoox.
🤔 MCP, c'est quoi exactement ?
Le Model Context Protocol est un standard ouvert créé par Anthropic. Il permet à Claude de se connecter à des outils externes — des APIs, des bases de données, des logiciels — et de les piloter directement depuis une conversation.
Concrètement : au lieu d'appeler l'API Hoox avec du code, tu parles à Claude. Claude comprend ce que tu veux, choisit les bons outils, les appelle dans le bon ordre, et te tient informé à chaque étape.
Langage naturel
Pas de code. Tu décris ce que tu veux en français, Claude fait le reste. "Crée 10 avatars et génère une vidéo par avatar."
Exécution en boucle
Claude peut enchaîner des dizaines d'opérations automatiquement — créer des avatars, puis les vidéos, puis les exports — sans intervention manuelle.
Intelligence contextuelle
Claude comprend ton brief, adapte les scripts à ton persona, choisit les bons paramètres — il ne fait pas que cliquer, il réfléchit.
Combinaison d'outils
Claude peut mixer les outils Hoox avec d'autres MCP — Google Drive, Notion, Slack — pour des workflows encore plus puissants.
Prérequis avant
d'installer
Deux conditions sont nécessaires pour utiliser le MCP Hoox. Vérifie les deux avant de passer à l'installation.
Claude Desktop
L'application desktop Claude (Mac ou PC). Le MCP ne fonctionne pas dans le navigateur web.
⚠️ ObligatoireCompte Enterprise Hoox
L'accès à l'API (et donc au MCP) est réservé aux plans Enterprise. Vérifie que ton plan est activé dans Settings → API.
⚠️ Obligatoire🔑 Générer ta clé API Hoox
Quelle que soit ta plateforme (Mac ou PC), tu auras besoin d'une clé API Hoox. Génère-la maintenant :
Aller sur le dashboard Hoox
Connecte-toi sur app.hoox.video/dashboard avec ton compte Enterprise.
Ouvrir les paramètres de ton espace
Clique sur les paramètres de ton space, puis dans le menu latéral, sélectionne API.
Générer et copier ta clé
Clique sur "Generate API Key", donne-lui un nom, puis copie la clé immédiatement. Elle ne sera affichée qu'une seule fois — garde-la dans un endroit sûr.
Installation
sur Mac
L'installation sur Mac se fait en 3 étapes. Compte environ 5 à 10 minutes la première fois — surtout si tu n'as jamais utilisé le Terminal.
Étape 1 — Installer Homebrew et uv
Ouvre le Terminal (cherche "Terminal" dans Spotlight avec ⌘ + Espace) et lance cette commande pour installer Homebrew :
Une fois Homebrew installé, il affiche 3 lignes de commandes à copier/coller et exécuter (commençant par echo >>). Exécute-les, puis lance :
Étape 2 — Clé API Hoox
Tu as normalement déjà généré ta clé à la section précédente. Garde-la sous la main pour l'étape suivante.
Étape 3 — Configurer Claude Desktop
Ouvrir les paramètres de Claude
Dans Claude Desktop : Paramètres → Développeur → Serveurs MCP locaux
Clique sur "Modifier la config". Cela ouvre le Finder sur un fichier claude_desktop_config.json.
Ouvrir le fichier avec un éditeur de texte
Fais un clic droit sur le fichier → Ouvrir avec → TextEdit (ou tout autre éditeur de texte).
Coller la configuration MCP
Remplace le contenu du fichier par le JSON ci-dessous, en remplaçant hx_live_your_key_here par ta vraie clé API Hoox :
Installation
sur PC (Windows)
Sur Windows, l'installation est encore plus simple — une seule commande suffit à préparer l'environnement.
Étape 1 — Installer uv via PowerShell
Ouvre PowerShell (cherche "PowerShell" dans le menu Démarrer) et lance cette commande :
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser dans PowerShell et confirme, puis relance la commande d'installation.
Étape 2 — Clé API Hoox
Même démarche que sur Mac : génère ta clé depuis app.hoox.video → Settings → API.
Étape 3 — Configurer Claude Desktop
Ouvrir les paramètres de Claude
Dans Claude Desktop : Paramètres → Développeur → Serveurs MCP locaux
Clique sur "Modifier la config". L'explorateur s'ouvre sur le fichier claude_desktop_config.json.
Ouvrir le fichier avec le Bloc-notes
Fais un clic droit sur le fichier → Ouvrir avec → Bloc-notes (ou Notepad++, VS Code si tu les as).
Coller la configuration MCP
Remplace le contenu par le même JSON que sur Mac. N'oublie pas de remplacer hx_live_your_key_here par ta vraie clé :
hx_live_.
Les outils
disponibles
Une fois le MCP connecté, Claude dispose de 13 outils Hoox qu'il peut appeler à ta demande ou de façon autonome. Tu n'as pas besoin de les connaître par cœur — Claude sait lequel utiliser selon ce que tu lui demandes.
| Outil | Ce que ça fait | Usage typique |
|---|---|---|
| list_avatars | Liste tous les avatars disponibles sur ton compte | "Montre-moi mes avatars" |
| list_voices | Liste toutes les voix disponibles | "Quelles voix féminines en français ?" |
| create_avatar | Crée un nouvel avatar depuis une image ou une URL produit | "Crée 10 avatars avec ce produit" |
| get_avatar | Récupère les informations d'un avatar spécifique | Vérifie les détails avant une génération |
| get_avatar_look | Récupère les variantes de look d'un avatar | Sélectionne un look précis pour la vidéo |
| get_avatar_status | Vérifie si un avatar est prêt à l'emploi | Attente entre création et utilisation |
| edit_avatar | Modifie le look d'un avatar existant | "Change la tenue de cet avatar" |
| generate_script | Génère un script UGC depuis un prompt ou une URL produit | "Écris 25 scripts pour ce produit" |
| start_generation | Lance la génération d'une vidéo | Produit la vidéo avec avatar + voix + script |
| get_generation_status | Surveille la progression d'une génération en cours | Claude attend automatiquement la fin |
| start_export | Lance l'export MP4 d'une vidéo générée | Récupère le lien de téléchargement |
| get_export_status | Vérifie si l'export est terminé | Surveille le traitement avant livraison |
| duplicate_video | Duplique une vidéo existante pour la modifier | Crée des variations d'un même contenu |
💡 Exemples de prompts efficaces
Passe l'URL de ta fiche produit directement dans le prompt — Claude va scraper les infos, générer les scripts et créer les vidéos :
"Génère 5 vidéos UGC pour ce produit : [URL]. Ton américaine, 30 secondes, format vertical. Export avec Veo 3 Fast."
Claude peut générer le même concept en plusieurs langues avec des avatars différents :
"Prends ce script et génère une version française, anglaise et espagnole. Utilise un avatar différent pour chaque langue. Exporte les 3."
Pour optimiser les performances pub, demande des variations du hook d'entrée :
"Génère 10 variantes du même script, en changeant uniquement les 5 premières secondes (le hook). Même avatar, même voix. Je veux tester ce qui accroche le mieux."
Tu peux coller une liste de prompts ou d'URLs directement dans le chat :
"Voici 20 scripts différents. Génère une vidéo pour chacun, en alternant entre mes 4 avatars. Format vertical, Veo 3 Fast. Dis-moi quand c'est terminé."
Cas concret :
25 vidéos en une instruction
Voici un exemple réel : une production complète de 25 vidéos UGC pour la marque Jeliskin, lancée avec un seul prompt. Claude a tout fait de façon autonome.
📋 Le prompt utilisé
Voici exactement le prompt qui a lancé toute la production :
Je veux que tu créés 25 avatars différents qui portent en main le produit ci-joint.
Attention aux dimensions du pot (il fait 15cm de hauteur et 10cm de diamètre).
Voici mon buyer persona : femme, entre 35 et 45 ans, urbaine, sportive, attentive au wellness. Contexte : salon d'appartement (moderne chic ou type parisien). Habillée en tenu de yoga soit sur un fauteuil ou bien sur un canapé.
Le produit : https://jeli-skin.com/products/jeliskin-collagene-gummies
Je veux que tu créés ensuite 25 scripts différents type UGC pour des ads de 15 secondes. Utilise l'artefact de génération de script. Les scripts devront être en anglais.
Une fois que tu as les 25 scripts, tu génères une vidéo par avatar et tu l'exporte avec Veo 3 Fast.
En gros : 1 script en anglais = 1 avatar = 1 export avec Veo 3.
Dis moi si tu as tout bien compris ?
🤖 Ce que Claude fait automatiquement
Analyse le brief et scrape la fiche produit
Claude visite l'URL Jeliskin, extrait les informations produit (nom, bénéfices, images) et construit le contexte de génération.
Crée les 25 avatars en boucle
Claude appelle create_avatar 25 fois, en faisant varier les looks selon le buyer persona (tenue de yoga, salon parisien, produit en main). Il attend la confirmation de chaque avatar avant de passer au suivant.
Génère les 25 scripts
Claude crée 25 scripts UGC distincts en anglais (hooks différents, angles de persuasion variés, 15 secondes chacun) en s'appuyant sur les infos produit.
Lance 25 vidéos et les exporte
Pour chaque paire avatar/script, Claude appelle start_generation, surveille le statut avec get_generation_status, puis lance start_export en Veo 3 Fast. Il recommence jusqu'au 25e.
🧩 Clés du prompt réussi
Buyer persona précis
Âge, style de vie, contexte visuel, tenue — plus tu es précis, plus les avatars seront cohérents avec ta cible.
Contraintes physiques du produit
Les dimensions du pot permettent à Claude de calibrer les proportions entre l'avatar et le produit tenu en main.
URL produit directe
Claude scrape la fiche pour enrichir les scripts automatiquement — bénéfices, ingrédients, claims de la marque.
Demander une confirmation
"Dis-moi si tu as tout bien compris" est une bonne pratique — Claude reformule le plan avant de s'exécuter, ce qui évite les erreurs.
Quiz &
Exercice
Valide tes connaissances sur le MCP Hoox avant de te lancer dans ta première production automatisée.
🧠 Quiz — MCP Hoox
0 / 501Quel plan Hoox est nécessaire pour utiliser le MCP ?
02Dans quel fichier faut-il coller la configuration JSON du MCP ?
03Quelle est la première commande à exécuter sur Mac pour installer le MCP ?
04Quelle est la principale différence entre le MCP et l'API Hoox classique ?
05Dans le cas Jeliskin, pourquoi Claude demande-t-il confirmation avant de commencer ?
Ta première production MCP
Suis ces étapes pour réaliser ta première production automatisée avec le MCP Hoox. Coche chaque étape au fur et à mesure.
- Installer le MCP selon ton OS (Mac ou PC) — vérifie que l'icône Hoox apparaît dans Claude Desktop
- Tester la connexion en demandant à Claude : "Liste mes avatars disponibles sur Hoox" — il doit te répondre avec tes avatars réels
- Choisir un produit que tu veux promouvoir (fiche produit existante ou produit fictif) et définir ton buyer persona en 3-4 lignes
- Rédiger ton prompt en précisant : nombre de vidéos, durée, langue des scripts, format (vertical), modèle d'export (ex: Veo 3 Fast)
- Demander confirmation à Claude avant qu'il se lance — laisse-le reformuler le plan et corrige si besoin
- Lancer la production et observer Claude enchaîner les outils automatiquement
- Récupérer les liens d'export et télécharger tes vidéos — puis analyse ce qui a bien fonctionné dans ton prompt