Blender MCP: controla Blender con Claude y crea escenas 3D hablando

01 Qué es y cómo funciona

02 Qué puede hacer Claude dentro de Blender

03 Instalación rápida

curl -LsSf https://www.mcp-for-blender.com/install.sh | sh

powershell -ExecutionPolicy ByPass -c "irm https://www.mcp-for-blender.com/install.ps1 | iex"

uvx mcp-for-blender setup

04 Instalación manual, si el instalador falla

1. 1

   Instala uv con su instalador oficial

   En Mac, brew install uv; en Linux, el script de astral.sh. No uses pip install uv, porque puede no crear el comando uvx.

2. 2

   Registra el servidor en Claude

   En Claude Desktop: Ajustes, Desarrollador, Editar configuración, y añade la entrada blender al bloque mcpServers sin borrar las que ya tengas. En Claude Code basta con un comando.

3. 3

   Instala el complemento

   Con uvx mcp-for-blender install-addon, que lo copia a la carpeta de complementos de Blender.

4. 4

   Actívalo en Blender

   Edit, Preferences, Add-ons, y marca Interface: MCP for Blender.

5. 5

   Comprueba la conexión

   Pulsa N en el visor 3D, abre la pestaña MCP for Blender y, si no está en marcha, pulsa Start MCP Server.

{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["mcp-for-blender"]
    }
  }
}

claude mcp add blender uvx mcp-for-blender
uvx mcp-for-blender install-addon

05 Primeros prompts

Revisa primero qué hay en la escena de Blender. Después:
1. Borra el cubo por defecto.
2. Crea un pedestal cilíndrico blanco mate de 1 m de diámetro y 40 cm de alto.
3. Coloca encima una botella sencilla de vidrio verde de unos 30 cm.
4. Ilumina con un HDRI de estudio de Poly Haven a resolución 2k.
5. Pon la cámara a la altura de la botella, ligeramente picada, encuadre vertical 4:5.
Cuando termines, mira la escena desde la cámara en modo renderizado y dime qué mejorarías.

Quiero una maqueta rápida de una oficina de 8 × 5 m con 3 m de altura. Necesito: una mesa de reuniones para 6 personas, 4 puestos de trabajo junto a la pared larga y una zona de sofá en una esquina. Usa modelos low-poly con licencia CC0 cuando existan; si no, crea formas simples. Dame al final una vista isométrica y otra cenital, y lista los modelos importados con su licencia.

No borres nada de la escena. Revisa con get_scene_info qué objetos tienen materiales por defecto y asígnales materiales coherentes con el resto. Haz los cambios de uno en uno y enséñame una vista desde la cámara al acabar.

06 Seguridad, licencias y errores típicos

• ✓Error spawn uvx ENOENT: la app no encuentra uvx. Usa la ruta completa (which uvx en Mac o Linux, where uvx en Windows) en el campo command.
• ✓No ejecutes uvx mcp-for-blender en la terminal para conectar: lo lanza tu cliente de IA.
• ✓Ejecuta una sola instancia del servidor: no lo tengas activo en Claude Desktop y en Cursor a la vez.
• ✓Si Blender se congela al descargar de Poly Haven, pide texturas a 1k o 2k.
• ✓Cerca del 69 % de los modelos de Poly Pizza son CC-BY y exigen citar al autor; filtra por CC0 si no quieres atribuciones.
• ✓Telemetría: por defecto envía un registro anónimo de uso; desactívala del todo con DISABLE_TELEMETRY=true en el bloque env de la configuración.
• ✓Para actualizar: uvx mcp-for-blender@latest update, y reinicia el cliente y Blender.