Higgsfield MCP dans Claude Code : confiez-lui une tâche, obtenez une vidéo

Higgsfield se connecte à Claude Code avec une seule commande claude mcp add et l’adresse https://mcp.higgsfield.ai/mcp. Ensuite, vous lui donnez une tâche en langage courant, et l’agent se rend de lui-même sur Higgsfield, génère une image ou une vidéo et vous la renvoie directement dans la fenêtre. Vous payez donc deux fois : avec les crédits Higgsfield pour les générations et avec les limites de Claude Code parce que le serveur reste dans le contexte. Ma règle est donc simple : si vous n’utilisez pas MCP, désactivez-le.

L’ancien processus était long : aller sur le site Higgsfield, comprendre l’interface, rédiger un prompt, lancer la génération, télécharger le résultat et le téléverser dans votre projet. Higgsfield a maintenant publié son propre MCP : vous n’avez donc plus besoin d’aller sur Higgsfield ni de comprendre ces interfaces.

Il est difficile d’imaginer que quelqu’un aille encore sur Higgsfield pour générer quelque chose alors qu’il est possible de tout générer depuis son propre Claude Code.

J’ai réalisé toute une présentation avec cette configuration, y compris toutes les vidéos qu’elle contient. J’ai décrit la tâche dans son ensemble et l’ai confiée à l’agent.

Il y a un risque : l’agent pourrait se mettre à produire 100 images, et vous paieriez chacune d’elles. Ajoutez donc à chaque tâche une condition concernant le coût et le nombre de tentatives.

Voyons tout cela dans l’ordre : comment connecter le serveur, lui confier une première tâche, ce que vous payez et quand désactiver le serveur.

Étape 1. Ajouter le serveur Higgsfield avec la commande claude mcp add#

Ouvrez un terminal dans le dossier du projet où vous allez générer des images et des vidéos, puis exécutez :

claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp

L’adresse se trouve sur la page officielle higgsfield.ai/mcp ; copiez-la avec le bouton Copy connector URL.

Sans l’option --scope, le serveur est ajouté uniquement au projet en cours. Avec --scope project, il est accessible à toute l’équipe pour ce projet ; avec --scope user, il est accessible dans tous vos projets.

Ajoutez Higgsfield là où vous l’utilisez. Dans un projet où vous écrivez du code ou du texte, il occupera de la place dans le contexte sans rien faire.

J’ai présenté d’autres serveurs pour Claude Code dans un article séparé.

Étape 2. Connectez-vous à votre compte Higgsfield via /mcp#

Lancez Claude Code et saisissez /mcp. Sélectionnez higgsfield dans la liste ; un navigateur s’ouvrira. Connectez-vous à votre compte Higgsfield.

Les générations seront facturées sur ce compte. Tant que vous n’êtes pas connecté, le serveur renvoie une erreur 401 : Claude Code peut le voir, mais ne peut pas l’utiliser.

Étape 3. Vérifiez que le serveur est connecté#

Exécutez ceci dans le terminal :

claude mcp list

Le serveur higgsfield doit afficher le statut ✔ Connected.

Si le statut est différent, vérifiez les détails : l’adresse, la portée et l’état du serveur.

claude mcp get higgsfield

Si cela ne suffit pas, supprimez le serveur et ajoutez-le à nouveau :

claude mcp remove higgsfield
claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp

Reconnectez-vous ensuite via /mcp. Claude Code efface aussi les identifiants enregistrés lorsqu’il supprime le serveur ; vous obtiendrez donc la même erreur 401 si vous ne vous reconnectez pas.

Comment lui confier une première tâche pour une image et une vidéo#

Commencez par lui confier une tâche sans rien générer. Demandez à l’agent de vous montrer ce que le serveur sait faire avant de dépenser quoi que ce soit :

Montre-moi les outils et les modèles disponibles sur le serveur Higgsfield ainsi que le nombre de crédits que coûte une génération avec chaque modèle. Ne génère rien.

Ensuite, donnez-lui la tâche proprement dite. Ajoutez à la fin de chaque tâche une condition : avant toute génération payante, il doit indiquer le coût et convenir du nombre de tentatives.

Un prompt /goal avec une limite de tentatives fonctionne selon le même principe : le nombre de tentatives dont dispose l’agent est limité à l’avance.

Tâche pour une image destinée à la section hero d’un site web :

Prépare une image dans Higgsfield pour la section hero du site web de mon produit. Produit : [link]. Suggère un objet, un angle, une couleur et un décor qui aident à expliquer le produit. Laisse de la place dans l’image pour le titre et le bouton de la page. Format horizontal. Enregistre le fichier terminé dans le dossier images du projet.
Avant toute génération payante, indique-moi le coût, convenons du nombre de tentatives et attends mon « oui ».

Tâche pour créer une vidéo à partir de cette image :

Crée une courte vidéo dans Higgsfield à partir de cette image images/hero.png : la caméra s’approche lentement du produit et l’arrière-plan bouge légèrement. Suggère un modèle et demande-moi quelle doit être la durée de la vidéo. Fais 1 version.
Avant toute génération payante, indique-moi le coût, convenons du nombre de tentatives et attends mon « oui ».

L’agent se rend ensuite de lui-même sur Higgsfield, rédige un prompt, lance la génération, récupère une image ou une vidéo et vous la livre dans la fenêtre Claude Code. Vous pouvez aussi lui dire en langage courant ce qu’il doit modifier.

Quels modèles sont disponibles et combien coûtent les générations#

Higgsfield me convient bien parce que tous les outils d’IA sont intégrés et compris dans l’abonnement, même si vous payez avec des crédits.

Demandez la liste des modèles à l’agent avec la première tâche de la section précédente ; vous obtiendrez les modèles et leurs tarifs en crédits à la date du jour.

Les générations via MCP sont facturées en crédits sur votre compte Higgsfield. Le serveur lui-même consomme les limites de Claude Code : vous avez donc deux compteurs d’utilisation. J’ai expliqué où vont les tokens de Claude Code dans un article séparé :

Quelle consommation le serveur MCP entraîne-t-il et quand le désactiver#

Chaque serveur MCP consomme des limites : les descriptions de ses outils sont ajoutées au contexte du modèle.

La recherche d’outils est activée par défaut dans Claude Code. Au début d’une session, les noms des outils du serveur et leurs instructions sont chargés ; les descriptions complètes le sont au besoin. Si Claude Code passe par votre propre ANTHROPIC_BASE_URL, la recherche est désactivée et les descriptions sont chargées en entier. Dans les deux cas, le serveur occupe de la place dans le contexte de chaque session.

Si vous avez installé un très grand nombre d’outils MCP, ils consomment vos limites sans vous être utiles. Voici donc une règle importante : si vous n’utilisez pas MCP, désactivez-le afin qu’il ne surcharge pas la fenêtre de contexte.

Vous pouvez désactiver et réactiver le serveur ainsi :

• Temporairement. Utilisez le bouton bascule à côté de higgsfield dans /mcp. Claude Code cesse de s’y connecter, le réglage est enregistré et la sélection est mémorisée pour ce projet.
• Complètement. Exécutez claude mcp remove higgsfield. Les identifiants de connexion enregistrés sont supprimés avec le serveur.
• Le réactiver. Utilisez le même bouton bascule dans /mcp, ou exécutez de nouveau claude mcp add et connectez-vous via /mcp.

Laissez le serveur activé lorsque vous travaillez sur des images et des vidéos. Si vous écrivez du code ou du texte et n’avez rien à générer, désactivez-le.

Au fait, j’ai préparé un guide complet pour configurer votre premier agent avec Hermes ; allez le voir :

J’y explique ce qu’est MCP, comment éviter d’en installer un malveillant et combien ils coûtent. Après l’avoir regardé, vous saurez quelles connexions un agent doit réellement utiliser.

Higgsfield MCP exige-t-il une clé API ?#

Il existe trois façons de connecter Higgsfield à un agent :

Commencez par le serveur MCP : une commande suffit pour l’installer et un bouton bascule pour le désactiver. Si vous générez tous les jours et ne voulez pas qu’un serveur occupe de la place dans le contexte, intéressez-vous au programme Higgsfield avec les skills.

Prochaine étape : dans le compte Higgsfield connecté, effectuez la vérification des outils, modèles et coûts en crédits décrite ci-dessus, sans génération. Choisissez un résultat et un budget de tentatives avant de générer. Pour un parcours distinct via l’API Ailoot, consultez le guide de requête image ou le guide des tâches et résultats vidéo ; ils décrivent les appels API Ailoot, pas ce compte MCP Higgsfield.