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:
Blender 3.0 o superior — Descárgalo desde blender.org
Claude Desktop — La aplicación de escritorio de Claude (con suscripción activa)
Python 3.10 o superior — Normalmente ya viene con Blender, pero si instalas UV no necesitas instalarlo aparte
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:
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.
Abre Claude Desktop
Ve a Settings (icono de engranaje ⚙️)
Haz clic en la sección Developer
Haz clic en Edit Config
Se abrirá el archivo claude_desktop_config.json en un editor de texto
ℹ️¿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.
En la ventana de preferencias, ve a la pestaña Add-ons
Haz clic en "Install from Disk..." (o "Install..." en versiones anteriores)
Navega hasta el archivo addon.py que descargaste y selecciónalo
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
En el viewport 3D, pulsa la tecla N para abrir la barra lateral
Busca la pestaña "BlenderMCP"
Opcionalmente, activa los checkboxes de Poly Haven, Hyper3D, Sketchfab o Hunyuan3D si quieres esas integraciones
Haz clic en "Connect to Claude"
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
Asegúrate de que el servidor MCP en Blender está corriendo (debe decir "Running on port 9876")
No ejecutesuvx blender-mcp manualmente en la terminal — Claude lo gestiona automáticamente
Si persiste, reinicia tanto Blender como Claude Desktop
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.
GitGitHubPrincipiantes — Intermedio
Git & GitHub — Comandos esenciales
Guía completa de los comandos de Git para controlar versiones, subir archivos,
hacer commits, push, pull, gestionar ramas y colaborar en proyectos a través de GitHub.
Con ejemplos prácticos en cada paso.
📅 Abril 2026⏱ ~25 min🔧 Nivel: Básico → Intermedio
01 ¿Qué es Git y GitHub?
Git es un sistema de control de versiones. Piensa en él como un "historial de guardados"
para tus proyectos. Cada vez que haces un commit, Git guarda una foto del estado actual de tus archivos.
Puedes volver a cualquier versión anterior en cualquier momento.
GitHub es una plataforma online donde puedes subir tus repositorios Git para tenerlos en la nube,
compartirlos con otros y colaborar en equipo. Git funciona en local; GitHub funciona en remoto.
📁
Directorio de trabajo
Tus archivos locales
→
📋
Staging Area
git add
→
💾
Repositorio Local
git commit
→
☁️
GitHub
git push
💡Analogía simple: Git es como un álbum de fotos de tu proyecto.
git add = elegir las fotos que quieres guardar.
git commit = pegarlas en el álbum con una nota.
git push = subir el álbum a la nube.
02 Instalación y configuración inicial
Instalar Git
Windows: Descarga el instalador desde git-scm.com y ejecútalo con las opciones por defecto.
macOS:
Terminal
brew install git
Linux (Ubuntu/Debian):
Terminal
sudo apt update && sudo apt install git
Verificar la instalación
Terminal / PowerShell
git --version
# Debería mostrar algo como: git version 2.45.0
Configuración obligatoria (primera vez)
Git necesita saber quién eres para firmar los commits. Esto solo se hace una vez:
Terminal / PowerShell
# Tu nombre (aparecerá en cada commit)
git config --global user.name "Tu Nombre"# Tu email (debe coincidir con el de tu cuenta de GitHub)
git config --global user.email "tu@email.com"# Establecer la rama principal como "main" (estándar actual)
git config --global init.defaultBranch "main"# Verificar tu configuración
git config --list
ℹ️--global significa que esta configuración se aplica a todos tus proyectos.
Si quieres configurar un nombre/email diferente solo para un proyecto, usa el mismo comando
sin --global dentro de la carpeta del proyecto.
03 Crear un repositorio
Opción A: Crear un repositorio nuevo desde cero
Si ya tienes una carpeta con tu proyecto y quieres empezar a usar Git:
Terminal / PowerShell
# Navega a la carpeta de tu proyecto
cd C:\Users\TuUsuario\MiProyecto
# Inicializa Git en esta carpeta
git init
# Resultado: Initialized empty Git repository in C:/Users/.../MiProyecto/.git/
Esto crea una carpeta oculta .git/ dentro de tu proyecto. Ahí Git almacena todo el historial.
Opción B: Clonar un repositorio existente de GitHub
Si quieres descargar un proyecto que ya existe en GitHub:
Terminal / PowerShell
# Clonar un repositorio (descarga todo el proyecto + historial)
git clone https://github.com/usuario/nombre-repo.git
# Ejemplo real:
git clone https://github.com/ahujasid/blender-mcp.git
# Clonar en una carpeta con nombre específico
git clone https://github.com/usuario/repo.git mi-carpeta
Pon un nombre al repositorio, elige público o privado
Marca "Add a README file" para que no esté vacío
Haz clic en "Create repository"
Copia la URL y clónalo con git clone URL
✅Recomendación: Para principiantes, la Opción C es la más sencilla.
Creas el repo en GitHub, lo clonas en tu PC, y empiezas a trabajar. Así te ahorras configurar el remoto manualmente.
04 Flujo básico — add, commit, push
Este es el flujo que usarás el 90% del tiempo. Son tres comandos que debes memorizar:
git status — Ver qué ha cambiado
Terminal
git status
# Muestra:# - Archivos modificados (en rojo)# - Archivos listos para commit (en verde)# - Archivos nuevos no rastreados
git add — Seleccionar archivos para el commit
Terminal
# Añadir UN archivo específico
git add index.html
# Añadir VARIOS archivos
git add index.html styles.css script.js
# Añadir TODOS los archivos modificados y nuevos
git add .
# Añadir todos los archivos de una carpeta
git add src/
# Añadir todos los archivos de un tipo
git add *.py
💡¿Qué hace git add? Mueve los archivos al "Staging Area" (área de preparación).
Es como poner las cosas en una caja antes de enviarlas. Puedes elegir qué va en la caja y qué no.
git add . (con punto) mete todo.
git commit — Guardar los cambios con un mensaje
Terminal
# Commit con mensaje descriptivo
git commit -m "Añade página de contacto con formulario"# Commit con título y descripción más larga
git commit -m "Añade sistema de login" -m "Incluye validación de email, hash de contraseñas y tokens JWT"# Atajo: add + commit de archivos YA rastreados (no nuevos)
git commit -am "Corrige bug en el footer"
⚠️Buenos mensajes de commit: Escribe mensajes claros y descriptivos.
❌ Malo: "cambios", "fix", "asdf".
✅ Bueno: "Corrige error de carga en página de productos", "Añade modo oscuro al dashboard".
git push — Subir los commits a GitHub
Terminal
# Subir a la rama principal
git push origin main
# Si es la primera vez que haces push de esta rama
git push -u origin main
# Después de usar -u, basta con:
git push
# Subir a una rama específica
git push origin mi-rama
ℹ️-u (--set-upstream) vincula tu rama local con la rama remota.
Así la próxima vez solo necesitas escribir git push sin especificar destino.
Solo necesitas -u la primera vez para cada rama.
Ejemplo práctico completo
Ejemplo — Flujo diario típico
# 1. Verificar qué archivos cambiaron
git status
# 2. Añadir todo al staging
git add .
# 3. Confirmar los cambios con un mensaje
git commit -m "Actualiza estilos del header y añade logo"# 4. Subir a GitHub
git push
05 Ramas — branch, checkout, merge
Las ramas te permiten trabajar en funcionalidades nuevas sin tocar el código principal.
Es como crear una copia paralela de tu proyecto, trabajar en ella, y cuando esté lista,
unirla de vuelta al original.
Ver y crear ramas
Terminal
# Ver todas las ramas locales (* = rama actual)
git branch
# Ver ramas locales y remotas
git branch -a
# Crear una rama nueva
git branch nueva-funcionalidad
# Crear una rama y cambiarte a ella directamente
git checkout -b nueva-funcionalidad
# Alternativa moderna (Git 2.23+)
git switch -c nueva-funcionalidad
Cambiar entre ramas
Terminal
# Cambiar a una rama existente
git checkout main
git checkout nueva-funcionalidad
# Alternativa moderna
git switch main
Fusionar ramas (merge)
Terminal
# Primero, ve a la rama que recibirá los cambios
git checkout main
# Fusionar la otra rama en main
git merge nueva-funcionalidad
# Si ya no necesitas la rama, elimínala
git branch -d nueva-funcionalidad
# Forzar eliminación (si tiene cambios sin fusionar)
git branch -D nueva-funcionalidad
Ejemplo práctico: Crear una feature
Ejemplo — Flujo con ramas
# 1. Crear rama para la nueva funcionalidad
git checkout -b feature/modo-oscuro
# 2. Trabajar, hacer cambios...
git add .
git commit -m "Implementa toggle de modo oscuro"# 3. Más cambios...
git add .
git commit -m "Añade transiciones suaves al cambio de tema"# 4. Subir la rama a GitHub
git push -u origin feature/modo-oscuro
# 5. Cuando esté lista, volver a main y fusionar
git checkout main
git merge feature/modo-oscuro
# 6. Subir main actualizado
git push
# 7. Limpiar: eliminar la rama
git branch -d feature/modo-oscuro
💡Convención de nombres: Es buena práctica nombrar ramas de forma descriptiva:
feature/nombre para nuevas funcionalidades,
fix/nombre para correcciones,
hotfix/nombre para arreglos urgentes.
06 Trabajo remoto — remote, pull, fetch
git remote — Gestionar conexiones remotas
Terminal
# Ver los remotos configurados
git remote -v
# Añadir un remoto (si usaste git init en vez de clone)
git remote add origin https://github.com/tu-usuario/tu-repo.git
# Cambiar la URL de un remoto
git remote set-url origin https://github.com/tu-usuario/nuevo-repo.git
# Eliminar un remoto
git remote remove origin
git pull — Descargar y fusionar cambios remotos
Terminal
# Descargar cambios de GitHub y fusionarlos automáticamente
git pull
# Equivale a: git fetch + git merge
git pull origin main
# Pull con rebase (más limpio, sin commit de merge)
git pull --rebase origin main
⚠️Regla de oro: Siempre haz git pullantes de empezar a trabajar y
antes de hacer push. Así evitas conflictos con los cambios de otros colaboradores.
git fetch — Solo descargar (sin fusionar)
Terminal
# Descargar info del remoto sin tocar tus archivos
git fetch
# Ver qué cambió antes de fusionar
git log HEAD..origin/main --oneline
# Si te convence, fusionar
git merge origin/main
Conectar un repo local existente con GitHub
Si hiciste git init y ahora quieres subirlo a GitHub:
Ejemplo — Subir proyecto existente
# 1. Crea el repositorio en github.com/new (sin README)# 2. En tu carpeta local:
git init
git add .
git commit -m "Primer commit"# 3. Conectar con GitHub
git remote add origin https://github.com/tu-usuario/tu-repo.git
# 4. Subir por primera vez
git push -u origin main
07 Historial y deshacer cambios
git log — Ver historial de commits
Terminal
# Historial completo
git log
# Historial resumido (una línea por commit)
git log --oneline
# Historial con gráfico de ramas
git log --oneline --graph --all
# Últimos 5 commits
git log -5 --oneline
# Historial de un archivo específico
git log --oneline -- archivo.py
git diff — Ver diferencias
Terminal
# Ver cambios no añadidos al staging
git diff
# Ver cambios ya añadidos al staging
git diff --staged
# Diferencias entre dos commits
git diff abc1234 def5678
# Diferencias entre dos ramas
git diff main..feature/mi-rama
Deshacer cambios
Terminal
# Descartar cambios en un archivo (volver a la última versión)
git checkout -- archivo.txt
# Alternativa moderna
git restore archivo.txt
# Sacar un archivo del staging (después de git add)
git reset HEAD archivo.txt
# Alternativa moderna
git restore --staged archivo.txt
# Deshacer el último commit (manteniendo los cambios)
git reset --soft HEAD~1
# Deshacer el último commit (eliminando los cambios)
git reset --hard HEAD~1
# Crear un nuevo commit que revierte uno anterior (más seguro)
git revert abc1234
⚠️Cuidado con --hard:git reset --hard elimina cambios permanentemente.
Úsalo solo si estás seguro. Si ya hiciste push, usa git revert en su lugar,
que es más seguro porque crea un nuevo commit en vez de borrar historial.
08 .gitignore — Excluir archivos
El archivo .gitignore le dice a Git qué archivos o carpetas debe ignorar.
Se coloca en la raíz del proyecto. Es fundamental para no subir contraseñas, archivos temporales,
o dependencias pesadas.
.gitignore — Ejemplo típico
# Dependencias
node_modules/
__pycache__/
.venv/
venv/
# Archivos de entorno y secretos
.env
.env.local
*.secret
# Archivos del sistema operativo
.DS_Store
Thumbs.db
desktop.ini
# Archivos de IDE/editor
.vscode/
.idea/
*.swp
*.swo
# Archivos compilados
dist/
build/
*.exe
*.dll
*.o
# Logs y temporales
*.log
tmp/
temp/
# Archivos de Blender
*.blend1
*.blend2
ℹ️Consejo: GitHub ofrece plantillas de .gitignore para distintos lenguajes y frameworks en
github.com/github/gitignore.
También puedes generarlos automáticamente en gitignore.io.
09 Tags y releases
Los tags marcan puntos importantes en tu historial, como versiones de software.
Terminal
# Crear un tag ligero
git tag v1.0.0
# Crear un tag anotado (con mensaje, recomendado)
git tag -a v1.0.0 -m "Primera versión estable"# Ver todos los tags
git tag
# Ver detalles de un tag
git show v1.0.0
# Subir un tag a GitHub
git push origin v1.0.0
# Subir TODOS los tags
git push origin --tags
# Eliminar un tag local
git tag -d v1.0.0
# Eliminar un tag remoto
git push origin --delete v1.0.0
💡Versionado semántico: El estándar es vMAJOR.MINOR.PATCH.
Ejemplo: v1.0.0 → v1.0.1 (bugfix) → v1.1.0 (nueva feature) → v2.0.0 (cambio grande).
10 Flujo de trabajo completo
Aquí tienes un ejemplo realista de un día trabajando con Git y GitHub, de principio a fin:
Ejemplo práctico — Día de trabajo completo
# ═══════════════════════════════════════════# MAÑANA — Empezar el día# ═══════════════════════════════════════════# 1. Ir a la carpeta del proyecto
cd mi-proyecto
# 2. Asegurarte de estar en main
git checkout main
# 3. Descargar últimos cambios del equipo
git pull
# 4. Crear una rama para tu tarea del día
git checkout -b feature/sistema-de-busqueda
# ═══════════════════════════════════════════# TRABAJO — Hacer cambios# ═══════════════════════════════════════════# 5. Trabajas en tus archivos... editas, creas, borras# 6. Ver qué modificaste
git status
# 7. Primer commit del día
git add .
git commit -m "Añade barra de búsqueda en el header"# 8. Más trabajo...
git add .
git commit -m "Implementa filtrado de resultados por categoría"# 9. Subir tu rama a GitHub (primera vez con -u)
git push -u origin feature/sistema-de-busqueda
# ═══════════════════════════════════════════# TARDE — Finalizar y fusionar# ═══════════════════════════════════════════# 10. Último commit
git add .
git commit -m "Añade tests para la función de búsqueda"
git push
# 11. Volver a main y fusionar
git checkout main
git pull
git merge feature/sistema-de-busqueda
# 12. Subir main con los cambios fusionados
git push
# 13. Limpiar la rama
git branch -d feature/sistema-de-busqueda
git push origin --delete feature/sistema-de-busqueda
11 Cheatsheet rápida
Referencia rápida de todos los comandos esenciales:
Configuración
git config --global user.name "Nombre"# Tu nombre
git config --global user.email "email"# Tu email
git config --list # Ver configuración
Crear repositorios
git init # Nuevo repo local
git clone <url> # Clonar repo remoto
Flujo básico
git status # Ver estado
git add . # Añadir todo al staging
git add <archivo> # Añadir archivo específico
git commit -m "mensaje"# Guardar cambios
git push # Subir a GitHub
git pull # Bajar de GitHub