Blog · Agentes de programación

Blender MCP: instálalo en Claude Code y Codex

Blender MCP es un servidor MCP más un add-on de Blender que permite a un agente de IA como Claude Code o Codex controlar una copia de Blender en ejecución, sobre todo escribiendo y ejecutando Python de Blender en tu archivo abierto. Con ese nombre suele referirse a mcp-for-blender, un proyecto de la comunidad de Siddharth Ahuja (antes blender-mcp); Blender Lab, parte del proyecto Blender, también publica un servidor oficial más pequeño. Esta guía explica en qué se diferencian, da los comandos de instalación para Claude Code y Codex, recorre un ejemplo breve en el que un agente construye un objeto low-poly y exporta un GLB, y cubre qué conviene bloquear antes de dejarlo trabajar. Actualizado el 21 de noviembre de 2026.

Qué es Blender MCP

MCP (Model Context Protocol) da a un agente herramientas que actúan sobre otro programa. Los dos proyectos de Blender MCP tienen las mismas dos partes: un add-on que ejecuta un pequeño servidor dentro de Blender y un servidor MCP que inicia tu agente y que reenvía sus llamadas de herramientas al add-on como JSON a través de un socket TCP.

El proyecto al que se refiere la mayoría es mcp-for-blender. Su README empieza con un aviso de que es una integración de terceros y que no la ha creado Blender. Tiene licencia MIT, contaba con 35.153 estrellas en GitHub el 21 de noviembre de 2026 y su paquete de PyPI cambió de nombre de blender-mcp a mcp-for-blender (versión 2.3.1 del 18 de noviembre); uvx blender-mcp sigue iniciando el servidor, así que las configuraciones antiguas siguen funcionando.

blender_mcp, de Blender Lab, es el oficial. Su readme lo describe como un servidor ligero, deliberadamente pequeño, pensado para una interfaz en lenguaje natural con la API de Python de Blender, un mejor acceso a la documentación y la exploración de escenas complejas. Aparece en el directorio de conectores de Claude como Blender, creado por Blender Lab, verificado por Anthropic.

mcp-for-blender frente a blender_mcp de Blender Lab

Cifras de los repositorios de GitHub y projects.blender.org del 21 de noviembre de 2026.

mcp-for-blender (comunidad)blender_mcp (Blender Lab)
Creado porSiddharth Ahuja; sin afiliación con la Blender FoundationBlender Lab, parte del proyecto Blender
LicenciaMITGPL-3.0
Versión de Blender3.0 o posterior5.1 o posterior
Estrellas35.153 en GitHub39 en projects.blender.org
HerramientasNueve, entre ellas execute_blender_code, look (vistas del viewport y de la cámara), get_scene_info, búsqueda e importación de assets (Poly Haven, Sketchfab, Poly Pizza) y generate_3d (Tripo, Hunyuan3D, Hyper3D Rodin, Meshy)execute_blender_code, execute_blender_code_for_cli (Blender en segundo plano), resúmenes de archivos .blend y de objetos, get_python_api_docs, capturas de pantalla; incluye fragmentos de la API de Python y del manual
InstalaciónInstalador de un comando o uvx mcp-for-blender; configuración integrada para Claude Code, Codex, Cursor y otrosgit clone del repositorio y ejecutarlo con uv; añadir el add-on en Blender
Ideal paraConstruir y decorar escenas, traer assets, generar modelosInspeccionar archivos y consultar la API de Blender, con la versión actual de Blender

Instalación rápida: todos tus agentes a la vez

La ruta que recomienda el README de mcp-for-blender es un solo comando. Instala uv si hace falta, detecta los clientes MCP de tu máquina (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity), te deja elegir cuáles configurar y después instala y habilita el add-on de Blender. Solo añade una entrada blender a cada configuración y guarda un .bak de cada archivo que modifica. Después, cierra del todo tu agente y vuelve a abrirlo.

Los comandos de abajo están copiados del README; no los hemos ejecutado. Pasar un script a tu shell lo ejecuta con tus permisos, así que si prefieres ver cada paso, usa la configuración manual de las dos secciones siguientes.

  • 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
  • Con uv ya instalado: uvx mcp-for-blender setup
  • Necesitas Blender 3.0 o posterior, Python 3.10 o posterior y uv.

Instalar Blender MCP en Claude Code

Configuración manual de mcp-for-blender. Los comandos están copiados del README del proyecto y de la documentación de MCP de Claude Code; no los hemos ejecutado.

  1. Instala uv

    uv proporciona el comando uvx que inicia el servidor. El README desaconseja pip install uv; usa el instalador oficial.

    # macOS
    brew install uv
    
    # Linux
    curl -LsSf https://astral.sh/uv/install.sh | sh
    
    # Windows
    winget install --id=astral-sh.uv -e
  2. Registra el servidor

    Esto guarda el servidor para el proyecto actual. Añade --scope user para usarlo en todas partes; las opciones de este tipo van antes de un -- que las separa del comando del servidor, que es la forma que usa la documentación de Claude Code. Dentro de una sesión, /mcp muestra el mismo estado.

    # el comando del README
    claude mcp add blender uvx mcp-for-blender
    
    # compruébalo: el servidor debe aparecer como conectado
    claude mcp list
    claude mcp get blender
  3. Opcional: desactiva la telemetría

    El README indica que se establezca DISABLE_TELEMETRY=true en el entorno del servidor para desactivar la telemetría por completo. claude mcp add de Claude Code admite variables de entorno con --env; consulta la documentación de MCP de Claude Code para ver la forma exacta.

  4. Instala y habilita el add-on de Blender

    Luego, en Blender, abre Edit → Preferences → Add-ons y habilita "Interface: MCP for Blender". Pulsa N en el viewport 3D y abre la pestaña MCP for Blender; el servidor se inicia con Blender y, si no está en marcha, haz clic en Start MCP Server.

    # copia el add-on a la carpeta de add-ons de Blender como blender_mcp.py (guarda un .bak)
    uvx mcp-for-blender install-addon
    
    # muestra las carpetas de add-ons que encontró
    uvx mcp-for-blender addon-paths

Instalar Blender MCP en Codex

La CLI de Codex, la app de escritorio y la extensión para IDE comparten ~/.codex/config.toml, así que una sola configuración cubre las tres. Los comandos están copiados del README y de la documentación de MCP de Codex de OpenAI; no los hemos ejecutado. Instala uv y el add-on de Blender como en los pasos de Claude Code.

  1. Añade el servidor con la CLI

    Codex muestra las herramientas la próxima vez que se inicia; /mcp en la interfaz de terminal de Codex lista los servidores activos. En la app de escritorio es Settings → MCP servers → Add server, nombre blender, STDIO, comando uvx mcp-for-blender.

    # el comando del README
    codex mcp add blender -- uvx mcp-for-blender
    
    # compruébalo: blender debe aparecer como habilitado
    codex mcp list
  2. O edita config.toml

    La tabla [mcp_servers.blender] es del README. La línea env sigue la documentación de Codex, que enumera env, startup_timeout_sec (10 por defecto) y tool_timeout_sec (60 por defecto) como claves de la tabla; aumenta tool_timeout_sec si las operaciones largas de Blender agotan el tiempo.

    # o a mano en ~/.codex/config.toml (lo comparten la CLI de Codex, la app de escritorio y la extensión para IDE)
    [mcp_servers.blender]
    command = "uvx"
    args = ["mcp-for-blender"]
  3. Opcional: el plugin de Codex

    El README lo recomienda para Codex: muestra un viewport de Blender en vivo dentro del chat, selectores con miniaturas para los assets y menciones con @ para los 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
    # luego reinicia Codex e instala "MCP for Blender" desde el directorio de plugins

Instalar en su lugar el servidor oficial de Blender Lab

El wiki de configuración de Blender Lab indica instalar su add-on en Blender 5.1 o posterior, clonar el servidor en tu carpeta personal y apuntar tu cliente MCP a él con uv. Este es el comando de clonado y la configuración del wiki tal como los registramos; no los hemos ejecutado. Si usas Claude, el servidor también aparece en el directorio de conectores de Claude, que indica que el add-on es necesario.

git clone https://projects.blender.org/lab/blender_mcp.git, y después {"mcpServers": {"blender": {"command": "uv", "args": ["--directory", "$HOME/blender_mcp/mcp", "run", "blender-mcp"]}}}

No registres los dos proyectos con el mismo nombre blender. El README de mcp-for-blender también indica que se ejecute una sola instancia de su servidor a la vez, por ejemplo en Cursor o en Claude Desktop, pero no en ambos.

Ejemplo: un agente construye un objeto low-poly y exporta un GLB

Con Blender abierto y el add-on en marcha, el agente hace el modelado con execute_blender_code y revisa su trabajo con look. Lo escribimos a partir de la documentación y no lo ejecutamos de principio a fin, así que los resultados variarán. Para comprimir el GLB con glTF-Transform y cargarlo en three.js, consulta la guía completa de Blender MCP en vibegamer.io.

  1. Guarda tu archivo .blend

    El agente edita directamente tu archivo abierto. La advertencia del README es guardar siempre tu trabajo antes de usar execute_blender_code.

  2. Dale la indicación al agente

    Indica medidas, un presupuesto de triángulos y la ruta de exportación. Los colores base lisos se exportan sin problemas, ya que el exportador glTF de Blender lee el color base del nodo Principled BSDF. El README también señala que las operaciones complejas pueden requerir dividirse en pasos más pequeños.

    Usa las herramientas de Blender MCP. Construye una caja de madera low-poly para un juego de navegador:
    - Cubo de 1 m, apoyado en el suelo en z = 0, con el origen en el centro de la base.
    - Tablones biselados y refuerzos en las esquinas, menos de 800 triángulos.
    - Solo colores base con Principled BSDF (madera, metal oscuro), sin texturas de imagen.
    - Aplica los modificadores, une todo en un solo objeto llamado "Crate".
    - Revísalo con la herramienta look desde varios ángulos y corrige lo que quede flotando.
    - Selecciona solo "Crate" y expórtalo como GLB a ./public/models/crate.glb.
    Muéstrame cada script antes de ejecutarlo.
  3. Lee el script de exportación antes de que se ejecute

    La exportación suele terminar con una llamada como esta, con parámetros de la API export_scene de Blender. GLB reúne malla, materiales y texturas en un solo archivo. Comprueba que la ruta esté dentro de tu proyecto.

    import bpy
    
    bpy.ops.export_scene.gltf(
        filepath="/path/to/your-game/public/models/crate.glb",
        export_format='GLB',  # un solo archivo binario con malla, materiales e imágenes
        use_selection=True,   # solo el "Crate" seleccionado
        export_apply=True,    # aplica los modificadores al exportar
        export_yup=True,      # +Y arriba
    )

¿Es seguro Blender MCP? Qué conviene bloquear

Trátalo como si le dieras al agente una consola de Python dentro de Blender. Estos puntos son del README de mcp-for-blender.

  • Python arbitrario: execute_blender_code ejecuta cualquier Python que escriba el agente. El README lo califica de potencialmente peligroso y dice que guardes siempre tu trabajo antes. Lee los scripts antes de aprobarlos.
  • Modo seguro: establece BLENDER_MCP_SAFE_MODE=1 para validar los scripts antes de que se ejecuten. Bloquea la lectura y escritura directa de archivos, la ejecución de otros programas, el acceso a la red y el código persistente; el modelado, los materiales, el renderizado, el guardado y la importación/exportación siguen funcionando.
  • Sin autenticación en el socket: el servidor del add-on (puerto 9876 por defecto) no tiene autenticación ni cifrado, así que cualquiera que pueda llegar a ese puerto puede ejecutar Python en Blender. Mantén BLENDER_HOST en localhost salvo que estés en una red de confianza.
  • Telemetría: por defecto envía un ID de instalación anónimo, un ID de sesión, el nombre de la herramienta, el éxito, la duración, las versiones, el sistema operativo y la marca de tiempo. Los prompts, el código generado, las capturas de pantalla y los datos de la escena solo se envían si lo aceptas, y los datos aceptados pueden usarse para entrenar modelos de IA. Establece DISABLE_TELEMETRY=true para desactivarla por completo.
  • Claves de terceros: la generación 3D y algunas fuentes de assets usan claves de API pasadas como variables de entorno (por ejemplo BLENDERMCP_MESHY_API_KEY). Los modelos de Poly Pizza son CC-BY en torno a un 69 %, así que hay que dar crédito salvo que filtres por CC0.

¿Blender MCP o una skill de Blender?

Un servidor MCP da al agente una conexión en vivo con un Blender en ejecución. Una skill le da instrucciones y scripts escritos para un flujo de trabajo, como EL4CTEO/blender-skills (28 skills de flujos de trabajo de Blender 5.2 LTS+ para Claude Code, Codex y otros). Funcionan bien juntos: la skill le dice al agente cómo construir un asset listo para juegos y el servidor MCP le permite hacerlo en tu escena abierta.

Listamos skills de Blender y de creación de juegos, y servidores MCP, en game development skills, y vibegamer.io los compara en game dev agent skills.

Crewmark: un artista 3D en el mismo tablero que tus programadores

Blender MCP está pensado en torno a una sesión cada vez: tú das la indicación, el agente modela, tú revisas. Si quieres un agente que siga creando assets durante días mientras otros escriben el código del juego, Crewmark es otra opción.

En Crewmark cada agente es un empleado de IA: una sesión de larga duración con un rol, que funciona en tu propia máquina. Los empleados de Claude Code y Codex se ejecutan de forma nativa; otros agentes, como OpenCode, DeepSeek Harness y Gemini, se conectan mediante ACP (acpx). El trabajo avanza por un tablero de issues compartido, donde tú y los empleados asignáis issues, comentáis, os mencionáis con @ y cambiáis estados. Así es como un empleado de programación le pide un objeto nuevo a un empleado de Blender: lo menciona con @ en el issue. Los empleados se despiertan según un horario (heartbeats) y cada vez que los mencionan, así que el trabajo empieza sin que tengas que pasarlo tú.

No sustituye a Blender MCP; un empleado con el servidor instalado lo sigue usando. Añade los roles, el tablero y los despertares a su alrededor.

Preguntas frecuentes

¿Es gratis Blender MCP?

Sí. mcp-for-blender es de código abierto bajo MIT, y su sitio dice que todas las funciones están disponibles en el plan gratuito salvo la generación 3D, que requiere un plan Premium (desde 10 $ al mes) o tus propias claves de API de proveedor. El servidor de Blender Lab es gratuito bajo GPL-3.0.

¿Es seguro Blender MCP?

Ejecuta dentro de Blender cualquier Python que escriba el agente, y su servidor de socket no tiene autenticación. Guarda tu trabajo antes, lee los scripts antes de aprobarlos, mantenlo en localhost y establece BLENDER_MCP_SAFE_MODE=1 para bloquear el acceso a archivos, a otros programas y a la red. Establece DISABLE_TELEMETRY=true para desactivar la telemetría de uso.

¿Existe un servidor oficial de Blender MCP?

Sí. Blender Lab publica blender_mcp en projects.blender.org (GPL-3.0, Blender 5.1+), y aparece en el directorio de conectores de Claude como creado por Blender Lab. El popular mcp-for-blender es un proyecto de terceros sin afiliación con la Blender Foundation.

¿Cómo añado Blender MCP a Claude Code?

Instala uv, ejecuta claude mcp add blender uvx mcp-for-blender, compruébalo con claude mcp list y después instala y habilita el add-on de Blender con uvx mcp-for-blender install-addon. O ejecuta el instalador de un comando del README, que configura Claude Code por ti.

¿Cómo añado Blender MCP a Codex?

Ejecuta codex mcp add blender -- uvx mcp-for-blender, o añade a ~/.codex/config.toml una tabla [mcp_servers.blender] con command = "uvx" y args = ["mcp-for-blender"]. La CLI, la app de escritorio y la extensión para IDE comparten ese archivo. El README también ofrece un plugin de Codex con un viewport en vivo en el chat.

¿Debo usar Blender MCP o una skill de Blender?

Usa MCP cuando el agente deba actuar sobre una escena de Blender en ejecución; usa una skill cuando quieras darle un flujo de trabajo probado que seguir. Muchas configuraciones usan ambas: la skill describe el flujo de trabajo y el servidor MCP lo lleva a cabo.

Comandos y funciones verificados con el README de mcp-for-blender, el repositorio y el wiki de blender_mcp de Blender Lab, la documentación de MCP de Claude Code y Codex, y la documentación de exportación glTF de Blender el 21 de noviembre de 2026. No hemos ejecutado los comandos de instalación.

Dale a tu juego un artista 3D que trabaje con tus programadores.

Crewmark da a cada agente un rol, un tablero de issues compartido y despertares programados, para que se pasen el trabajo sin que tú lo copies entre terminales.

Crewmark es de código abierto: danos una estrella en GitHub