SyntheticSynthetic/Docs
ProductosNovedades
Panel →

Blender MCP · Instalación

Instalar Blender MCP

Blender MCP es un servidor que corre en tu computadora y que tu cliente MCP inicia (Claude Desktop, Cursor, Claude Code, Codex). Lo instalas con Synthetic Setup. Habla con Blender a través del complemento Synthetic Blender MCP, que activas una vez en Blender. Verificado en Windows.

Requisitos

Blender5.1 o 5.2 LTS
Node.js18 o superior
OSWindows 10/11 · macOS (beta: puede tener errores)
Cliente MCPClaude Desktop, Cursor, Codex o cualquier cliente MCP
LicenciaTu clave de licencia de Blender MCP (ver /dashboard/licenses)

1. Instálalo con Synthetic Setup

Descarga Synthetic Setup desde /dashboard/downloads y ejecútalo. Encuentra tus clientes MCP (Claude Desktop, Cursor, Claude Code, Codex) y agrega Blender MCP a cada uno con tu licencia ya cargada.

¿Prefieres editar la configuración de tu cliente a mano? La guía de configuración del cliente MCP muestra la entrada exacta.

2. Reinicia tu cliente MCP

Cierra tu cliente MCP y vuelve a abrirlo: los servidores se cargan al iniciar. La primera vez, el servidor se descarga en unos segundos y, una vez comprobada tu licencia, deja el complemento de Blender en tu computadora, en C:\Users\YOUR_USER\.synthetic\mcp\blender-mcp\<version>\blender-addon\.

Synthetic Setup también se ocupa de Node.js: si tu computadora no lo tiene, lo agrega para tus clientes MCP.

3. Activa el complemento en Blender

Hazlo una vez por cada versión de Blender:

  1. En Blender, abre Editar → Preferencias → Complementos.
  2. Abre el menú de arriba a la derecha de la lista, elige Instalar desde disco… y selecciona el archivo synthetic_blender_mcp.py de la carpeta del paso 2.
  3. Comprueba que «Synthetic Blender MCP» esté activado en la lista.

El complemento arranca con Blender cada vez. Su estado está en la barra lateral de la Vista 3D (tecla N) → pestaña Synthetic MCP.

El complemento es software libre bajo la GNU GPL versión 3, como Blender exige para los complementos; el servidor MCP es software propio de Synthetic y necesita tu licencia.

4. Pruébalo

Con Blender abierto, pídele algo simple a tu cliente MCP:

¿Qué versión de Blender está abierta y qué objetos hay en la escena?

Si responde con tu versión de Blender y tus objetos, todo funciona. Después prueba algo más grande: arma una escena chica, ilumínala y renderízala.

Importante: Blender tiene que estar abierto, con el complemento activado, cada vez que tu cliente MCP usa una herramienta. Si no, las herramientas responden que Blender no está conectado.