"Blender MCP" suele referirse a MCP for Blender, un proyecto de código abierto de Siddharth Ahuja que permite a un agente de IA manejar una copia de Blender abierta. Se llamó blender-mcp hasta noviembre de 2026, y la mayoría de los tutoriales aún usan ese nombre. Con él conectado, Claude Code, Codex, Cursor o Claude Desktop pueden crear y editar objetos, aplicar materiales, mirar el viewport y exportar archivos, todo desde un prompt de chat.

Esta guía explica qué es, cómo instalarlo en Claude Code y Codex, y un ejemplo completo: un agente construye en Blender un prop low-poly para un juego, lo exporta como GLB, el archivo se comprime con glTF-Transform y three.js lo carga en un juego de navegador. Comprobamos cada comando con el README del proyecto y la documentación oficial el 21 de noviembre de 2026. No ejecutamos nosotros la instalación ni el ejemplo, así que los resultados que se describen abajo son lo que dice la documentación que debería pasar.

Qué es Blender MCP

MCP (Model Context Protocol) es una forma estándar de darle a un agente de IA herramientas que actúan sobre otro programa. MCP for Blender tiene dos partes:

  • Un add-on de Blender que abre un servidor de sockets dentro de Blender (puerto 9876 por defecto) y ejecuta los comandos que recibe.
  • Un servidor MCP (el paquete de Python mcp-for-blender) que tu agente arranca en segundo plano. Pasa las llamadas de herramientas del agente al add-on.

El agente trabaja sobre todo escribiendo Python de Blender y ejecutándolo en tu archivo de Blender abierto. El README lista nueve herramientas. Las que más verás son execute_blender_code (ejecuta Python en Blender), look (toma vistas del viewport, de la cámara o desde varios ángulos para que el agente revise su propio trabajo), get_scene_info (un resumen de la escena) y search_assets / import_asset (traen modelos, texturas y HDRI de Poly Haven, Sketchfab y Poly Pizza). También hay generate_3d, que crea un modelo con Meshy, Tripo, Hunyuan3D o Hyper3D Rodin.

No lo hace Blender. El README empieza con "This is a third-party integration and not made by Blender" (es una integración de terceros, no hecha por Blender), y la descripción de GitHub dice "Not affiliated with the official Blender Foundation." (sin afiliación con la Blender Foundation). Tiene licencia MIT y tenía 35 153 estrellas en GitHub el 21 de noviembre de 2026.

Blender sí tiene su propio servidor MCP. Blender Lab, parte del proyecto Blender, publica uno más pequeño en projects.blender.org/lab/blender_mcp, documentado en blender.org/lab/mcp-server. Su readme lo describe como "deliberately small" (pequeño a propósito). Se centra en la documentación de la API de Python de Blender, resúmenes de escenas y archivos, capturas de pantalla y ejecución de código. Necesita Blender 5.1 o superior, es GPL-3.0 y estaba en la v1.0.3 (septiembre de 2026). También aparece en el directorio de conectores de Claude como "Blender", hecho por Blender Lab. Lo tratamos en Alternativas.

Qué necesitas

  • Blender 3.0 o superior para MCP for Blender (el add-on declara la 3.0 como mínimo).
  • Python 3.10 o superior y uv, la herramienta que ejecuta el servidor con uvx. El instalador de una línea de abajo instala uv por ti.
  • Un agente compatible con MCP: Claude Code, Codex, Cursor, Claude Desktop, VS Code, OpenCode, Windsurf o Antigravity, según el README.
  • Para la parte del juego: Node.js (para glTF-Transform) y un proyecto de three.js.

La instalación rápida (todos los clientes a la vez)

El camino que recomienda el README es un comando que instala uv, encuentra los agentes de tu máquina, te deja elegir cuáles configurar e instala y activa el add-on de Blender. Solo añade una entrada blender a cada archivo de configuración y guarda una copia .bak de cada archivo que cambia.

macOS / Linux:

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

Windows (PowerShell):

irm https://www.mcp-for-blender.com/install.ps1 | iex

Si ya tienes uv:

uvx mcp-for-blender setup

Pasar un script de internet a tu shell lo ejecuta con los permisos de tu usuario. Si prefieres no hacerlo, usa los pasos manuales de abajo, que hacen lo mismo pieza por pieza. En ambos casos, cierra del todo tu agente y vuelve a abrirlo después.

Instalar Blender MCP en Claude Code

  1. Instala uv. El README da brew install uv en macOS, curl -LsSf https://astral.sh/uv/install.sh | sh en Linux y winget install --id=astral-sh.uv -e en Windows. Advierte contra pip install uv, que puede no crear el comando uvx.
  2. Registra el servidor en Claude Code. Este es el comando del README:
claude mcp add blender uvx mcp-for-blender
  1. Compruébalo. La documentación de MCP de Claude Code indica claude mcp list (muestra un estado como "✔ Connected") y claude mcp get blender, y el panel /mcp dentro de una sesión muestra lo mismo.

Por defecto, claude mcp add guarda el servidor solo para el proyecto actual. Añade --scope user para usarlo en todos los proyectos. La forma general de la documentación pone el comando del servidor después de --: claude mcp add [options] <name> -- <command> [args...]. Necesitas el -- si añades opciones como --scope o --env.

Para desactivar la telemetría anónima de uso del proyecto, el README dice que hay que definir la variable de entorno DISABLE_TELEMETRY=true para el servidor. En Claude Code se pasa con --env antes del --.

Instalar Blender MCP en Codex

La CLI de Codex, la app de escritorio de Codex y la extensión del IDE comparten un solo archivo de configuración, ~/.codex/config.toml, así que una sola configuración sirve para los tres.

Servidor MCP simple. El comando del README:

codex mcp add blender -- uvx mcp-for-blender

O añádelo a mano a ~/.codex/config.toml:

[mcp_servers.blender]
command = "uvx"
args = ["mcp-for-blender"]

Ejecuta codex mcp list y comprueba que blender aparece como activado. Las herramientas aparecen la próxima vez que inicies Codex, y /mcp en la interfaz de terminal de Codex lista los servidores activos. La documentación de MCP de Codex de OpenAI también describe una tabla env para variables de entorno, startup_timeout_sec (10 por defecto) y tool_timeout_sec (60 por defecto). En la app de escritorio, ve a Settings → MCP servers → Add server, ponle el nombre blender, elige STDIO e introduce uvx mcp-for-blender.

Plugin de Codex. El README recomienda esta vía para Codex. Añade un viewport de Blender en vivo dentro del chat, selectores con miniaturas para Poly Haven, Sketchfab y Poly Pizza, y menciones con @ para objetos de la escena. Todavía no está en el directorio de plugins de Codex, así que se añade desde el repositorio:

git clone https://github.com/ahujasid/blender-mcp.git
codex plugin marketplace add ./blender-mcp/integrations/codex

Después reinicia Codex, instala MCP for Blender desde el directorio de plugins y pídele a Codex que lo use.

Cursor y otros

En Cursor, abre Settings → MCP y añade un servidor global, o crea .cursor/mcp.json en tu proyecto, con:

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

En Windows el README usa "command": "cmd" con "args": ["/c", "uvx", "mcp-for-blender"]. El README también tiene botones de instalación con un clic para Cursor y VS Code, y bloques de configuración para Claude Desktop, OpenCode y Antigravity. Dice que ejecutes solo una copia del servidor a la vez, por ejemplo Cursor o Claude Desktop, pero no los dos.

Conectar el add-on de Blender

El instalador rápido lo hace por ti. A mano:

  1. Ejecuta uvx mcp-for-blender install-addon. Copia el add-on a la carpeta de add-ons de Blender como blender_mcp.py.
  2. En Blender, abre Edit → Preferences → Add-ons y activa Interface: MCP for Blender. Si no aparece, reinicia Blender o haz clic en Install… y elige el archivo copiado. También puedes descargar addon.py del repositorio e instalar ese.
  3. En el viewport 3D, pulsa N para abrir la barra lateral y busca la pestaña MCP for Blender. El add-on inicia su servidor cuando se abre Blender. Si no está en marcha, haz clic en Start MCP Server.

La pestaña del add-on es donde activas funciones opcionales como Poly Haven, Poly Pizza (necesita una API key gratuita) y los generadores 3D.

Si tu agente no puede conectarse: asegúrate de que Blender esté abierto con el add-on en marcha, y no inicies uvx mcp-for-blender tú mismo en una terminal (la tabla de solución de problemas del README dice que no lo hagas). Las apps iniciadas desde el Dock o el menú Inicio pueden no encontrar uvx y fallar con spawn uvx ENOENT. Se arregla usando como comando la ruta completa que da which uvx (macOS/Linux) o where uvx (Windows). Si sigue fallando, reinicia tanto el agente como Blender.

Ejemplo completo: un prop low-poly para un juego, del prompt a three.js

Objetivo: un cofre del tesoro para un juego de navegador, lo bastante pequeño para cargar rápido, en un formato que three.js lea directamente. Escribimos este flujo a partir de la documentación y no lo ejecutamos de principio a fin, así que los tamaños de archivo y los resultados exactos variarán.

1. Guarda primero tu archivo de Blender

Abre un archivo nuevo de Blender y guárdalo (por ejemplo chest.blend) antes de que empiece el agente. El agente modifica tu archivo directamente, y la advertencia del propio README es guardar siempre tu trabajo antes.

2. Dale el prompt al agente

En Claude Code o Codex, con Blender abierto y conectado:

Use the Blender MCP tools. In the current scene, build a low-poly treasure chest
for a browser game:
- About 1 m wide, 0.6 m deep, 0.7 m tall, sitting on the ground at z = 0,
  origin at the bottom centre.
- A box body and a curved lid made from a half-cylinder with 8 segments,
  plus metal bands and a lock plate. Keep it under 1,500 triangles.
- Flat-shaded materials using Principled BSDF base colours only
  (dark wood, brass), no image textures.
- Apply all modifiers and transforms, join everything into one object named "Chest".
- Check it with the look tool from several angles and fix anything that
  overlaps or floats.
- Then select only "Chest" and export it as a GLB to ./public/models/chest.glb.
Show me each script before you run it.

Algunas decisiones de ese prompt importan para los juegos. Los colores base lisos se exportan bien, porque el exportador de glTF toma el color base del nodo Principled BSDF, según el manual de glTF de Blender. Un solo objeto unido significa una sola malla en three.js. Poner el origen en la base hace que el cofre quede apoyado en el suelo cuando fijas su posición en y = 0. Un presupuesto de triángulos evita que el agente añada subdivisión.

3. El paso de exportación

El agente escribe el Python de Blender. La exportación suele terminar con una llamada como esta, que usa los parámetros documentados en la API export_scene de Blender:

import bpy

bpy.ops.export_scene.gltf(
    filepath="/path/to/your-game/public/models/chest.glb",
    export_format='GLB',   # single binary file: mesh, materials and images packed together
    use_selection=True,    # only the selected "Chest" object
    export_apply=True,     # apply modifiers on export
    export_yup=True,       # glTF's +Y up convention, which three.js also uses
)

Lee este script antes de aprobarlo, como con cada script que ejecuta el agente. Comprueba que la ruta apunte dentro de tu proyecto y que nada borre ni sobrescriba archivos que te importan.

4. Comprime el GLB con glTF-Transform

glTF-Transform es una herramienta de línea de comandos para optimizar archivos glTF. Instálala y ejecuta optimize. Son los comandos de su README:

npm install --global @gltf-transform/cli
gltf-transform optimize input.glb output.glb --texture-compress webp

Para nuestro cofre:

gltf-transform optimize public/models/chest.glb public/models/chest.opt.glb --texture-compress webp

Por defecto, optimize comprime la geometría con meshopt (--compress meshopt), limita las texturas a 2048 px y aplana el grafo de la escena. Nuestro cofre no tiene texturas de imagen, así que --texture-compress webp no tiene nada que hacer aquí, pero déjalo para los props que sí las tengan. Para comprimir solo la geometría, glTF-Transform también tiene gltf-transform meshopt input.glb output.glb --level medium.

5. Cárgalo en three.js

Un archivo comprimido con meshopt necesita el decodificador de meshopt. Sin él, GLTFLoader lanza "setMeshoptDecoder must be called before loading compressed files". Las importaciones de abajo son las que three.js usa en sus propios ejemplos:

import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import { MeshoptDecoder } from 'three/addons/libs/meshopt_decoder.module.js';

const loader = new GLTFLoader();
loader.setMeshoptDecoder(MeshoptDecoder);

const gltf = await loader.loadAsync('/models/chest.opt.glb');
const chest = gltf.scene;
chest.position.set(0, 0, -3); // origin is at the bottom, so y = 0 puts it on the floor
scene.add(chest);

Blender trabaja en metros, igual que la mayoría de las escenas de three.js, así que el cofre debería cargarse con unos 1 m de ancho. Si entra tumbado de lado, probablemente la exportación se ejecutó sin export_yup. Si se ve negro, tu escena necesita luces: añade una HemisphereLight o un mapa de entorno.

6. Itera

Deja abierto el archivo de Blender y pide cambios, como "haz que la tapa se abra 40 grados como un objeto aparte llamado Lid" o "añade un montón de oro dentro". Luego ejecuta de nuevo la exportación y el comando optimize. Pídele al agente que guarde el script de exportación en tu proyecto, para tener los mismos ajustes cada vez.

Límites y seguridad

  • Ejecuta cualquier Python dentro de Blender. La advertencia del README: "The execute_blender_code tool allows running arbitrary Python code in Blender, which can be powerful but potentially dangerous." (La herramienta execute_blender_code permite ejecutar código Python arbitrario en Blender, lo que puede ser potente pero potencialmente peligroso). El Python de Blender puede leer y escribir cualquier archivo al que acceda tu cuenta de usuario. Pídele al agente que te muestre los scripts antes de ejecutarlos, y léelos.
  • Guarda tu archivo antes de cada sesión. La misma advertencia termina así: "ALWAYS save your work before using it." (guarda SIEMPRE tu trabajo antes de usarlo). Guarda versiones sobre la marcha (File → Save Incremental).
  • Activa el modo seguro si no necesitas acceso a archivos ni a la red. Define BLENDER_MCP_SAFE_MODE=1 para el servidor. Entonces cada script se revisa antes de ejecutarse, y se bloquea el código que lee o escribe archivos directamente, ejecuta otros programas, usa la red o sigue funcionando después de que termine el script. El modelado, los materiales, el render, el guardado y la importación/exportación siguen funcionando.
  • Mantenlo en localhost. El socket del add-on no tiene autenticación ni cifrado. Cualquiera que pueda llegar a ese puerto puede ejecutar Python en tu Blender. No lo expongas a una red en la que no confíes.
  • Divide los trabajos grandes en pasos. El README dice que las operaciones complejas pueden necesitar pasos más pequeños, y que los tiempos de espera agotados se arreglan simplificando la petición. Las descargas de Poly Haven se ejecutan en el hilo principal de Blender, así que Blender se congela hasta que terminan.
  • Revisa las licencias de los assets. Poly Haven es CC0. Alrededor del 69 % de Poly Pizza es CC-BY, que exige dar crédito. El add-on escribe la línea de crédito en los objetos importados, o puedes buscar con licence="CC0".
  • Telemetría. Por defecto el servidor envía un registro de uso anónimo: ID de instalación, ID de sesión, nombre de la herramienta, éxito, duración, versiones, sistema operativo y marca de tiempo. Tus prompts, código, capturas y datos de escena solo se recogen si lo activas tú. DISABLE_TELEMETRY=true lo desactiva todo.

Alternativas a Blender MCP

  • Blender MCP de Blender Lab: el servidor propio de Blender. Es más pequeño y está construido en torno a la documentación de la API de Python, resúmenes de escenas y archivos, capturas de pantalla y ejecución de código, incluido un modo en segundo plano para archivos .blend. Necesita Blender 5.1+ y es GPL-3.0. Su wiki lo configura clonando el repositorio y ejecutándolo con uv --directory .../blender_mcp/mcp run blender-mcp. Elígelo si quieres el proyecto oficial y no necesitas búsqueda de assets ni generación de modelos con IA.
  • Blender Agent Skills: 28 skills para Blender 5.2 LTS+ (modelado, UV, baking, rigging, animación, optimización, exportación) para Claude Code, Codex, OpenCode, Gemini CLI, Copilot y Cursor. MIT. Las skills le enseñan al agente cómo hacer el trabajo. Un servidor MCP le da control de Blender. Puedes usar ambos.
  • blender-game-skills: skills de Claude Code que llevan de arte conceptual a assets 3D con rig y listos para juego. MIT.
  • Modelos ya hechos. Para props comunes, un modelo gratis suele ser más rápido que generarlo. Mira los GLB low-poly de Polyfork.

Nuestra lista de skills y servidores MCP para hacer juegos cubre los equivalentes para Godot, Unity, Unreal y three.js.

Preguntas frecuentes

¿Blender MCP es gratis?

Sí. MCP for Blender tiene licencia MIT y el add-on es gratis. Su página Premium dice que todas las funciones están disponibles en el plan gratuito y que solo la generación 3D es de pago. Puedes usar Meshy, Tripo, Hunyuan3D, Hyper3D Rodin o World Labs con tus propias API keys, o comprar Premium (desde $10/mes el 21 de noviembre de 2026) para usarlos sin keys. El servidor de Blender Lab es gratis bajo GPL-3.0. Sigues pagando la suscripción o el uso de API de tu agente de IA.

¿Blender MCP es seguro?

Es tan seguro como el código que le dejas ejecutar. El agente ejecuta Python dentro de Blender, y ese Python tiene el acceso a archivos de tu usuario. Guarda tu trabajo, lee los scripts antes de aprobarlos, usa el modo seguro (BLENDER_MCP_SAFE_MODE=1) y mantén el puerto del add-on en localhost. Instálalo desde el repositorio oficial o desde el script de instalación del propio proyecto, no desde una copia que alguien resubió.

¿Hay un servidor MCP oficial de Blender?

Sí. Blender Lab publica uno en projects.blender.org/lab/blender_mcp, y el directorio de conectores de Claude lo lista como "Blender", hecho por Blender Lab. El MCP for Blender más conocido (antes blender-mcp) es un proyecto de terceros que no está afiliado a la Blender Foundation.

¿Blender MCP funciona con Claude Code?

Sí. Ejecuta claude mcp add blender uvx mcp-for-blender, abre Blender con el add-on activado y comprueba con claude mcp list. Claude Desktop se configura en cambio con un bloque JSON en claude_desktop_config.json.

¿Blender MCP funciona con Codex?

Sí. Ejecuta codex mcp add blender -- uvx mcp-for-blender o añade [mcp_servers.blender] a ~/.codex/config.toml. El README también ofrece un plugin de Codex que muestra un viewport de Blender en vivo junto al chat.

¿Blender MCP funciona con ChatGPT?

El README lista clientes de escritorio y de programación (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity), no la app de ChatGPT. Codex es el agente de OpenAI para esto. El servidor se comunica con un Blender que corre en tu propio ordenador, así que necesitas un cliente que pueda lanzar un servidor MCP local.

¿Dónde está la pestaña de Blender MCP?

En el viewport 3D de Blender, pulsa N para abrir la barra lateral. La pestaña se llama MCP for Blender. Si falta, activa Interface: MCP for Blender en Edit → Preferences → Add-ons.

¿Blender MCP o una skill de Blender?

Un servidor MCP permite al agente actuar sobre un Blender en vivo: crear objetos, mirar el viewport, exportar. Una skill le enseña al agente flujos de trabajo y convenciones de Blender, lo que ayuda tanto si luego trabaja mediante MCP como si ejecuta Blender sin interfaz desde la línea de comandos. Para assets de juegos, usar ambos funciona bien. El servidor MCP construye, y un paquete de skills como Blender Agent Skills cubre UV, optimización y ajustes de exportación.

Fuentes

Comprobadas el 21 de noviembre de 2026: README de mcp-for-blender, MCP for Blender Premium, Blender Lab blender_mcp y su wiki de configuración, documentación de MCP de Claude Code, documentación de MCP de Codex, API export_scene de Blender, manual de glTF 2.0 de Blender, CLI de glTF-Transform, GLTFLoader de three.js.