Blender MCP Principiantes

Guía de instalación de BlenderMCP

Conecta Blender con Claude AI a través del Model Context Protocol. Controla escenas 3D, crea objetos, aplica materiales y ejecuta código Python directamente desde Claude usando lenguaje natural.

📅 Abril 2026 ⏱ ~15 min 🔧 Nivel: Básico
Última versión verificada: blender-mcp v1.5.6

01 Cómo funciona

BlenderMCP crea un puente de comunicación entre Claude AI y Blender. El sistema tiene dos componentes principales que se comunican a través de un protocolo JSON sobre sockets TCP.

🤖
Claude Desktop
Envía comandos
⚙️
Servidor MCP
server.py · uvx
🧊
Blender
addon.py · Puerto 9876

Cuando le pides algo a Claude relacionado con Blender, el Servidor MCP traduce la petición en comandos JSON que envía al addon de Blender, el cual los ejecuta usando la API de Python de Blender (bpy). Los resultados vuelven por el mismo camino.

02 Requisitos previos

Antes de comenzar, asegúrate de tener instalado lo siguiente:

  1. Blender 3.0 o superior — Descárgalo desde blender.org
  2. Claude Desktop — La aplicación de escritorio de Claude (con suscripción activa)
  3. Python 3.10 o superior — Normalmente ya viene con Blender, pero si instalas UV no necesitas instalarlo aparte
  4. Conexión a internet — Necesaria para descargar UV y el paquete blender-mcp

03 Instalar UV

¿Qué es UV?

UV es un gestor de paquetes de Python ultrarrápido. Lo necesitas porque blender-mcp está escrito en Python y UV se encarga de descargarlo y ejecutarlo automáticamente cada vez que Claude lo necesita. Sin UV, Claude no puede lanzar el servidor MCP.

Instalación en Windows

Abre PowerShell (pulsa la tecla Windows, escribe "PowerShell" y haz clic en "Windows PowerShell"). Luego copia y pega este comando:

PowerShell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Esto descarga e instala UV en la carpeta C:\Users\TuUsuario\.local\bin\.

Instalación en macOS

Terminal
brew install uv
⚠️ Importante: No continúes con los siguientes pasos sin haber instalado UV correctamente. El resto del proceso depende de que UV esté funcionando.

04 Configurar el PATH

💡 ¿Qué es el PATH? Es una lista de carpetas donde Windows busca los programas ejecutables. Cuando escribes uv en la consola, Windows recorre todas las carpetas del PATH para encontrar ese programa. Si la carpeta donde se instaló UV no está en esa lista, Windows dirá "no reconozco ese comando".

En la misma ventana de PowerShell, pega estas tres líneas y pulsa Enter:

PowerShell
# Línea 1: Guarda la ruta donde se instaló UV
$localBin = "$env:USERPROFILE\.local\bin"

# Línea 2: Lee tu PATH actual de usuario
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")

# Línea 3: Añade la carpeta de UV al final del PATH
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")

Verificar la instalación

Cierra PowerShell, ábrelo de nuevo y escribe:

PowerShell
uv --version
Si ves un número de versión como uv 0.6.x, la instalación ha sido correcta. Si ves un error, repite los pasos anteriores y asegúrate de reiniciar PowerShell.

05 Configurar Claude Desktop

Ahora hay que decirle a Claude dónde encontrar el servidor MCP de Blender.

  1. Abre Claude Desktop
  2. Ve a Settings (icono de engranaje ⚙️)
  3. Haz clic en la sección Developer
  4. Haz clic en Edit Config
  5. Se abrirá el archivo claude_desktop_config.json en un editor de texto
  6. Pega el siguiente contenido y guarda el archivo
JSON — claude_desktop_config.json
{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "blender-mcp"
            ]
        }
    }
}
ℹ️ ¿Qué hace esta configuración? Le dice a Claude que cuando necesite el servidor de Blender, ejecute el comando uvx blender-mcp. UV se encargará automáticamente de descargar el paquete si es la primera vez, o de usarlo si ya está descargado. No necesitas ejecutar nada manualmente.

Después de guardar, cierra Claude Desktop completamente (no solo minimizar, sino cerrar del todo) y vuelve a abrirlo.

06 Instalar el addon en Blender

  1. Ve a github.com/ahujasid/blender-mcp y descarga el archivo addon.py
  2. Abre Blender
  3. Ve al menú Edit → Preferences
  4. En la ventana de preferencias, ve a la pestaña Add-ons
  5. Haz clic en "Install from Disk..." (o "Install..." en versiones anteriores)
  6. Navega hasta el archivo addon.py que descargaste y selecciónalo
  7. Activa el addon marcando el checkbox junto a "Interface: Blender MCP"
⚠️ Importante: Asegúrate de que la versión del addon (addon.py) sea compatible con la versión del servidor MCP. Si actualizas uno, actualiza el otro. De lo contrario pueden aparecer errores de comandos desconocidos.

07 Conectar y verificar

En Blender

  1. En el viewport 3D, pulsa la tecla N para abrir la barra lateral
  2. Busca la pestaña "BlenderMCP"
  3. Opcionalmente, activa los checkboxes de Poly Haven, Hyper3D, Sketchfab o Hunyuan3D si quieres esas integraciones
  4. Haz clic en "Connect to Claude"
  5. Debería aparecer el mensaje: "Running on port 9876"

En Claude Desktop

Al abrir Claude Desktop, deberías ver un icono de martillo (🔨) en la interfaz de chat. Al hacer clic verás las herramientas disponibles del MCP de Blender (normalmente 22 herramientas).

Prueba rápida

Escribe en Claude algo como:

Prompt para Claude
"Dime qué objetos hay en mi escena de Blender"
Si Claude responde con información sobre los objetos de tu escena (por defecto un cubo, una cámara y una luz), ¡la conexión funciona correctamente! Ya puedes empezar a crear con lenguaje natural.

08 Resolución de problemas

❌ "uv no se reconoce como comando"

El PATH no se configuró correctamente. Repite el Paso 04, cierra y abre PowerShell de nuevo, y verifica con uv --version.

❌ Claude no muestra el icono del martillo

Verifica que el archivo claude_desktop_config.json está bien formateado (sin comas extra ni errores de sintaxis). Cierra Claude Desktop completamente y ábrelo de nuevo.

❌ "Unknown command type" en los logs

La versión del addon en Blender no coincide con la del servidor MCP. Descarga el addon.py más reciente de GitHub y reemplaza el antiguo en Blender.

❌ Error de conexión / timeout

  1. Asegúrate de que el servidor MCP en Blender está corriendo (debe decir "Running on port 9876")
  2. No ejecutes uvx blender-mcp manualmente en la terminal — Claude lo gestiona automáticamente
  3. Si persiste, reinicia tanto Blender como Claude Desktop
  4. Si el puerto 9876 está ocupado, puedes cambiarlo en el panel BlenderMCP

❌ Las operaciones complejas fallan

Intenta dividir la petición en pasos más pequeños. En lugar de "crea una escena completa con un dragón y un castillo", prueba paso a paso: primero el castillo, luego el dragón, luego los materiales, etc.