Claude Code écrit vos pages mais ne peut pas dessiner leurs images. Cet article détaille l’enregistrement d’un serveur MCP de génération d’images, le choix du bon périmètre, la comparaison des serveurs les plus utilisés et la connexion de PicassoIA pour les images et la vidéo, avec les solutions aux erreurs courantes.
Claude Code peut construire une page d’accueil en quelques minutes, mais il ne peut pas dessiner l’image principale. Demandez une bannière, une maquette de produit ou une série de vignettes pour un blog, et vous obtenez du code SVG, un chemin de fichier fictif ou un refus poli : « je ne peux pas générer d’images ». Un serveur MCP de génération d’images comble cette lacune. Une fois enregistré, Claude Code appelle un modèle d’image comme un outil, enregistre le fichier dans votre dépôt et l’intègre au HTML ou au markdown qu’il est déjà en train de modifier, le tout dans une même session.
Cet article montre comment les différents éléments se connectent, les commandes exactes pour enregistrer un serveur, une comparaison côte à côte des options réellement utilisées, et la façon de brancher le connecteur de PicassoIA pour les images et la vidéo. Les commandes suivent la documentation actuelle de Claude Code. Ce que je n’ai pas pu confirmer, comme l’URL d’un serveur privé, apparaît sous forme d’espace réservé plutôt que sous forme de supposition.
Claude Code travaille dans votre terminal, lit vos fichiers, exécute des commandes et modifie du code. Cette boucle est rapide jusqu’à la première balise <img>. Vous quittez alors la session, ouvrez un générateur séparé, téléchargez un fichier, le renommez, le déposez dans le bon dossier et recollez le chemin. Chaque étape casse le fil de votre travail, et le prompt que vous avez écrit ne voit jamais la page à laquelle il était destiné.
MCP, le Model Context Protocol, est un standard ouvert qui permet à un client d’IA d’appeler des outils externes. Un serveur d’images expose un ou plusieurs outils, généralement quelque chose comme generate_image, et Claude Code les liste sous un nom prévisible : mcp__<server-name>__<tool-name>. Un serveur appelé image-gen avec un outil generate_image apparaît sous le nom mcp__image-gen__generate_image.
Avec cela en place, une seule demande accomplit tout le travail :
💡 Astuce : Gardez un nom de serveur court et en minuscules. Il apparaîtra dans chaque appel d’outil et chaque demande d’autorisation, et
image-gense lit plus facilement qu’un long nom de produit.
Trois éléments entrent en jeu, et les confondre est à l’origine de la plupart des confusions lors de l’installation.
| Élément | Ce que c’est | Exemple |
|---|---|---|
| Client | L’application qui appelle les outils | Claude Code |
| Serveur | Un processus ou un point d’accès hébergé qui parle MCP | mcp-image, un connecteur PicassoIA |
| Fournisseur | La plateforme qui fait tourner le modèle d’image | OpenAI, Google, Replicate, PicassoIA |
Le serveur est le traducteur. Il reçoit un appel d’outil de Claude Code, le transforme en requête acceptée par le fournisseur, et renvoie le résultat. Claude Code prend en charge quatre transports : stdio, http, sse et ws. En pratique, vous choisissez entre deux. stdio lance un processus local sur votre machine, généralement via npx. http pointe vers une URL distante que quelqu’un d’autre maintient en fonctionnement.
Les serveurs gèrent la sortie de deux façons, et la différence compte. Certains enregistrent le fichier sur le disque et renvoient le chemin. mcp-image écrit dans un dossier que vous définissez, et create-image-mcp renvoie les métadonnées du fichier plutôt que des données base64. D’autres renvoient une URL ou des données d’image intégrées.
La documentation de Claude Code indique que les images contenues dans les résultats d’outils comptent dans la limite de MAX_MCP_OUTPUT_TOKENS. Un avertissement apparaît à 10 000 tokens et le plafond par défaut est de 25 000. Un serveur qui renvoie un chemin court ou une URL reste bien en dessous de cette limite. Un serveur qui renvoie de grandes images intégrées peut l’atteindre très vite.
claude --version.claude mcp add.claude mcp list.Pour un serveur local stdio, la forme est la suivante :
claude mcp add --transport stdio --env <PROVIDER_VARIABLE>=<your-credential> --env IMAGE_OUTPUT_DIR=/absolute/path/to/public/images image-gen -- npx -y mcp-image
Tout ce qui précède -- appartient à Claude Code. Tout ce qui suit est transmis tel quel au serveur. Si vous oubliez le --, la CLI essaie de lire les options de votre serveur comme siennes. Le nom exact de la variable provient du README du serveur, car chaque fournisseur utilise le sien.
Pour un serveur hébergé, passez le transport sur http :
claude mcp add --transport http image-gen <server-url> --header "Authorization: Bearer <your-credential>"
⚠️ Utilisateurs de Windows : Sous Windows natif, hors WSL, les serveurs lancés avec
npxnécessitent un wrapper :claude mcp add --transport stdio image-gen -- cmd /c npx -y mcp-image. Sans lui, le serveur peut ne pas démarrer.
| Périmètre | Stocké dans | Qui le voit | Usage |
|---|---|---|---|
local (par défaut) | ~/.claude.json, dans votre projet | Vous seul, un projet | Tester un nouveau serveur |
project | .mcp.json à la racine du dépôt | Toute personne qui clone le dépôt | Outils standard de l’équipe |
user | ~/.claude.json, niveau supérieur | Vous seul, tous les projets | Outils personnels |
Ajoutez --scope project ou --scope user à la commande. Lorsque le même nom existe dans plusieurs périmètres, local l’emporte sur projet, et projet l’emporte sur utilisateur.
Le périmètre projet convient bien au travail sur les images, car toute l’équipe reçoit la même configuration. Ne commitez pas pour autant les identifiants. .mcp.json prend en charge l’expansion de ${VAR} dans command, args, env, url et headers, de sorte que le fichier contient une référence et que chaque développeur fournit la valeur depuis son propre shell :
{
"mcpServers": {
"image-gen": {
"type": "stdio",
"command": "npx",
"args": ["-y", "mcp-image"],
"env": {
"IMAGE_OUTPUT_DIR": "${IMAGE_OUTPUT_DIR}",
"<PROVIDER_VARIABLE>": "${<PROVIDER_VARIABLE>}"
}
}
}
}
Claude Code demande une approbation avant de lancer un serveur déclaré dans un .mcp.json de projet. La première session d’un coéquipier affiche donc un statut en attente d’approbation tant qu’il ne l’a pas accepté.
Exécutez claude mcp list. Chaque serveur reçoit un statut : Connecté, Échec de la connexion, Authentification requise ou En attente d’approbation. claude mcp get image-gen affiche les détails d’un seul serveur. Dans une session, /mcp ouvre le même panneau, et /mcp reconnect all relance tout ce qui a échoué.
Testez ensuite avec une petite demande : « Générez une image 16:9 d’une tasse en céramique posée sur un bureau en bois et enregistrez-la dans public/images/test.jpg. » Si l’appel d’outil apparaît comme mcp__image-gen__generate_image et qu’un fichier apparaît dans le dossier, le serveur fonctionne.
Le tableau ci-dessous provient de la fiche de chaque projet. Vérifiez le README pour les options actuelles avant d’installer. Je n’ai pas réalisé de benchmark de la qualité d’image entre eux, car la qualité dépend beaucoup plus du modèle derrière un serveur que du serveur lui-même.
| Serveur | Modèles derrière | Installation | Sortie | Idéal pour |
|---|---|---|---|---|
mcp-image | Gemini (par défaut), OpenAI, BytePlus Seedream | npx -y mcp-image | Enregistré dans IMAGE_OUTPUT_DIR | Un seul serveur, trois fournisseurs |
create-image-mcp | OpenAI GPT Image | npm install -g @gpriday/create-image-mcp | Enregistré sur le disque, chemin renvoyé | Utilisateurs d’OpenAI qui ont besoin de masques et d’inpainting |
| Serveurs communautaires Replicate | Modèles hébergés sur Replicate | Paquet Python depuis PyPI | Variable selon le serveur | Large choix de modèles, traitements par lots |
| Serveurs communautaires FLUX | Modèles FLUX | Script Python local | Variable selon le serveur | Configurations autogérées |
| Connecteur PicassoIA | Modèles d’image et de vidéo de PicassoIA | Connecteur ou URL http | URL des résultats après interrogation | Images et vidéo au même endroit |
mcp-image expose un seul outil generate_image qui gère la génération texte vers image et la retouche à partir d’une image d’entrée. Il propose des préréglages rapide, équilibré et qualité, ainsi que des formats allant jusqu’à 21:9. Vous définissez un seul identifiant pour le fournisseur de votre choix, ainsi qu’un dossier de sortie absolu.
create-image-mcp fonctionne uniquement avec OpenAI. Son outil create_image prend en charge des tailles allant jusqu’à 4K, des réglages de qualité, la transparence, plusieurs variantes par appel et des masques pour l’inpainting. Il enregistre sur le disque et répond avec un chemin, ce qui maintient bas le coût en tokens.
Les serveurs communautaires Replicate, comme mcp-server-replicate, exposent la génération texte vers image, image vers image et la retouche sur tous les modèles hébergés par Replicate, et l’un d’eux traite jusqu’à 5 images à la fois. Choisissez cette voie si vous changez souvent de modèle.
Le prix à payer avec tous les serveurs locaux, c’est la maintenance. Vous gérez les versions de Node ou de Python, vous payez directement le fournisseur et vous mettez le paquet à jour vous-même.
Un serveur hébergé supprime l’étape d’installation. Vous ajoutez une URL et un identifiant, et le fournisseur s’occupe du reste. Claude Code réessaie une connexion distante interrompue jusqu’à cinq fois avec des délais croissants, de sorte que les brèves coupures se résorbent sans votre intervention. Le revers est la dépendance à la disponibilité de quelqu’un d’autre et aux règles de son offre.
Claude Code charge aussi les connecteurs de votre compte claude.ai lorsque vous vous y connectez. Ils ont la priorité la plus basse, en dessous des serveurs local, projet et utilisateur, et définir ENABLE_CLAUDEAI_MCP_SERVERS=false permet de les désactiver.
PicassoIA vous donne la génération d’images, la retouche et la vidéo derrière un seul connecteur, ce qui convient aux projets qui ont besoin d’une image fixe et d’un court clip assorti.
Le connecteur PicassoIA propose neuf outils : generate_image, edit_image, generate_video_picassoia, generate_video_seedance, get_generation, list_generations, list_models, get_account et cancel_generation.
La génération est asynchrone. Un appel de génération renvoie un predict_id dès qu’un GPU accepte la tâche, et get_generation indique le statut jusqu’à ce qu’il affiche succeeded ou failed. Claude Code exécute cette boucle d’interrogation à votre place dès que vous demandez le résultat.
L’API développeur sous-jacente suit une conception de type Replicate. L’URL de base est https://api.picassoia.com/v1, l’authentification est un secret Bearer qui commence par pia_sk_, et les points d’accès principaux sont POST /v1/models/{owner}/{name}/predictions et GET /v1/predictions/{id}. Prévoyez votre travail en tenant compte de ces limites :
💡 Vérifiez d’abord votre offre. PicassoIA indique l’accès à l’API et au MCP sur sa page tarifaire, et les détails peuvent varier d’une offre à l’autre. Confirmez que votre offre l’inclut avant de construire un flux de travail autour.
| Modèle | Usage |
|---|---|
| PicassoIA Image | Travail quotidien de texte vers image |
| PicassoIA Image Editor Pro | Retouches et corrections sur une image existante |
| PicassoIA Video | Courts clips à partir d’un texte ou d’une image fixe |
| Seedance 2.5 Lite | Vidéo avec son, indiquée pour des clips jusqu’à 10 secondes |
Le catalogue plus large de PicassoIA compte beaucoup d’autres modèles d’image, dont GPT Image 2, Seedream 5 Lite, Flux 2 Pro et Nano Banana 2. Testez d’abord un prompt dans l’application web, choisissez le rendu qui vous plaît, puis demandez à Claude Code de le reproduire.
Pour la partie texte du travail, le même catalogue propose Claude Sonnet 5 et Claude Opus 4.7, utiles pour rédiger des variantes de prompt avant de les coller dans une session.
Une image fixe et un court clip vont souvent ensemble, par exemple une photo principale et une bannière en boucle. Demandez à Claude Code de générer l’image fixe avec PicassoIA Image, puis transmettez le résultat à un outil vidéo comme image de départ. Lancez une vidéo à la fois, car chaque tâche occupe une partie de vos cinq emplacements simultanés.
http avec l’URL affichée sur la page des connexions MCP de votre compte, à picassoia.com/en/mcp/accounts. PicassoIA ne publie pas cette URL sur ses pages publiques, copiez-la donc depuis votre compte.claude mcp list, ou tapez /mcp dans une session, et confirmez que PicassoIA s’affiche comme connecté.list_models.public/images/hero.jpg. »get_generation, puis récupère l’URL du résultat dans votre dossier et met à jour le balisage.edit_image avec PicassoIA Image Editor Pro pour modifier les tons et les détails.Les prompts d’image dans Claude Code ont un avantage sur un formulaire web : l’agent peut voir votre fichier. Profitez-en. Décrivez le rôle de l’image, et pas seulement son contenu, et indiquez le chemin du fichier ainsi que la taille, pour qu’aucune deuxième tentative ne soit nécessaire.
| Demande faible | Demande solide |
|---|---|
| « Fais une belle image d’en-tête » | « En-tête 16:9 pour la page tarifs, une tasse en céramique sur un bureau en noyer, lumière de fenêtre venant de la gauche, sans texte » |
| « Ajoute quelques images » | « Génère 3 images, une par titre de section dans features.html, et enregistre-les dans public/images/ » |
| « Corrige l’image » | « Modifie hero.jpg : tons plus chauds, supprime le câble en bas à gauche » |
Trois habitudes vous feront gagner le plus de temps :
CLAUDE.md de votre projet afin que chaque session démarre avec les mêmes réglages par défaut.## Images
- Generate images with the image-gen server, 16:9 unless the layout says otherwise
- Save to public/images/ with lowercase hyphenated names
- Write one-sentence alt text that describes the scene
- Photographic style, natural light, no text inside the image
💡 Astuce : Indiquez le dossier de sortie dans
CLAUDE.md, et non dans chaque prompt. Cette seule ligne empêche les fichiers d’atterrir à la racine de votre dépôt.
Exécutez la commande du serveur à la main dans un terminal normal. Une installation de Node manquante, une faute de frappe dans le nom du paquet ou une variable d’environnement non définie apparaissent immédiatement. Ensuite, vérifiez que -- se trouve entre les options de Claude et la commande du serveur. Sous Windows, ajoutez le wrapper cmd /c vu précédemment. Si le serveur est simplement lent à démarrer, augmentez la limite de démarrage, par exemple MCP_TIMEOUT=10000 claude, exprimée en millisecondes. Lancez ensuite /mcp reconnect all.
Si un résultat d’outil déclenche l’avertissement à 10 000 tokens, le serveur renvoie probablement des données d’image intégrées. Passez à un serveur qui enregistre sur le disque ou renvoie une URL. Relever le plafond avec MAX_MCP_OUTPUT_TOKENS=50000 claude fonctionne en dernier recours, mais cela consomme du contexte que vous préféreriez réserver au code.
Claude Code place en tâche de fond les appels d’outils qui dépassent deux minutes, et vous pouvez les suivre dans /tasks. Avec un connecteur asynchrone, une tâche lente signifie généralement une file d’attente saturée. Demander douze images d’un coup sur un compte limité à cinq prédictions simultanées revient à en faire attendre sept. Demandez cinq images à la fois, et utilisez cancel_generation pour une tâche dont vous n’avez plus besoin.
L’installation prend une dizaine de minutes : une commande, un choix de périmètre, un prompt de test. Ensuite, chaque page que Claude Code construit peut être livrée avec ses propres photos au lieu d’espaces réservés vides.
Commencez petit. Testez un prompt dans PicassoIA Image, affinez un résultat avec PicassoIA Image Editor Pro, puis animez votre préféré avec PicassoIA Video. Quand le rendu vous convient, transmettez le même prompt à Claude Code et laissez-le exécuter la boucle dans votre projet. Parcourez la liste complète des modèles sur picassoia.com/en/all-models et créez vos propres images avec PicassoIA dès aujourd’hui.
Choisissez votre langue
