Blender MCP · Solución de problemas
Problemas y límites
Los problemas más comunes y cómo resolverlos, seguidos de los límites honestos del producto. Si el tuyo no está acá, abre un ticket de soporte.
Las herramientas dicen que Blender no está conectado
Síntoma: El cliente carga el servidor, pero las herramientas responden que Blender no contesta.
Solución: Abre Blender y comprueba que el complemento Synthetic Blender MCP esté activado (Editar → Preferencias → Complementos). Si no está en la lista, instálalo como se muestra en la guía de instalación.
Blender deja de responder un rato
Síntoma: La ventana de Blender se congela mientras corre una herramienta, por ejemplo durante un render o una simulación.
Solución: Es lo esperado: las herramientas corren en el hilo principal de Blender, así que un render largo mantiene ocupada la ventana hasta que termina. Espera; si mientras tanto una herramienta venció, pídele a tu cliente de IA que revise la escena antes de volver a intentar.
Error de licencia inválida
Síntoma: Las herramientas responden que falta la licencia o que no es válida, o los registros del cliente dicen que BLENDER_MCP_LICENSE no está definida.
Solución: La licencia de tu configuración no coincide con la de /dashboard/licenses. Vuelve a copiarla — revisa que no queden espacios al principio o al final al pegarla en el JSON — y reinicia el cliente MCP.
Las herramientas dejaron de funcionar después de una actualización
Síntoma: El servidor se actualizó solo y ahora las herramientas fallan cuando hablan con Blender.
Solución: Una actualización puede traer una versión nueva del complemento. Vuelve a instalarlo desde las Preferencias de Blender (ver la guía de instalación) y reinicia Blender.
El cliente dice que no encuentra Node.js
Síntoma: Tu cliente MCP no puede iniciar el servidor y sus registros mencionan node.
Solución: Vuelve a ejecutar Synthetic Setup (agrega Node.js para tus clientes MCP cuando falta), o instala Node.js (LTS) desde nodejs.org y reinicia el cliente.
Límites
Lo que Blender MCP no hace, o con lo que no se ha probado. Lo decimos aquí para que lo sepas antes de instalarlo.
- Verificado en Windows con Blender 5.1.2 y 5.2.2 LTS. macOS está en beta: no se probó por completo y puede tener errores. Linux y otras versiones de Blender todavía no se verificaron.
- Blender tiene que estar abierto, con el complemento activado, cada vez que tu cliente de IA usa una herramienta. Trabaja con una sola ventana de Blender abierta a la vez.
- Las herramientas corren en el hilo principal de Blender: durante un render o una simulación largos, Blender no responde hasta que terminan. Si una herramienta vence, el trabajo que Blender ya había empezado puede terminar igual.
- El servicio de descargas de Poly Haven es para uso no comercial salvo que tengas su licencia comercial gratuita. Los recursos de ambientCG (CC0) y los archivos que cargas desde tu propio disco no tienen esa restricción.
- Las herramientas que ejecutan Python o cualquier operador dentro de Blender pueden hacer todo lo que Blender puede, incluso borrar datos. Mantén tu trabajo guardado y deja que tu cliente de IA te pregunte antes de algo irreversible.
- El complemento es software libre (GNU GPL versión 3), como Blender exige para los complementos. El servidor MCP es software propio de Synthetic y necesita tu clave de licencia gratuita.
Si nada de esto ayuda
Abre un ticket en tu panel de soporte con: (1) tu versión de Blender, (2) tu cliente MCP y su versión, (3) los registros del cliente cuando intenta iniciar el servidor y (4) el fragmento de configuración que pegaste (sin la clave de licencia). También puedes preguntar en nuestro Discord.