« Blender MCP » désigne le plus souvent MCP for Blender, un projet open source de Siddharth Ahuja qui permet à un agent IA de piloter une copie de Blender ouverte. Il s'appelait blender-mcp jusqu'en novembre 2026, et la plupart des tutoriels utilisent encore ce nom. Une fois connecté, Claude Code, Codex, Cursor ou Claude Desktop peuvent créer et modifier des objets, appliquer des matériaux, regarder le viewport et exporter des fichiers, le tout depuis un prompt de chat.
Ce guide explique ce que c'est, comment l'installer dans Claude Code et Codex, puis un exemple complet : un agent construit dans Blender un prop low-poly pour un jeu, l'exporte en GLB, le fichier est compressé avec glTF-Transform et three.js le charge dans un jeu de navigateur. Nous avons vérifié chaque commande dans le README du projet et dans la documentation officielle le 21 novembre 2026. Nous n'avons pas exécuté nous-mêmes l'installation ni l'exemple : considérez les résultats décrits ci-dessous comme ce que la documentation dit qu'il doit se passer.
Ce qu'est Blender MCP
MCP (Model Context Protocol) est une façon standard de donner à un agent IA des outils qui agissent sur un autre programme. MCP for Blender comporte deux parties :
- Un add-on Blender qui ouvre un serveur de sockets dans Blender (port 9876 par défaut) et exécute les commandes qu'il reçoit.
- Un serveur MCP (le paquet Python
mcp-for-blender) que votre agent lance en arrière-plan. Il transmet les appels d'outils de l'agent à l'add-on.
L'agent travaille surtout en écrivant du Python Blender et en l'exécutant dans votre fichier Blender ouvert. Le README liste neuf outils. Ceux que vous verrez le plus sont execute_blender_code (exécute du Python dans Blender), look (prend des vues du viewport, de la caméra ou sous plusieurs angles pour que l'agent vérifie son propre travail), get_scene_info (un résumé de la scène) et search_assets / import_asset (récupèrent des modèles, textures et HDRI depuis Poly Haven, Sketchfab et Poly Pizza). Il y a aussi generate_3d, qui crée un modèle avec Meshy, Tripo, Hunyuan3D ou Hyper3D Rodin.
Il n'est pas fait par Blender. Le README commence par « This is a third-party integration and not made by Blender » (c'est une intégration tierce, pas faite par Blender), et la description GitHub dit « Not affiliated with the official Blender Foundation. » (non affilié à la Blender Foundation). Il est sous licence MIT et comptait 35 153 étoiles sur GitHub le 21 novembre 2026.
Blender a pourtant son propre serveur MCP. Blender Lab, qui fait partie du projet Blender, en publie un plus petit sur projects.blender.org/lab/blender_mcp, documenté sur blender.org/lab/mcp-server. Son readme le qualifie de « deliberately small » (volontairement petit). Il se concentre sur la documentation de l'API Python de Blender, les résumés de scène et de fichiers, les captures d'écran et l'exécution de code. Il exige Blender 5.1 ou plus récent, est sous GPL-3.0 et en était à la v1.0.3 (septembre 2026). Il figure aussi dans l'annuaire de connecteurs de Claude sous le nom « Blender », par Blender Lab. Nous en parlons dans Alternatives.
Ce qu'il vous faut
- Blender 3.0 ou plus récent pour MCP for Blender (l'add-on déclare la 3.0 comme minimum).
- Python 3.10 ou plus récent et uv, l'outil qui lance le serveur avec
uvx. L'installeur en une ligne ci-dessous installe uv pour vous. - Un agent compatible MCP : Claude Code, Codex, Cursor, Claude Desktop, VS Code, OpenCode, Windsurf ou Antigravity, selon le README.
- Pour la partie jeu : Node.js (pour glTF-Transform) et un projet three.js.
L'installation rapide (tous les clients d'un coup)
Le chemin recommandé par le README est une commande qui installe uv, repère les agents présents sur votre machine, vous laisse choisir lesquels configurer, puis installe et active l'add-on Blender. Elle ajoute seulement une entrée blender à chaque fichier de configuration et enregistre une copie .bak de chaque fichier modifié.
macOS / Linux :
curl -LsSf https://www.mcp-for-blender.com/install.sh | sh
Windows (PowerShell) :
irm https://www.mcp-for-blender.com/install.ps1 | iex
Si vous avez déjà uv :
uvx mcp-for-blender setup
Envoyer un script pris sur internet directement dans votre shell l'exécute avec les droits de votre utilisateur. Si vous préférez l'éviter, suivez les étapes manuelles ci-dessous, qui font la même chose morceau par morceau. Dans les deux cas, quittez complètement votre agent puis rouvrez-le ensuite.
Installer Blender MCP dans Claude Code
- Installez uv. Le README donne
brew install uvsur macOS,curl -LsSf https://astral.sh/uv/install.sh | shsur Linux etwinget install --id=astral-sh.uv -esur Windows. Il déconseillepip install uv, qui peut ne pas créer la commandeuvx. - Enregistrez le serveur dans Claude Code. Voici la commande du README :
claude mcp add blender uvx mcp-for-blender
- Vérifiez. La documentation MCP de Claude Code indique
claude mcp list(affiche un état comme « ✔ Connected ») etclaude mcp get blender, et le panneau/mcpdans une session montre la même chose.
Par défaut, claude mcp add enregistre le serveur pour le projet courant uniquement. Ajoutez --scope user pour l'utiliser dans tous les projets. La forme générale de la documentation place la commande du serveur après -- : claude mcp add [options] <name> -- <command> [args...]. Le -- est nécessaire si vous ajoutez des options comme --scope ou --env.
Pour désactiver la télémétrie d'usage anonyme du projet, le README indique de définir la variable d'environnement DISABLE_TELEMETRY=true pour le serveur. Dans Claude Code, on la passe avec --env avant le --.
Installer Blender MCP dans Codex
La CLI Codex, l'application de bureau Codex et l'extension d'IDE partagent un seul fichier de configuration, ~/.codex/config.toml : une seule configuration couvre donc les trois.
Serveur MCP simple. La commande du README :
codex mcp add blender -- uvx mcp-for-blender
Ou ajoutez-le à la main dans ~/.codex/config.toml :
[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]
Lancez codex mcp list et vérifiez que blender apparaît comme activé. Les outils apparaissent au prochain démarrage de Codex, et /mcp dans l'interface terminal de Codex liste les serveurs actifs. La documentation MCP de Codex d'OpenAI décrit aussi une table env pour les variables d'environnement, startup_timeout_sec (10 par défaut) et tool_timeout_sec (60 par défaut). Dans l'application de bureau, allez dans Settings → MCP servers → Add server, nommez-le blender, choisissez STDIO et saisissez uvx mcp-for-blender.
Plugin Codex. Le README recommande cette voie pour Codex. Elle ajoute un viewport Blender en direct dans le chat, des sélecteurs à vignettes pour Poly Haven, Sketchfab et Poly Pizza, et des mentions avec @ pour les objets de la scène. Il n'est pas encore dans l'annuaire de plugins de Codex, donc on l'ajoute depuis le dépôt :
git clone https://github.com/ahujasid/blender-mcp.git
codex plugin marketplace add ./blender-mcp/integrations/codex
Redémarrez ensuite Codex, installez MCP for Blender depuis l'annuaire de plugins et demandez à Codex de l'utiliser.
Cursor et les autres
Dans Cursor, ouvrez Settings → MCP et ajoutez un serveur global, ou créez .cursor/mcp.json dans votre projet, avec :
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"mcp-for-blender"
]
}
}
}
Sur Windows, le README utilise "command": "cmd" avec "args": ["/c", "uvx", "mcp-for-blender"]. Le README propose aussi des boutons d'installation en un clic pour Cursor et VS Code, et des blocs de configuration pour Claude Desktop, OpenCode et Antigravity. Il précise de ne lancer qu'une copie du serveur à la fois, par exemple Cursor ou Claude Desktop, mais pas les deux.
Connecter l'add-on Blender
L'installeur rapide le fait pour vous. À la main :
- Lancez
uvx mcp-for-blender install-addon. Il copie l'add-on dans le dossier d'add-ons de Blender sous le nomblender_mcp.py. - Dans Blender, ouvrez Edit → Preferences → Add-ons et activez Interface: MCP for Blender. S'il n'apparaît pas, redémarrez Blender, ou cliquez sur Install… et choisissez le fichier copié. Vous pouvez aussi télécharger
addon.pydepuis le dépôt et installer celui-ci. - Dans le viewport 3D, appuyez sur N pour ouvrir la barre latérale et trouvez l'onglet MCP for Blender. L'add-on démarre son serveur à l'ouverture de Blender. S'il ne tourne pas, cliquez sur Start MCP Server.
L'onglet de l'add-on sert à activer les fonctions optionnelles comme Poly Haven, Poly Pizza (demande une clé d'API gratuite) et les générateurs 3D.
Si votre agent n'arrive pas à se connecter : assurez-vous que Blender est ouvert avec l'add-on actif, et ne lancez pas vous-même uvx mcp-for-blender dans un terminal (le tableau de dépannage du README le déconseille). Les applications lancées depuis le Dock ou le menu Démarrer peuvent ne pas trouver uvx et échouer avec spawn uvx ENOENT. Pour corriger, utilisez comme commande le chemin complet donné par which uvx (macOS/Linux) ou where uvx (Windows). Si cela échoue encore, redémarrez l'agent et Blender.
Exemple complet : un prop low-poly pour un jeu, du prompt à three.js
Objectif : un coffre au trésor pour un jeu de navigateur, assez léger pour charger vite, dans un format que three.js lit directement. Nous avons écrit ce flux de travail à partir de la documentation et ne l'avons pas exécuté de bout en bout, donc les tailles de fichier et les résultats exacts varieront.
1. Enregistrez d'abord votre fichier Blender
Ouvrez un nouveau fichier Blender et enregistrez-le (par exemple chest.blend) avant que l'agent ne commence. L'agent modifie directement votre fichier, et l'avertissement du README lui-même est d'enregistrer toujours votre travail avant.
2. Donnez le prompt à l'agent
Dans Claude Code ou Codex, avec Blender ouvert et connecté :
Use the Blender MCP tools. In the current scene, build a low-poly treasure chest
for a browser game:
- About 1 m wide, 0.6 m deep, 0.7 m tall, sitting on the ground at z = 0,
origin at the bottom centre.
- A box body and a curved lid made from a half-cylinder with 8 segments,
plus metal bands and a lock plate. Keep it under 1,500 triangles.
- Flat-shaded materials using Principled BSDF base colours only
(dark wood, brass), no image textures.
- Apply all modifiers and transforms, join everything into one object named "Chest".
- Check it with the look tool from several angles and fix anything that
overlaps or floats.
- Then select only "Chest" and export it as a GLB to ./public/models/chest.glb.
Show me each script before you run it.
Quelques choix de ce prompt comptent pour les jeux. Les couleurs de base unies s'exportent proprement, car l'exportateur glTF prend la couleur de base sur le nœud Principled BSDF, d'après le manuel glTF de Blender. Un seul objet fusionné donne un seul maillage dans three.js. Placer l'origine en bas fait que le coffre repose au sol quand vous fixez sa position à y = 0. Un budget de triangles empêche l'agent d'ajouter de la subdivision.
3. L'étape d'export
L'agent écrit le Python Blender. L'export se termine généralement par un appel comme celui-ci, qui utilise les paramètres documentés dans l'API export_scene de Blender :
import bpy
bpy.ops.export_scene.gltf(
filepath="/path/to/your-game/public/models/chest.glb",
export_format='GLB', # single binary file: mesh, materials and images packed together
use_selection=True, # only the selected "Chest" object
export_apply=True, # apply modifiers on export
export_yup=True, # glTF's +Y up convention, which three.js also uses
)
Lisez ce script avant de l'approuver, comme pour chaque script que l'agent exécute. Vérifiez que le chemin pointe dans votre projet et que rien ne supprime ni n'écrase des fichiers auxquels vous tenez.
4. Compressez le GLB avec glTF-Transform
glTF-Transform est un outil en ligne de commande pour optimiser les fichiers glTF. Installez-le et lancez optimize. Ce sont les commandes de son README :
npm install --global @gltf-transform/cli
gltf-transform optimize input.glb output.glb --texture-compress webp
Pour notre coffre :
gltf-transform optimize public/models/chest.glb public/models/chest.opt.glb --texture-compress webp
Par défaut, optimize compresse la géométrie avec meshopt (--compress meshopt), limite les textures à 2048 px et aplatit le graphe de scène. Notre coffre n'a pas de textures d'image, donc --texture-compress webp n'a rien à faire ici, mais gardez-le pour les props qui en ont. Pour ne compresser que la géométrie, glTF-Transform propose aussi gltf-transform meshopt input.glb output.glb --level medium.
5. Chargez-le dans three.js
Un fichier compressé avec meshopt a besoin du décodeur meshopt. Sans lui, GLTFLoader lève l'erreur « setMeshoptDecoder must be called before loading compressed files ». Les imports ci-dessous sont ceux que three.js utilise dans ses propres exemples :
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import { MeshoptDecoder } from 'three/addons/libs/meshopt_decoder.module.js';
const loader = new GLTFLoader();
loader.setMeshoptDecoder(MeshoptDecoder);
const gltf = await loader.loadAsync('/models/chest.opt.glb');
const chest = gltf.scene;
chest.position.set(0, 0, -3); // origin is at the bottom, so y = 0 puts it on the floor
scene.add(chest);
Blender travaille en mètres, comme la plupart des scènes three.js, donc le coffre devrait se charger avec environ 1 m de large. S'il arrive couché sur le côté, l'export a probablement été fait sans export_yup. S'il est noir, votre scène a besoin de lumières : ajoutez une HemisphereLight ou une carte d'environnement.
6. Itérez
Gardez le fichier Blender ouvert et demandez des modifications, comme « fais que le couvercle s'ouvre de 40 degrés, en objet séparé nommé Lid » ou « ajoute un tas d'or à l'intérieur ». Relancez ensuite l'export et la commande optimize. Demandez à l'agent de garder le script d'export dans votre projet, pour retrouver les mêmes réglages à chaque fois.
Limites et sécurité
- Il exécute n'importe quel Python dans Blender. L'avertissement du README : « The
execute_blender_codetool allows running arbitrary Python code in Blender, which can be powerful but potentially dangerous. » (L'outilexecute_blender_codepermet d'exécuter du code Python arbitraire dans Blender, ce qui peut être puissant mais potentiellement dangereux.) Le Python de Blender peut lire et écrire tout fichier accessible à votre compte utilisateur. Demandez à l'agent de montrer les scripts avant de les lancer, et lisez-les. - Enregistrez votre fichier avant chaque session. Le même avertissement se termine ainsi : « ALWAYS save your work before using it. » (enregistrez TOUJOURS votre travail avant de l'utiliser). Gardez des versions au fil de l'eau (File → Save Incremental).
- Activez le mode sécurisé si vous n'avez pas besoin d'accès aux fichiers ou au réseau. Définissez
BLENDER_MCP_SAFE_MODE=1pour le serveur. Chaque script est alors vérifié avant de s'exécuter, et le code qui lit ou écrit des fichiers directement, lance d'autres programmes, utilise le réseau ou continue de tourner après la fin du script est bloqué. La modélisation, les matériaux, le rendu, l'enregistrement et l'import/export continuent de fonctionner. - Gardez-le sur localhost. Le socket de l'add-on n'a ni authentification ni chiffrement. Quiconque peut atteindre ce port peut exécuter du Python dans votre Blender. Ne l'exposez pas à un réseau en lequel vous n'avez pas confiance.
- Découpez les gros travaux en étapes. Le README indique que les opérations complexes peuvent demander des étapes plus petites, et que les délais dépassés se règlent en simplifiant la demande. Les téléchargements Poly Haven s'exécutent sur le thread principal de Blender, donc Blender se fige jusqu'à leur fin.
- Vérifiez les licences des assets. Poly Haven est en CC0. Environ 69 % de Poly Pizza est en CC-BY, qui exige de citer l'auteur. L'add-on écrit la mention de crédit sur les objets importés, ou vous pouvez chercher avec
licence="CC0". - Télémétrie. Par défaut, le serveur envoie un enregistrement d'usage anonyme : ID d'installation, ID de session, nom de l'outil, succès, durée, versions, système d'exploitation et horodatage. Vos prompts, votre code, vos captures d'écran et les données de scène ne sont collectés que si vous l'activez.
DISABLE_TELEMETRY=truedésactive tout.
Alternatives à Blender MCP
- Blender MCP de Blender Lab : le serveur propre à Blender. Il est plus petit et construit autour de la documentation de l'API Python, des résumés de scène et de fichiers, des captures d'écran et de l'exécution de code, avec un mode en arrière-plan pour les fichiers
.blend. Il exige Blender 5.1+ et est sous GPL-3.0. Son wiki le configure en clonant le dépôt et en le lançant avecuv --directory .../blender_mcp/mcp run blender-mcp. Choisissez-le si vous voulez le projet officiel et n'avez pas besoin de recherche d'assets ni de génération de modèles par IA. - Blender Agent Skills : 28 skills pour Blender 5.2 LTS+ (modélisation, UV, baking, rigging, animation, optimisation, export) pour Claude Code, Codex, OpenCode, Gemini CLI, Copilot et Cursor. MIT. Les skills apprennent à l'agent comment faire le travail. Un serveur MCP lui donne le contrôle de Blender. Vous pouvez utiliser les deux.
- blender-game-skills : des skills Claude Code qui mènent du concept art à des assets 3D riggés, prêts pour le jeu. MIT.
- Modèles tout faits. Pour les props courants, un modèle gratuit est souvent plus rapide que d'en générer un. Voir les GLB low-poly de Polyfork.
Notre liste de skills et de serveurs MCP pour créer des jeux couvre les équivalents pour Godot, Unity, Unreal et three.js.
FAQ
Blender MCP est-il gratuit ?
Oui. MCP for Blender est sous licence MIT et l'add-on est gratuit. Sa page Premium indique que toutes les fonctions marchent avec l'offre gratuite et que seule la génération 3D est payante. Vous pouvez utiliser Meshy, Tripo, Hunyuan3D, Hyper3D Rodin ou World Labs avec vos propres clés d'API, ou prendre Premium (à partir de 10 $/mois au 21 novembre 2026) pour les utiliser sans clés. Le serveur de Blender Lab est gratuit sous GPL-3.0. Vous payez toujours l'abonnement ou l'usage d'API de votre agent IA.
Blender MCP est-il sûr ?
Il est aussi sûr que le code que vous le laissez exécuter. L'agent exécute du Python dans Blender, et ce Python a l'accès aux fichiers de votre utilisateur. Enregistrez votre travail, lisez les scripts avant de les approuver, utilisez le mode sécurisé (BLENDER_MCP_SAFE_MODE=1) et gardez le port de l'add-on sur localhost. Installez-le depuis le dépôt officiel ou le script d'installation du projet lui-même, pas depuis une copie remise en ligne par quelqu'un d'autre.
Existe-t-il un serveur MCP officiel pour Blender ?
Oui. Blender Lab en publie un sur projects.blender.org/lab/blender_mcp, et l'annuaire de connecteurs de Claude le liste sous le nom « Blender », par Blender Lab. MCP for Blender, plus connu (anciennement blender-mcp), est un projet tiers qui n'est pas affilié à la Blender Foundation.
Blender MCP fonctionne-t-il avec Claude Code ?
Oui. Lancez claude mcp add blender uvx mcp-for-blender, ouvrez Blender avec l'add-on activé et vérifiez avec claude mcp list. Claude Desktop se configure plutôt avec un bloc JSON dans claude_desktop_config.json.
Blender MCP fonctionne-t-il avec Codex ?
Oui. Lancez codex mcp add blender -- uvx mcp-for-blender ou ajoutez [mcp_servers.blender] à ~/.codex/config.toml. Le README propose aussi un plugin Codex qui affiche un viewport Blender en direct à côté du chat.
Blender MCP fonctionne-t-il avec ChatGPT ?
Le README liste des clients de bureau et de programmation (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity), pas l'application ChatGPT. Codex est l'agent d'OpenAI pour cela. Le serveur dialogue avec un Blender qui tourne sur votre propre ordinateur, il faut donc un client capable de lancer un serveur MCP local.
Où est l'onglet Blender MCP ?
Dans le viewport 3D de Blender, appuyez sur N pour ouvrir la barre latérale. L'onglet s'appelle MCP for Blender. S'il manque, activez Interface: MCP for Blender dans Edit → Preferences → Add-ons.
Blender MCP ou une skill Blender ?
Un serveur MCP permet à l'agent d'agir sur un Blender en direct : créer des objets, regarder le viewport, exporter. Une skill apprend à l'agent les flux de travail et les conventions de Blender, ce qui aide aussi bien s'il travaille ensuite via MCP que s'il lance Blender sans interface en ligne de commande. Pour les assets de jeu, utiliser les deux fonctionne bien. Le serveur MCP construit, et un pack de skills comme Blender Agent Skills couvre les UV, l'optimisation et les réglages d'export.
Sources
Vérifiées le 21 novembre 2026 : README de mcp-for-blender, MCP for Blender Premium, Blender Lab blender_mcp et son wiki d'installation, documentation MCP de Claude Code, documentation MCP de Codex, API export_scene de Blender, manuel glTF 2.0 de Blender, CLI de glTF-Transform, GLTFLoader de three.js.


