Connectez Claude au serveur MCP hébergé de Replicate et utilisez Flux 2 pour la génération et Flux Kontext pour les retouches, sans quitter le chat. Étapes de configuration pour Claude.ai, Claude Desktop et Claude Code, tableau comparatif des modèles, prompts testés et erreurs qui gaspillent des crédits.
Si vous avez déjà copié un prompt depuis Claude, collé dans un autre outil d’IA d’images, téléchargé le résultat, puis repris la conversation pour demander une retouche, vous connaissez cette friction. Le chat sait ce que vous voulez. Le modèle d’image se trouve dans un autre onglet. Une configuration de serveur MCP Flux comble cet écart : Claude rédige le prompt, appelle le modèle sur Replicate et renvoie l’URL de l’image finale dans la même conversation.
Une précision d’abord, car les résultats de recherche brouillent les pistes. Il n’existe pas de produit distinct appelé « le serveur MCP Flux ». Il s’agit du serveur MCP hébergé officiel de Replicate, qui ouvre la bibliothèque de modèles de Replicate à Claude, combiné aux modèles de Black Forest Labs qui y fonctionnent : la famille Flux 2 pour générer des images et la famille Flux Kontext pour les modifier. Cet article montre comment connecter les deux, quel modèle appeler pour quelle tâche et quels prompts donnent de bons résultats en pratique.
Replicate fait tourner un serveur MCP hébergé à l’adresse https://mcp.replicate.com/sse. Sa page de configuration indique qu’il permet à des applications comme Claude, Cursor, Codex, Gemini et VS Code d’accéder à l’API HTTP de Replicate, pour rechercher, comparer et lancer des modèles. Les outils qu’il propose incluent search_models, create_predictions et list_hardware. Concrètement, Claude peut parcourir le catalogue, lire les données qu’un modèle accepte en entrée et lancer une prédiction avec votre prompt.
Flux n’est qu’une partie de ce catalogue. Black Forest Labs publie ses modèles sur Replicate : demander à Claude un modèle Flux passe donc par le même mécanisme que pour n’importe quel autre modèle d’image. C’est pratique, car les habitudes que vous prenez ici valent pour tous les autres modèles de la plateforme.
Vous pouvez appeler Replicate depuis un script Python ou Node, et beaucoup de gens le font. La voie MCP se justifie dans quelques situations :
Le compromis porte sur le coût et le contrôle. Chaque exécution est facturée sur votre compte Replicate, et Claude décide du nombre d’appels à effectuer, sauf si vous le précisez. Nous y revenons dans la section sur les erreurs.
Commencez par vous connecter à Replicate et créer un token d’API depuis les paramètres de votre compte. Traitez-le comme un mot de passe. Le token est facturé sur votre compte, ne le collez donc jamais dans un prompt et ne le versionnez pas dans un dépôt. Les étapes de connexion ci-dessous le demandent dans un champ dédié.
claude.ai/settings/connectors.https://mcp.replicate.com/sse.
Si vous travaillez dans un terminal, une seule commande enregistre le serveur pour votre compte utilisateur :
claude mcp add replicate https://mcp.replicate.com/sse --transport sse --scope user
--scope user rend le serveur disponible dans tous les projets, et non seulement dans le dossier où vous avez lancé la commande. Vous vous authentifiez avec le même token d’API Replicate.
D’autres clients fonctionnent aussi, avec une configuration légèrement différente :
| Client | Mode de connexion |
|---|---|
| Cursor | Modifiez ~/.cursor/mcp.json avec une entrée npx -y mcp-remote@latest |
| Windsurf | Modifiez ~/.codeium/windsurf/mcp_config.json avec le même type d’entrée npx |
| Codex CLI | Lancez codex mcp add replicate, puis ouvrez /mcp dans codex |
| Gemini CLI | Ajoutez l’URL du serveur dans ~/.gemini/settings.json, puis lancez /mcp auth replicate |
Pour Cursor et Windsurf, copiez le bloc JSON exact depuis la page MCP de Replicate au lieu de le retaper de mémoire. Une seule accolade mal placée et le serveur ne se charge pas, sans message d’erreur.
Ouvrez un nouveau chat et demandez : « Recherche sur Replicate black-forest-labs/flux-2-pro et liste les entrées acceptées. » Si la connexion est active, Claude appelle l’outil de recherche et restitue des champs tels que prompt, input_images, aspect_ratio, resolution, output_format, seed et safety_tolerance. Si Claude affirme ne pas disposer d’outils pour cela, redémarrez le client et vérifiez que le connecteur est bien indiqué comme connecté.
La page Black Forest Labs de Replicate répertorie une longue série de modèles Flux 2 et Kontext. Vous n’en avez pas besoin de tous. Ce tableau présente ceux qui valent la peine d’être connus, avec les descriptions reprises du texte même de Replicate.
| Modèle | Ce que dit Replicate | À utiliser quand |
|---|---|---|
| Flux 2 Max | Le modèle de génération d’images le plus fidèle de Black Forest Labs | L’image est le livrable final |
| Flux 2 Flex | Génération et édition de qualité maximale, jusqu’à dix images de référence | Vous mélangez de nombreuses références |
| Flux 2 Pro | Génération et édition de haute qualité, jusqu’à huit images de référence | Vous voulez une valeur sûre par défaut |
| Flux 2 Dev | Génération et édition de qualité avec prise en charge des images de référence | Brouillons courants avec des références |
| Flux 2 Klein 4B | Distillé en 4 étapes, inférence en moins d’une seconde | Vous avez besoin de nombreux brouillons rapides |
| Flux Kontext Pro | Édition par texte avec un excellent respect du prompt | Vous modifiez une partie d’une photo |
| Flux Kontext Max | Édition premium avec une typographie améliorée | La retouche implique du lettrage |
| Flux Kontext Dev | Version à poids ouverts de Kontext | Vous voulez le modèle open source |
Flux 2 pour générer. Flux 2 Pro est le cheval de trait. Il crée des images à partir d’un prompt texte seul, ou d’un prompt accompagné de jusqu’à huit images de référence qui orientent le style, le sujet ou la composition. La sortie peut atteindre 4 MP, avec un plafond de 2048x2048, et vous pouvez choisir WebP, JPEG ou PNG. La variante Flux 2 Klein 4B sacrifie un peu de finition au profit de la vitesse, ce qui en fait le bon modèle pour les premiers essais d’un prompt.
Kontext pour retoucher. Flux Kontext Pro prend une image source et une instruction formulée en langage courant. Pas de masques, pas d’outils de sélection. Il peut aussi générer à partir de zéro si vous laissez le champ image vide, bien que Flux 2 soit le meilleur premier choix pour cette tâche.
Claude n’a pas besoin d’une syntaxe particulière. Il lui faut le nom du modèle, les réglages qui vous importent et une description claire. Tout ce qui suit est un modèle, pas une règle.
Une demande qui a tendance à fonctionner du premier coup :
Utilisez Replicate pour lancer black-forest-labs/flux-2-pro avec aspect_ratio 16:9, resolution 2 MP et output_format jpg. Prompt : une théière en céramique posée sur un linge en lin à côté d’une fenêtre, lumière douce du matin venant de la gauche, objectif 85 mm, faible profondeur de champ, grain de film fin. Renvoyez l’URL de l’image.
Nommer le modèle supprime les approximations. Indiquer le format et la résolution empêche Claude de se rabattre sur les valeurs par défaut, qui pour Flux 2 Pro donnent une image carrée de 1 MP.
💡 Le schéma de Flux 2 Pro indique que 4 MP est possible, mais que 2 MP ou moins est recommandé, et que les très hautes résolutions peuvent ne pas être respectées lorsque le format n’est pas 1:1. Commencez à 1 ou 2 MP.
Les images de référence sont le domaine où Flux 2 prend l’avantage sur les anciens modèles. L’astuce consiste à les désigner par leur numéro. Voici un prompt tiré de la galerie d’exemples du modèle :
La personne de l’image 1 caresse le chat de l’image 2, l’oiseau de l’image 3 est à côté d’eux.
Donnez à Claude trois URL d’images, listez-les dans l’ordre et utilisez « image 1 », « image 2 » et « image 3 » dans le prompt. Pour un style de marque, fournissez trois à cinq exemples du style visé et décrivez la nouvelle scène en une seule phrase.
Les prompts de retouche fonctionnent mieux lorsqu’ils énoncent le changement et ce qui doit rester en place. Celui-ci provient de la galerie de Flux Kontext Pro :
Remplacez l’arrière-plan par une plage tout en gardant la personne exactement dans la même position, la même échelle et la même pose. Conservez à l’identique le placement du sujet, l’angle de prise de vue, le cadrage et la perspective. Ne remplacez que l’environnement autour d’elle.
Les instructions courtes fonctionnent aussi pour les petites retouches. « Change the car to blue » est un exemple réel sur la page de Flux 2 Pro, et « make this a photo » figure dans la galerie de Kontext Pro. Dans les deux cas, il n’y a qu’un changement, clairement nommé.
Du texte dans le cadre. Mettez les mots exacts entre guillemets et gardez-les courts. La galerie de Kontext Pro présente un prompt de remplacement pur : Replace 'joy' with 'Pro'. Pour un lettrage plus long, Flux Kontext Max est le modèle que Replicate décrit comme ayant une typographie améliorée. La galerie de Flux 2 Pro inclut même une infographie annotée d’un monument avec des mesures, donc un texte dense est possible là aussi, mais vérifiez chaque caractère avant de publier.
Claude les renseignera si vous les omettez. Les régler vous-même évite un nouvel essai. Les valeurs ci-dessous proviennent des schémas d’entrée de Flux 2 Pro et de Flux Kontext Pro.
| Paramètre | Flux 2 Pro | Flux Kontext Pro |
|---|---|---|
aspect_ratio | Par défaut 1:1 ; prend aussi en charge 16:9, 3:2, 4:5, 9:16 et d’autres, ainsi que custom | Par défaut match_input_image ; 14 préréglages |
resolution | 0,5, 1 (par défaut), 2 ou 4 MP | Non proposé, suit l’image source |
output_format | webp (par défaut), jpg ou png | png (par défaut) ou jpg |
output_quality | De 0 à 100, 80 par défaut, ignoré pour png | Non proposé |
seed | Une valeur fixe reproduit un résultat | Une valeur fixe reproduit un résultat |
safety_tolerance | De 1 (strict) à 5 (permissif), 2 par défaut | 2 par défaut, qui est aussi le maximum lorsque des images source sont utilisées |
prompt_upsampling | Absent du schéma | Désactivé par défaut, améliore automatiquement le prompt |
Les seeds rendent les retouches comparables. Si vous modifiez à la fois le prompt et le seed, vous ne pourrez pas dire lequel a causé la différence. Demandez à Claude de réutiliser le seed de l’exécution précédente et de ne changer que la formulation. C’est ce qui se rapproche le plus d’une expérience contrôlée en génération d’images.
Laissez Claude rédiger, mais relisez le prompt. Claude sait très bien transformer « une théière » en une description d’éclairage et d’objectif. Il est moins doué pour se souvenir que vous ne vouliez aucun texte dans le cadre. Demandez-lui d’afficher le prompt final avant de lancer la prédiction, surtout sur les modèles les plus puissants.
Voici une séquence adaptée à une petite boutique ou à un indépendant qui constitue un catalogue. Gardez chaque étape dans le même chat, pour que l’historique tienne les comptes à votre place.
Quand il s’agit de « placer ce produit à côté de cette personne », un outil dédié aide. Multi Image Kontext Max fusionne deux photos en une seule scène, et c’est une option utile lorsque vous n’avez pas besoin de toute la souplesse de huit références.
Comme toute l’exécution vit dans un même fil, un collègue peut l’ouvrir, lire les prompts, et reproduire ou ajuster n’importe quelle étape. Comparez avec un dossier de téléchargements sans nom.
« Changez l’arrière-plan, mettez la chemise en rouge, ajoutez des lunettes, adoucissez la lumière et recadrez plus serré » oblige le modèle à deviner les priorités. Découpez-le en cinq retouches courtes et vérifiez chacune. Vous passerez davantage de messages, mais vous dépenserez moins de crédits sur de mauvais résultats.
Rien ne justifie de dépenser des crédits Flux 2 Max sur un prompt que vous n’avez pas encore stabilisé. Utilisez un modèle rapide pour trouver l’idée, puis investissez dans la version finale.
Indiquez à Claude combien de générations il peut lancer par demande, par exemple « pas plus de quatre ». Chaque prédiction est facturée sur votre compte Replicate, et la page de chaque modèle affiche son prix actuel. Vérifiez-le avant de demander trente variantes.
Gardez aussi le token hors du chat. Il doit figurer dans le champ d’authentification du connecteur, et non dans un message. S’il se retrouve un jour dans une conversation ou une capture d’écran, révoquez-le dans vos paramètres Replicate et créez-en un nouveau.
La voie MCP de Replicate plaît aux personnes qui aiment les terminaux, les schémas et les journaux. Si vous préférez éviter la configuration et regarder d’abord les résultats, ouvrez une page de modèle et saisissez un prompt. Commencez avec Flux 2 Pro pour une image neuve, puis passez le résultat dans Flux Kontext Pro et modifiez-le sur un seul point : l’arrière-plan, la couleur d’une veste, l’heure de la journée. Deux ou trois tours suffisent pour sentir à quel point les deux familles raisonnent différemment. Les pages de modèles affichent aussi des exemples de prompts et d’entrées, un moyen rapide de voir comment chacun interprète les instructions.
La qualité du prompt décide de la plupart des résultats, et vous n’avez pas besoin d’un connecteur pour l’améliorer. Claude Sonnet 5 est disponible sur PicassoIA : vous pouvez donc y rédiger un prompt et le coller directement sur la page d’un modèle Flux.
Une image forte peut aussi devenir la première image d’un court clip. Les modèles d’image vers vidéo comme Wan 2.7 I2V prennent une photo et l’animent, si bien qu’un rendu Flux peut devenir une boucle produit ou une bande-annonce pour les réseaux sociaux sans repartir de zéro. PicassoIA propose aussi sa propre API pour développeurs et une connexion MCP pour ses modèles d’image et de vidéo, documentées sur picassoia.com/en/api, si vous voulez un seul compte pour le navigateur comme pour vos outils.
Choisissez une scène dont vous avez réellement besoin, qu’il s’agisse d’une photo produit, d’un portrait ou d’un bandeau de blog, et créez votre première image dès aujourd’hui. Lancez le même prompt sur un modèle rapide et sur un modèle premium, puis gardez le résultat que vous seriez fier de publier.
Choisissez votre langue
