Blender MCP es un addon open source que conecta Claude directamente con Blender a través del Model Context Protocol, permitiendo controlar escenas 3D completas con instrucciones en lenguaje natural. Esta guía cubre la instalación completa, configuración de Claude Desktop y los prompts más útiles para empezar a crear objetos, materiales e iluminación sin escribir código. Útil para diseñadores, artistas 3D y founders que quieren experimentar con flujos de trabajo creativos asistidos por IA.
Blender es un programa gratuito y profesional para crear modelos 3D, animaciones y escenas completas. El problema históricamente es su curva de aprendizaje: atajos de teclado, nodos de shaders, geometría de vértices. Blender MCP elimina esa barrera conectando Claude directamente con el software para que puedas crear con instrucciones escritas.
El puente técnico es el Model Context Protocol (MCP): un estándar que permite a Claude comunicarse con herramientas externas. En este caso, Claude recibe tu instrucción, la traduce a comandos de la API de Python de Blender, y ejecuta los cambios en tiempo real dentro de tu escena. Escribes "crea una mesa de madera con 4 sillas alrededor" y los objetos aparecen en el viewport.
El proyecto es open source, con licencia MIT, creado por @ahujasid. Gratuito, modificable, sin suscripción adicional.
Cuatro componentes antes de empezar:
Blender 3.0 o superior — Descarga desde blender.org/download. Compatible con Mac, Windows y Linux.
Python 3.10 o superior — Blender lo incluye internamente, pero el servidor MCP necesita Python del sistema. Verifica con:
python3 --version
Si no está instalado, descárgalo desde python.org.
uv (gestor de paquetes) — Herramienta que descarga e instala automáticamente los paquetes Python que el servidor MCP necesita.
macOS / Linux:
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows (PowerShell):
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
Claude Desktop — La app de escritorio, no la versión web. Descarga desde claude.ai/download. El servidor MCP solo funciona con la aplicación de escritorio.
El addon es un archivo addon.py que se descarga del repositorio de GitHub y se instala dentro de Blender como cualquier extensión.
Paso 1: Descarga el archivo addon.py desde el repositorio GitHub del proyecto (busca "blender-mcp" en GitHub, usuario ahujasid).
Paso 2: Abre Blender → menú Edit → Preferences.
Paso 3: En la ventana de preferencias, ve a la pestaña "Add-ons" en el menú izquierdo. Haz clic en "Install..." y selecciona el archivo addon.py que descargaste.
Paso 4: Busca "Interface: Blender MCP" en el listado de addons y activa el checkbox.
Paso 5: Cierra las preferencias. En el viewport principal, presiona la tecla N para abrir la barra lateral derecha. Aparece la pestaña "BlenderMCP" mostrando el puerto 9876 y el botón "Start MCP Server".
Claude Desktop necesita saber que existe un servidor MCP para Blender. Esto se configura en un archivo JSON.
Ubica el archivo de configuración:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Tip: en Finder, presiona Cmd+Shift+G y pega esa ruta.
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Tip: en el Explorador de archivos, escribe %APPDATA%\Claude en la barra de direcciones.
Edita el archivo con cualquier editor de texto (VS Code, Notepad, TextEdit) y agrega esta configuración:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp"]
}
}
}
Si ya tienes otros servidores MCP configurados en el archivo, no reemplaces todo el contenido. Solo agrega el bloque "blender" dentro del objeto "mcpServers" existente.
Reinicia Claude Desktop completamente (cierra, no minimices) para que cargue la nueva configuración.
Con todo instalado:
Abre Blender → presiona N → pestaña BlenderMCP → verifica que el puerto sea 9876 → clic en "Start MCP Server".
Abre Claude Desktop. En la barra inferior del chat aparece un ícono de herramientas o martillo. Eso indica que Claude detectó el servidor de Blender y está listo.
Escribe tu primera instrucción: Crea un cubo rojo en el centro de la escena. Claude usa el servidor MCP para enviar el comando a Blender y el objeto aparece en el viewport.
Si no aparece el ícono MCP en Claude Desktop:
uv está instalado: uvx --version en la terminalUna vez conectado, Claude tiene acceso a estas capacidades:
Crear y modificar objetos 3D — Cubos, esferas, cilindros, modelos complejos. Puede cambiar posición, escala y rotación de cualquier objeto existente.
Aplicar materiales y colores — Materiales metálicos, de vidrio, madera, plástico. Claude configura los nodos de shader en Cycles o EEVEE directamente.
Iluminar escenas — Area lights, point lights, ambient occlusion, setups de tres puntos como en fotografía profesional.
Inspeccionar la escena — Claude puede leer todos los objetos, sus posiciones, materiales y propiedades. Útil para auditar escenas complejas.
Ejecutar Python directamente — Acceso completo a la API de Blender para operaciones avanzadas y scripts personalizados.
Descargar assets de Poly Haven — Modelos, texturas y HDRIs gratuitos, descargados e integrados automáticamente a la escena.
Generar modelos 3D con IA — Integración con Hyper3D Rodin y Hunyuan3D para crear geometría a partir de texto.
Tomar screenshots del viewport — Claude puede capturar el estado visual de la escena y analizarla para dar feedback o continuar trabajando.
Estos prompts funcionan bien como punto de partida:
Primera escena completa:
Crea una escena de un calabozo medieval con paredes de piedra, antorchas en las paredes con luz cálida, un cofre del tesoro en una esquina y un dragón en el centro. Aplica materiales realistas a cada objeto.
Material metálico profesional:
Aplica un material dorado metálico al objeto seleccionado con reflexiones realistas, roughness 0.3 y un tono cálido. Agrega un plano de fondo oscuro para que el material se vea mejor.
Iluminación cinematográfica de tres puntos:
Agrega iluminación cinematográfica de tres puntos a la escena: una key light cálida a 45 grados, una fill light suave al lado opuesto y una rim light desde atrás. Ajusta las intensidades para un look dramático.
Asset desde Poly Haven:
Descarga un modelo de árbol realista de Poly Haven y colócalo en la escena. Escálalo para que se vea proporcional y agrega un plano de pasto debajo con material verde natural.
Sala de estar desde cero:
Crea una sala de estar moderna con un sofá, una mesa de centro, una lámpara de piso y una ventana con luz natural entrando. Aplica materiales realistas a cada mueble y configura la cámara para un render atractivo.
Tres variables de entorno opcionales para casos específicos:
| Variable | Valor por defecto | Uso |
|---|---|---|
BLENDER_HOST |
localhost | Cambiar si Blender corre en otra máquina |
BLENDER_PORT |
9876 | Cambiar si el puerto está en uso |
DISABLE_TELEMETRY |
— | Desactiva telemetría anónima del addon |
Blender MCP puede ejecutar código Python arbitrario dentro de Blender. Claude tiene control total sobre la escena mientras el servidor esté activo. Guarda siempre tu archivo antes de empezar a trabajar con Claude. No uses este addon en archivos de producción sin respaldo previo.