Nano Banana MCP pour Claude Code : installation, skill et tarifs

Votre agent de code peut créer une page d’accueil en une minute, puis bloquer parce que l’image principale n’existe pas encore. Un serveur Nano Banana MCP comble ce manque. Vous l’enregistrez une fois dans Claude Code, vous demandez une image en langage courant, et le fichier atterrit dans le dossier de votre projet pendant que vous continuez à travailler. Vous trouverez ci-dessous les commandes exactes d’installation, un fichier skill réutilisable, une liste de contrôle de sécurité et les prix par image publiés en octobre 2026, afin de décider en dix minutes si l’outil mérite une place dans votre chaîne d’outils.

Ce qu’est vraiment Nano Banana

« Nano Banana » est à l’origine le surnom du modèle Gemini 2.5 Flash Image de Google, et il est devenu la marque de toute la gamme. Voici les quatre noms que vous rencontrerez dans les grilles tarifaires :

Pourquoi l’intégrer à Claude Code

Claude Code lit déjà votre dépôt, modifie des fichiers et exécute des commandes. Il ne peut pas peindre. Un serveur d’images lui fournit un outil generate_image, si bien que la session qui écrit le composant produit aussi l’image principale, la carte pour les réseaux sociaux et l’illustration d’état vide, puis les intègre par chemin de fichier. Plus besoin de changer d’onglet, de dossier de téléchargements ni de renommer les image (3).png.

Tâches typiques adaptées :

• Images d’accroche et d’articles de blog générées à côté de la page qui les utilise
• Maquettes de produits placées dans différentes pièces, saisons et lumières
• Retouches de photos existantes : changer l’arrière-plan, corriger la lumière, supprimer un élément parasite
• Illustrations provisoires pour des prototypes, remplacées plus tard

Ce qu’il fait bien et mal

Il suit de près de longs prompts descriptifs, maintient un sujet stable sur plusieurs retouches et rend correctement les textes courts. Nano Banana 2 peut aussi ancrer un prompt dans une recherche web en temps réel, ce qui est utile lorsqu’une image doit correspondre à un événement de la semaine.

Il est moins performant avec les typographies denses, les couleurs de marque exactes et la conservation d’un même visage à l’identique sur cinquante images. Considérez le premier résultat comme un brouillon et prévoyez une seconde passe.

Comment fonctionne le lien MCP

Le Model Context Protocol est un standard ouvert qui permet à un client d’IA d’appeler des outils externes. Trois éléments entrent en jeu :

1. Claude Code, le client qui décide quand un outil est nécessaire.
2. Le serveur MCP, un petit processus Node ou Python sur votre machine que Claude Code lance à la demande.
3. L’API Gemini de Google, où l’image est réellement générée.

Vous demandez une image. Claude Code appelle un outil nommé de la forme mcp__nanobanana__generate_image. Le serveur envoie votre prompt à un modèle d’image Gemini, enregistre le résultat sur le disque et renvoie un chemin de fichier. Cette dernière étape compte davantage qu’il n’y paraît.

💡 Pourquoi les chemins valent mieux que les données brutes : Claude Code limite la quantité de sortie qu’un outil MCP peut renvoyer (vous pouvez augmenter cette limite avec la variable d’environnement MAX_MCP_OUTPUT_TOKENS). Une image en base64 épuiserait vite le contexte. La fiche @nanobanana/mcp indique qu’il renvoie des chemins de fichiers à la place, ce qui garde votre session légère.

Quel serveur choisir

Plusieurs serveurs communautaires existent. Aucun ne provient d’Anthropic ou de Google.

Les exemples ci-dessous utilisent @nanobanana/mcp parce que c’est le plus simple : trois outils et une variable. Les autres fonctionnent de la même manière, avec un autre nom de paquet et une autre variable.

Installation en cinq minutes

Obtenir un token Gemini

Ouvrez la page API dans Google AI Studio (aistudio.google.com/apikey) et créez un token. Une offre gratuite existe, mais les synthèses tarifaires notent que les générations gratuites peuvent être utilisées par Google pour améliorer ses produits. Utilisez un projet payant pour les travaux clients ou les images privées.

Enregistrer le serveur

Sur macOS, Linux ou WSL, exécutez :

claude mcp add nanobanana -e GEMINI_API_KEY=your_token_here -- npx -y @nanobanana/mcp

Copier le prompt

Sous Windows natif, il faut le wrapper cmd /c pour que Claude Code puisse lancer npx :

claude mcp add nanobanana -e GEMINI_API_KEY=your_token_here -- cmd /c npx -y @nanobanana/mcp

Copier le prompt

Vous choisissez aussi une portée. Locale est la valeur par défaut et s’applique à vous dans ce projet. Ajoutez --scope project pour écrire un .mcp.json partagé que toute l’équipe utilise, ou --scope user pour rendre le serveur disponible dans tous les projets.

💡 Placez chaque option avant le double tiret. Tout ce qui suit est transmis à npx, et non à Claude Code, ce qui est la raison la plus fréquente pour laquelle un serveur neuf ne se connecte pas.

Vérifier la connexion

Exécutez claude mcp list, puis ouvrez Claude Code et tapez /mcp. L’entrée nanobanana doit afficher connected. Testez maintenant avec une vraie requête :

Générez une photo 16:9 d’une banane mûre sur un bureau en bois, à la lumière matinale d’une fenêtre, et enregistrez-la dans public/images/test.jpg

Si un chemin de fichier revient et que l’image s’ouvre, le lien fonctionne. Le premier appel peut prendre plus de temps, car npx télécharge le paquet ; les appels suivants démarrent plus vite.

Garder les secrets hors de la conversation

Votre token doit se trouver dans une variable d’environnement et nulle part ailleurs. Ne le collez jamais dans un prompt, un fichier skill ou une configuration versionnée. Pour un .mcp.json partagé, référencez la variable au lieu de la valeur :

{
  "mcpServers": {
    "nanobanana": {
      "command": "npx",
      "args": ["-y", "@nanobanana/mcp"],
      "env": { "GEMINI_API_KEY": "${GEMINI_API_KEY}" }
    }
  }
}

Copier le prompt

Claude Code développe la variable à partir de votre shell au démarrage du serveur, si bien que chaque coéquipier utilise son propre token et que le dépôt reste propre.

💡 Ces serveurs sont des projets communautaires. npx -y télécharge et exécute du code avec votre token dans son environnement. Ouvrez le dépôt, vérifiez le mainteneur et les derniers commits, et épinglez une version (@nanobanana/mcp@<version>) avant de lui faire confiance.

Construire un skill autour

Le serveur donne à Claude Code la capacité de dessiner. Un skill lui indique comment vous voulez que les choses soient dessinées. Un skill est un dossier contenant un fichier SKILL.md, placé dans .claude/skills/nano-banana/ pour un seul projet ou dans ~/.claude/skills/nano-banana/ pour tous. Le fichier commence par un court en-tête YAML qui porte deux champs, name et description. Claude lit la description pour décider quand le skill s’applique et ne charge le corps qu’à ce moment-là, si bien que le skill ne coûte presque rien tant qu’il n’est pas nécessaire.

Ce qu’il faut mettre dans SKILL.md

Rédigez la description comme un déclencheur : « Générer ou modifier des images avec le serveur Nano Banana MCP. À utiliser lorsque l’utilisateur demande une image d’accroche, une miniature, une maquette ou une illustration. » Placez ensuite vos règles dans le corps :

# Nano Banana image rules

1. Write one prompt before calling the tool: subject, action, setting, camera and lens, lighting, mood.
2. Describe what should be in the frame. Do not list things to avoid.
3. Use 16:9 for hero images and 1:1 for thumbnails.
4. Save files in public/images/ with a kebab-case name that matches the page slug.
5. Generate one image, check it, then ask before making variations.
6. Never request more than 4 images in one turn without confirmation.
7. Add descriptive alt text wherever an image is used.
8. Never print, log, or commit the API token.

Copier le prompt

Les règles 5 et 6 comptent le plus. Ce sont vos freins de coût, et la section suivante montre pourquoi.

Une vraie session se déroule ainsi : vous dites « ajoute une image d’accroche à la page tarifs ». Claude Code lit la page, charge le skill, rédige un seul prompt détaillé, appelle generate_image, reçoit un chemin et modifie la balise <img> avec un texte alternatif. Vous relisez une image au lieu de huit.

Une formule de prompt qui fonctionne

Suivez cet ordre : sujet, action, décor, éclairage, caméra, texture. Par exemple :

Un boulanger sortant un plateau de pain au levain d’un four en pierre, de la farine sur les avant-bras, une cuisine rustique avec des casseroles en cuivre, une lumière chaude venant de la fenêtre à gauche, objectif 50 mm à f/2, faible profondeur de champ, texture visible de la croûte, couleurs naturelles.

Limitez le texte présent dans l’image à un ou deux mots. Pour les retouches, demandez un seul changement par instruction (« rendez le ciel couvert »), vérifiez le résultat, puis demandez le suivant.

Ce que cela coûte réellement

Le modèle d’image ne représente qu’une ligne de votre facture. L’usage de Claude Code est facturé séparément via votre offre Anthropic ou votre usage d’API, et Google facture la partie Gemini.

Prix par image selon le modèle

Les observatoires de prix publics indiquent ces chiffres en date d’octobre 2026 :

Les prix évoluent, vérifiez-les donc sur la page tarifaire de Google avant d’engager un budget. Certains observatoires ajoutent aussi une facturation par image de référence importée, ce qui signifie que les travaux de retouche intensive coûtent plus cher que ne le laisse supposer le prix de sortie.

Un budget mensuel de 120 images

Imaginons un blog qui publie 20 articles par mois avec 6 images chacun :

Ces totaux supposent que vous gardez chaque image. Si vous en rejetez la moitié, doublez-les. Trois habitudes permettent de maintenir ce chiffre bas :

• Brouillonnez à bas coût, finalisez en qualité supérieure. Itérez sur le modèle d’origine ou Lite et ne générez que la version retenue sur Pro.
• Groupez tout ce qui peut attendre. Le tarif batch représente la moitié du tarif standard dans les observatoires cités plus haut.
• Limitez la boucle. Les règles 5 et 6 de votre skill empêchent Claude de produire une douzaine de variantes non demandées.

Résoudre les problèmes courants

Le serveur apparaît en échec ou manquant

Passez en revue ces points dans l’ordre :

1. Exécutez claude mcp get nanobanana pour voir la commande et l’environnement que Claude Code a enregistrés.
2. Exécutez node --version. Le serveur a besoin de Node installé pour que npx fonctionne.
3. Sous Windows natif, vérifiez que la commande est cmd /c npx.
4. Réajoutez le serveur avec l’option -e avant le double tiret.
5. Redémarrez votre session Claude Code. Les serveurs se chargent au démarrage.

Les images arrivent mais semblent incorrectes

Des prompts vagues donnent des résultats de type photos de banques d’images, alors ajoutez un objectif, une direction de lumière et un détail de texture. Un texte illisible signifie trop de mots : réduisez-le à un ou deux. Une forme erronée signifie généralement que le format n’a jamais atteint l’outil, indiquez-le donc dans la demande. Lorsqu’une retouche dérive, modifiez une seule chose à la fois et conservez la bonne version avant la passe suivante.

Comment utiliser Nano Banana sur PicassoIA

Si vous préférez vous passer du token et du terminal, Nano Banana 2 fonctionne dans votre navigateur sur Picasso IA. La page du modèle indique des générations illimitées sans crédits par génération, ce qui en fait un lieu pratique pour tester des prompts avant de payer des appels d’API. Les exemples lancés sur cette page se sont terminés en environ 20 à 28 secondes chacun, si bien qu’itérer coûte peu en temps comme en argent.

Nano Banana 2 pas à pas

1. Ouvrez la page du modèle et cliquez dans la zone de prompt.
2. Décrivez la scène en phrases complètes : sujet, décor, lumière, objectif.
3. Vous pouvez éventuellement importer jusqu’à 14 images de référence pour mélanger des styles ou garder un personnage cohérent.
4. Choisissez un format. La valeur par défaut est match_input_image, et 15 options sont disponibles, dont 16:9, 9:16, 4:5 et 21:9.
5. Choisissez une résolution : 1K par défaut, avec 2K et 4K disponibles. Les réglages plus élevés prennent plus de temps.
6. Sélectionnez une sortie jpg ou png.
7. Activez l’ancrage Google Search ou Image Search lorsque l’image doit refléter l’actualité ou de vrais lieux.
8. Générez, puis affinez en tapant une suite comme « rendez l’arrière-plan couvert » au lieu de réécrire tout le prompt.

Quand choisir Pro

Nano Banana Pro accepte également 14 images de référence, produit une sortie en 1K, 2K (par défaut) ou 4K, et ajoute un réglage safety_filter_level. Sa page indique qu’il est gratuit à utiliser, et ses exemples ont pris de 18 à 113 secondes, donc attendez-vous à ce qu’il soit plus lent. Tournez-vous vers lui lorsqu’une image d’accroche finale a besoin d’un maximum de détails, et utilisez Nano Banana pour les retouches rapides.

La rédaction des prompts peut aussi être déléguée. Un modèle de chat comme Claude Sonnet 5 peut transformer une idée brute en sujet, action et formule d’éclairage, tandis que Claude Opus 4.7 convient aux briefs plus longs. Lorsqu’une scène doit bouger, décrivez le mouvement pour un court clip dans Veo 3.1 Fast ou Gemini Omni 1.1.

Essayez votre première image dès aujourd’hui

Vous disposez maintenant de la boucle complète : un token, une commande claude mcp add, un skill qui garde les prompts cohérents et un budget que vous pouvez défendre. Le moyen le plus rapide de sentir la différence entre les modèles consiste à passer le même prompt dans chacun d’eux.

Ouvrez Picasso IA, choisissez Nano Banana 2 et collez le prompt du boulanger présenté plus haut. Changez ensuite un détail, l’objectif ou la lumière, et générez à nouveau. Dix minutes de ce travail apprendront à votre fichier skill plus que n’importe quel guide. Commencez par une seule scène dont vous avez réellement besoin cette semaine, puis construisez à partir de là.