Blender MCP · Dépannage
Dépannage et limites
Les problèmes les plus courants et comment les résoudre, suivis des limites réelles du produit. Si le vôtre n'est pas listé ici, ouvrez un ticket de support.
Les outils indiquent que Blender n'est pas connecté
Symptôme : Le client charge le serveur, mais les outils répondent que Blender ne répond pas.
Solution : Ouvrez Blender et vérifiez que l'extension Synthetic Blender MCP est activée (Édition → Préférences → Extensions). Si elle ne figure pas dans la liste, installez-la comme indiqué dans le guide d'installation.
Blender ne répond plus pendant un moment
Symptôme : La fenêtre de Blender gèle pendant l'exécution d'un outil, par exemple lors d'un rendu ou d'une simulation.
Solution : C'est un comportement normal : les outils s'exécutent sur le thread principal de Blender, donc un rendu prolongé bloque la fenêtre jusqu'à la fin de l'opération. Patientez ; si un outil a expiré entre-temps, demandez à votre client IA de vérifier la scène avant de réessayer.
Erreur de licence invalide
Symptôme : Les outils répondent que la licence est manquante ou invalide, ou les journaux du client indiquent que BLENDER_MCP_LICENSE n'est pas configuré.
Solution : La licence dans votre configuration ne correspond pas à celle sur /dashboard/licenses. Recopiez-la — vérifiez l'absence d'espaces au début ou à la fin lors du collage dans le JSON — puis redémarrez le client MCP.
Les outils ont cessé de fonctionner après une mise à jour
Symptôme : Le serveur s'est mis à jour et les outils échouent désormais lors de la communication avec Blender.
Solution : An update can bring a new version of the add-on. Install it again from Blender's Preferences (see le guide d'installation) and restart Blender.
Le client indique que Node.js n'a pas été trouvé
Symptôme : Votre client MCP ne parvient pas à démarrer le serveur et ses journaux mentionnent node.
Solution : Lancez à nouveau Synthetic Setup (il ajoute Node.js pour vos clients MCP lorsqu'il est manquant), ou installez Node.js (LTS) depuis nodejs.org et redémarrez le client.
Limitations
Ce que Blender MCP ne fait pas, ou n'a pas été testé avec. Nous le disons ici pour que vous le sachiez avant de l'installer.
- Vérifié sur Windows avec Blender 5.1.2 et 5.2.2 LTS. macOS est en bêta : il n'a pas été entièrement testé et peut contenir des erreurs. Linux et les autres versions de Blender n'ont pas encore été vérifiés.
- Blender doit être ouvert, avec l'add-on activé, chaque fois que votre client IA exécute un outil. Travaillez avec une seule fenêtre Blender ouverte à la fois.
- Les outils s'exécutent sur le thread principal de Blender : lors d'un rendu ou d'une simulation prolongée, Blender ne répond pas tant que l'opération n'est pas terminée. Si un outil expire (timeout), le travail que Blender a déjà commencé peut tout de même s'achever.
- Le service de téléchargement de Poly Haven est destiné à un usage non commercial, sauf si vous possédez leur licence commerciale gratuite. Les ressources ambientCG (CC0) et les fichiers que vous chargez depuis votre propre disque n'ont pas cette restriction.
- Les outils qui exécutent du Python ou tout opérateur à l'intérieur de Blender peuvent faire tout ce que Blender peut faire, y compris supprimer des données. Gardez votre travail sauvegardé et demandez à votre client IA de vous consulter avant toute action irréversible.
- L'extension est un logiciel libre (GNU GPL version 3), comme l'exige Blender pour les extensions. Le serveur MCP est un logiciel propre à Synthetic et nécessite votre clé de licence gratuite.
Si aucune de ces solutions ne fonctionne
Ouvrez un ticket sur votre espace Assistance en précisant : (1) votre version de Blender, (2) votre client MCP et sa version, (3) les logs du client lors de la tentative de lancement du serveur, et (4) l'extrait de configuration que vous avez collé (sans la clé de licence). Vous pouvez également poser vos questions sur notre Discord.