SyntheticSynthetic/Docs
ProduitsNouveautés
Tableau de bord →

Blender MCP · Installation

Installation de Blender MCP

Blender MCP est un serveur qui s'exécute sur votre ordinateur et que votre client MCP lance (Claude Desktop, Cursor, Claude Code, Codex). Vous l'installez avec Synthetic Setup. Il communique avec Blender via l'add-on Synthetic Blender MCP, que vous activez une seule fois dans Blender. Vérifié sur Windows.

Prérequis

Blender5.1 ou 5.2 LTS
Node.js18 ou version supérieure
OSWindows 10/11 · macOS (bêta : peut contenir des erreurs)
Client MCPClaude Desktop, Cursor, Codex, ou tout autre client MCP
LicenceVotre clé de licence Blender MCP (voir /dashboard/licenses)

1. Installer avec Synthetic Setup

Téléchargez Synthetic Setup depuis /dashboard/downloads et lancez-le. Il détectera vos clients MCP (Claude Desktop, Cursor, Claude Code, Codex) et ajoutera Blender MCP à chacun d'eux avec votre licence déjà chargée.

Vous préférez modifier la configuration de votre client manuellement ? Le Guide de configuration du client MCP indique l'entrée exacte.

2. Redémarrez votre client MCP

Quittez votre client MCP et ouvrez-le à nouveau : les serveurs sont chargés au démarrage. La première fois, le serveur se télécharge en quelques secondes et, une fois votre licence vérifiée, installe l'add-on Blender sur votre ordinateur, dans C:\Users\YOUR_USER\.synthetic\mcp\blender-mcp\<version>\blender-addon\.

Synthetic Setup s'occupe également de Node.js : si votre ordinateur ne l'a pas, il l'ajoute pour vos clients MCP.

3. Activer l'add-on dans Blender

À effectuer une seule fois par version de Blender :

  1. Dans Blender, allez dans Édition → Préférences → Compléments.
  2. Ouvrez le menu en haut à droite de la liste, choisissez Installer depuis le disque… et sélectionnez le fichier synthetic_blender_mcp.py du dossier de l'étape 2.
  3. Vérifiez que « Synthetic Blender MCP » est activé dans la liste.

L'extension se lance avec Blender à chaque démarrage. Son statut est visible dans la barre latérale de la Vue 3D (appuyez sur N) → onglet Synthetic MCP.

L'extension est un logiciel libre sous licence GNU GPL version 3, comme l'exige Blender pour les extensions ; le serveur MCP est un logiciel propre à Synthetic et nécessite votre licence.

4. Essayez‑le

Une fois Blender ouvert, posez une question simple à votre client MCP :

Quelle version de Blender est ouverte et quels objets se trouvent dans la scène ?

S'il répond avec votre version de Blender et vos objets, tout fonctionne. Essayez ensuite quelque chose de plus complexe : créez une petite scène, éclairez-la et lancez le rendu.

Important : Blender doit être ouvert et l'add-on activé chaque fois que votre client MCP exécute un outil. Sinon, les outils indiqueront que Blender n'est pas connecté.