# Higgsfield MCP dans Claude Code : confiez-lui une tâche, obtenez une vidéo > Comment connecter Higgsfield MCP à Claude Code avec une seule commande, confier à l’agent la création d’une image ou d’une vidéo, et désactiver le serveur pour éviter de consommer vos limites. Source: https://ailoot.ai/blog/fr/higgsfield-mcp-claude-code/ Canonical: https://ailoot.ai/blog/fr/higgsfield-mcp-claude-code/ Language: fr Publisher: Ailoot (https://ailoot.ai/) Translation: guide-120 Revision: sha256-b18f71896708e828b9b17477a4f43fbdb1de69caee6fdafe25039fc7f0a327b7 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.
À retenir Connectez-vous avec une seule commande dans le terminal : `claude mcp add --transport http higgsfield https://mcp.higgsfield.ai/mcp`. Ensuite, dans Claude Code, saisissez `/mcp`, sélectionnez higgsfield et connectez-vous à votre compte Higgsfield dans le navigateur ; aucune clé API n’est nécessaire. Vérifiez avec `claude mcp list` : le serveur doit afficher ✔ Connected. Les générations utilisent les crédits de votre compte Higgsfield ; demandez donc à l’agent d’indiquer le coût et convenez du nombre de tentatives pour chaque tâche. Si vous n’avez rien à générer, désactivez le serveur avec le bouton bascule dans `/mcp` : il occupe de la place dans le contexte et consomme les limites de Claude Code.
## É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 : ```bash 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é](https://ailoot.ai/blog/fr/mcp-servers-claude-code/). ## É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 : ```bash 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. ```bash claude mcp get higgsfield ``` Si cela ne suffit pas, supprimez le serveur et ajoutez-le à nouveau : ```bash 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é](https://ailoot.ai/blog/fr/where-claude-code-tokens-go/) : | Ce qui est consommé | À quoi cela sert | Où vérifier | Comment réduire l’utilisation | |----|----|----|----| | Limites de Claude Code | Noms des outils et instructions du serveur dans le contexte, vos messages et le travail de l’agent | Les limites de votre abonnement Claude Code | Gardez le serveur uniquement dans le projet où vous générez, et désactivez-le lorsque vous n’avez rien à générer | | Crédits Higgsfield | Chaque génération d’image ou de vidéo | Dans votre compte Higgsfield ou en demandant à l’agent | Demandez-lui d’indiquer le coût et convenez du nombre de tentatives pour chaque tâche | ## 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](https://ailoot.ai/blog/fr/claude-code-tool-search-mcp-limit/) 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 :
La vidéo se charge au fil du défilement
Guide complet - Configuration du premier agent Hermes
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 : | Approche | Installation | Points à garder à l’esprit | |----|----|----| | Serveur MCP Higgsfield | `claude mcp add` avec l’adresse `https://mcp.higgsfield.ai/mcp`, puis connexion à votre compte dans le navigateur | Vous n’installez rien. Tant que le serveur est activé, il occupe de la place dans le contexte | | Programme et skills Higgsfield | `npm i -g @higgsfield/cli`, puis `higgsfield auth login` (connexion dans le navigateur), puis `npx skills add higgsfield-ai/skills` | C’est la méthode recommandée par Higgsfield pour Claude Code et Codex. Aucun serveur MCP toujours actif n’occupe de place dans le contexte | | Serveur non officiel sur GitHub | Un build créé par un tiers qui récupère vos informations de connexion Higgsfield dans votre navigateur | Vous donnez accès à votre compte à du code tiers. Ne l’installez pas à la place du serveur Higgsfield | 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](https://ailoot.ai/docs/en/api/images/) ou le [guide des tâches et résultats vidéo](https://ailoot.ai/docs/en/api/video-music/) ; ils décrivent les appels API Ailoot, pas ce compte MCP Higgsfield.
### Questions fréquentes Ai-je besoin d’une clé API pour Higgsfield MCP ? Non. Connectez-vous à votre compte Higgsfield dans un navigateur : saisissez /mcp dans Claude Code, sélectionnez higgsfield et connectez-vous. Combien coûte une vidéo avec Higgsfield MCP ? Cela dépend du modèle ; les crédits sont débités de votre compte Higgsfield. Demandez à l’agent d’indiquer le coût avant de lancer la génération et attendez votre accord.
### Sources - [Higgsfield : page MCP](https://higgsfield.ai/mcp) - adresse du serveur mcp.higgsfield.ai/mcp, connexion via un compte et méthode avec le programme Higgsfield et les skills pour Claude Code et Codex - [Anthropic : Claude Code et MCP](https://code.claude.com/docs/en/mcp) - commandes claude mcp add, list, get et remove ; option --scope ; bouton bascule dans /mcp ; recherche d’outils ; et éléments chargés dans le contexte
[Guides Ailoot](https://ailoot.ai/docs/)
[Accéder à Ailoot](https://ailoot.ai/)
## Questions fréquentes : Higgsfield MCP dans Claude Code : confiez-lui une tâche, obtenez une vidéo ### Que préparer avant la première génération payante Higgsfield ? Demandez à l’agent la liste des outils, modèles et coûts en crédits, sans rien générer. Convenez ensuite du modèle, du plafond de coût et du nombre de tentatives de la tâche avant d’autoriser la génération payante. ### Connected signifie-t-il qu’une vidéo a été générée ? Non. Cela confirme la connexion MCP après authentification. Une génération exige encore une tâche autorisée, des crédits et l’examen de l’image ou vidéo retournée. Désactivez le serveur MCP lorsque ce parcours n’est pas utilisé. ## Ailoot · L’entreprise et son portefeuille de projets Ailoot s’appuie sur une expérience opérationnelle éprouvée, une large clientèle, un service stable et un suivi continu des KPI. L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois. Ailoot met cette expérience opérationnelle au service de l’accès API aux fonctions d’IA dans les produits des clients, leurs agents, applications et automatisations.