Blender MCP en español: conectar Claude con Blender

Qué es MCP y qué pinta Blender en todo esto

MCP, siglas de Model Context Protocol, es un estándar abierto para conectar aplicaciones de IA con sistemas externos: archivos, bases de datos, herramientas o programas. Su propia documentación lo compara con un puerto USB-C: una forma común de enchufar un asistente a otras aplicaciones sin construir una integración distinta para cada una.

En ese esquema hay dos lados. El cliente es la aplicación donde escribes, como Claude Desktop o Claude Code. El servidor MCP es un pequeño programa que ofrece herramientas al cliente. Blender MCP es un servidor de ese tipo: traduce las peticiones del asistente en órdenes que Blender entiende.

Conviene aclarar que no es un proyecto de la Blender Foundation. Su propio repositorio lo describe como una integración de terceros. Además, el proyecto se ha renombrado como MCP for Blender y el paquete actual se llama mcp-for-blender, aunque en las búsquedas sigue apareciendo sobre todo como Blender MCP.

Cómo funciona: un addon y un servidor

El sistema tiene dos piezas. La primera es un addon de Blender que abre un servidor de sockets dentro del programa para recibir y ejecutar órdenes. La segunda es el servidor MCP, que habla el protocolo con tu cliente y reenvía las peticiones al addon. Por defecto, la conexión usa localhost y el puerto 9876.

Con esa conexión, el asistente puede consultar un resumen de la escena, ejecutar código Python en tu Blender abierto, mirar el resultado desde la vista o la cámara y buscar o importar recursos de bibliotecas como Poly Haven o Sketchfab. La diferencia con pegar un script a mano es que el asistente ve el estado de la escena y puede encadenar varios pasos en una misma conversación.

1. Instala uv y el addon en Blender

El servidor se lanza con uvx, que forma parte de uv. El repositorio insiste en no seguir adelante sin uv y en instalarlo con el instalador oficial, no con pip install uv, porque así puede no crearse el comando uvx. En macOS puedes usar Homebrew; en Windows, winget.

El proyecto ofrece también un instalador de una sola línea que configura los clientes y el addon de golpe. Es cómodo, pero ejecuta un script descargado en tu equipo. Si prefieres ver cada paso, sigue la vía manual de abajo.

1. Instala uv: brew install uv en macOS o winget install --id=astral-sh.uv -e en Windows. Después abre una terminal nueva.
2. Ejecuta uvx mcp-for-blender install-addon para copiar el addon a la carpeta de complementos de Blender.
3. En Blender, ve a Edit → Preferences → Add-ons y activa Interface: MCP for Blender.
4. En la vista 3D pulsa N, abre la pestaña MCP for Blender y, si el servidor no está en marcha, pulsa Start MCP Server.

2. Conecta Claude Desktop o Claude Code

En Claude Desktop, la configuración está en Settings → Developer → Edit Config, que abre el archivo claude_desktop_config.json. Añade una entrada blender dentro de mcpServers, guarda y cierra la aplicación por completo antes de volver a abrirla. Si ya tenías otros servidores, añade solo el bloque de blender sin borrar los demás.

En Claude Code se hace con un comando. La documentación de Anthropic usa dos guiones para separar las opciones de Claude Code del comando que arranca el servidor. Después, dentro de la sesión, el comando /mcp muestra el estado de los servidores conectados, y claude mcp list los enumera desde la terminal.

Un detalle frecuente: las aplicaciones abiertas desde el Dock o el menú Inicio no siempre heredan el PATH de tu terminal. Si Claude Desktop no encuentra uvx, usa la ruta completa que te devuelva which uvx en macOS o where uvx en Windows. El repositorio también recomienda tener una sola instancia del servidor activa, no varias desde clientes distintos a la vez.

// claude_desktop_config.json
{
  "mcpServers": {
    "blender": {
      "command": "uvx",
      "args": ["mcp-for-blender"]
    }
  }
}

# Claude Code
claude mcp add blender -- uvx mcp-for-blender

3. Haz una primera petición pequeña

Abre una escena de prueba, guárdala y empieza pidiendo información, no cambios. Que el asistente describa los objetos que ve te confirma que la conexión funciona y que está mirando el archivo correcto. Después pide una sola modificación con nombres concretos y revisa el resultado en Blender antes de seguir.

Si una operación compleja falla por tiempo de espera, el propio repositorio recomienda dividirla en pasos más pequeños. Es la misma lógica que con cualquier script: un cambio por iteración. Si trabajas con estas peticiones a menudo, el kit de Pieza a Pieza recoge las skills que usamos en el canal para no reescribir las mismas instrucciones cada vez.

Describe los objetos de la escena actual: nombre, tipo y posición.
No cambies nada todavía.

Ahora crea un cubo llamado PAP_Prueba en el origen con un material gris.
No modifiques ni borres ningún otro objeto.

Riesgos y límites que debes conocer

La herramienta execute_blender_code permite ejecutar código Python arbitrario en tu Blender. Eso incluye borrar objetos, sobrescribir archivos o, en general, cualquier cosa que pueda hacer un script. La advertencia del repositorio es clara: guarda siempre tu trabajo antes de usarla. Añade una copia aparte del proyecto si es importante.

El servidor de sockets del addon no tiene autenticación ni cifrado. Mantenlo en localhost salvo que trabajes en una red de confianza. Existe un modo seguro que se activa con la variable BLENDER_MCP_SAFE_MODE=1 y bloquea operaciones de riesgo como leer o escribir archivos directamente o acceder a la red; reduce el riesgo, pero no sustituye a tu revisión.

Revisa también la telemetría: según el repositorio, la recogida de contenido como prompts o capturas es opcional, pero se guarda un registro de uso anónimo mínimo salvo que definas DISABLE_TELEMETRY=true. Y recuerda que el asistente puede equivocarse con escalas, nombres o versiones de la API: compruebas tú el resultado en Blender.

Antes de conectar cualquier servidor MCP de terceros, revisa su código y su procedencia. La documentación de Claude Code recomienda verificar que confías en cada servidor antes de añadirlo.