O que é o Blender MCP
O MCP (Model Context Protocol) dá a um agente ferramentas que agem sobre outro programa. Os dois projetos de Blender MCP têm as mesmas duas partes: um add-on que roda um pequeno servidor dentro do Blender e um servidor MCP que o seu agente inicia e que repassa as chamadas de ferramentas ao add-on como JSON por um socket TCP.
O projeto a que a maioria das pessoas se refere é o mcp-for-blender. O README dele começa com um aviso de que é uma integração de terceiros e não foi feita pelo Blender. Tem licença MIT, tinha 35.153 estrelas no GitHub em 21 de novembro de 2026 e o pacote no PyPI foi renomeado de blender-mcp para mcp-for-blender (versão 2.3.1 em 18 de novembro); uvx blender-mcp ainda inicia o servidor, então configurações antigas continuam funcionando.
O blender_mcp, do Blender Lab, é o oficial. O readme o descreve como um servidor leve, deliberadamente pequeno, voltado a uma interface em linguagem natural para a API de Python do Blender, a um acesso melhor à documentação e à exploração de cenas complexas. Ele aparece no diretório de conectores do Claude como Blender, feito pelo Blender Lab, verificado pela Anthropic.
mcp-for-blender versus blender_mcp do Blender Lab
Números dos repositórios do GitHub e do projects.blender.org em 21 de novembro de 2026.
| mcp-for-blender (comunidade) | blender_mcp (Blender Lab) | |
|---|---|---|
| Feito por | Siddharth Ahuja; sem vínculo com a Blender Foundation | Blender Lab, parte do projeto Blender |
| Licença | MIT | GPL-3.0 |
| Versão do Blender | 3.0 ou superior | 5.1 ou superior |
| Estrelas | 35.153 no GitHub | 39 no projects.blender.org |
| Ferramentas | Nove, incluindo execute_blender_code, look (vistas do viewport e da câmera), get_scene_info, busca e importação de assets (Poly Haven, Sketchfab, Poly Pizza) e generate_3d (Tripo, Hunyuan3D, Hyper3D Rodin, Meshy) | execute_blender_code, execute_blender_code_for_cli (Blender em segundo plano), resumos de arquivos .blend e de objetos, get_python_api_docs, capturas de tela; inclui trechos da API de Python e do manual |
| Instalação | Instalador de um comando ou uvx mcp-for-blender; configuração integrada para Claude Code, Codex, Cursor e outros | git clone do repositório e execução com uv; adicionar o add-on no Blender |
| Melhor para | Montar e decorar cenas, trazer assets, gerar modelos | Inspecionar arquivos e tirar dúvidas sobre a API do Blender, na versão atual do Blender |
Instalação rápida: todos os seus agentes de uma vez
O caminho que o README do mcp-for-blender recomenda é um único comando. Ele instala o uv se for preciso, encontra os clientes MCP na sua máquina (Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, OpenCode, Antigravity), deixa você escolher quais configurar e depois instala e habilita o add-on do Blender. Ele só acrescenta uma entrada blender em cada configuração e mantém um .bak de cada arquivo que altera. Depois, feche por completo o seu agente e abra de novo.
Os comandos abaixo foram copiados do README; nós não os executamos. Enviar um script para o seu shell o executa com as suas permissões, então, se você prefere ver cada passo, use a configuração manual das duas próximas seções.
- 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 - Com o uv já instalado:
uvx mcp-for-blender setup - Você precisa do Blender 3.0 ou superior, do Python 3.10 ou superior e do uv.
Instalar o Blender MCP no Claude Code
Configuração manual do mcp-for-blender. Os comandos foram copiados do README do projeto e da documentação de MCP do Claude Code; nós não os executamos.
Instale o uv
O uv fornece o comando
uvx, que inicia o servidor. O README desaconselhapip install uv; use o instalador oficial.# macOS brew install uv # Linux curl -LsSf https://astral.sh/uv/install.sh | sh # Windows winget install --id=astral-sh.uv -eRegistre o servidor
Isso salva o servidor para o projeto atual. Acrescente
--scope userpara usá-lo em todo lugar; opções como essa vêm antes de um--que as separa do comando do servidor, que é a forma usada na documentação do Claude Code. Dentro de uma sessão,/mcpmostra o mesmo status.# o comando do README claude mcp add blender uvx mcp-for-blender # confira: o servidor deve aparecer como conectado claude mcp list claude mcp get blenderOpcional: desative a telemetria
O README diz para definir
DISABLE_TELEMETRY=trueno ambiente do servidor para desativar a telemetria por completo. Oclaude mcp adddo Claude Code aceita variáveis de ambiente com--env; veja a documentação de MCP do Claude Code para a forma exata.Instale e habilite o add-on do Blender
Depois, no Blender, abra Edit → Preferences → Add-ons e habilite "Interface: MCP for Blender". Pressione N no viewport 3D e abra a aba MCP for Blender; o servidor inicia junto com o Blender e, se não estiver rodando, clique em Start MCP Server.
# copia o add-on para a pasta de add-ons do Blender como blender_mcp.py (mantém um .bak) uvx mcp-for-blender install-addon # lista as pastas de add-ons que encontrou uvx mcp-for-blender addon-paths
Instalar o Blender MCP no Codex
A CLI do Codex, o app de desktop e a extensão de IDE compartilham o ~/.codex/config.toml, então uma única configuração cobre os três. Os comandos foram copiados do README e da documentação de MCP do Codex, da OpenAI; nós não os executamos. Instale o uv e o add-on do Blender como nos passos do Claude Code.
Adicione o servidor pela CLI
O Codex mostra as ferramentas na próxima vez que iniciar;
/mcpna interface de terminal do Codex lista os servidores ativos. No app de desktop, é Settings → MCP servers → Add server, nomeblender, STDIO, comandouvx mcp-for-blender.# o comando do README codex mcp add blender -- uvx mcp-for-blender # confira: blender deve aparecer como habilitado codex mcp listOu edite o config.toml
A tabela
[mcp_servers.blender]vem do README. A linhaenvsegue a documentação do Codex, que listaenv,startup_timeout_sec(padrão 10) etool_timeout_sec(padrão 60) como chaves da tabela; aumentetool_timeout_secse operações longas do Blender estourarem o tempo.# ou à mão em ~/.codex/config.toml (compartilhado pela CLI do Codex, pelo app de desktop e pela extensão de IDE) [mcp_servers.blender] command = "uvx" args = ["mcp-for-blender"]Opcional: o plugin do Codex
O README o recomenda para o Codex: ele mostra um viewport do Blender ao vivo dentro do chat, seletores com miniaturas para assets e menções com @ para objetos da cena. Ele ainda não está no diretório de plugins do Codex, então você o adiciona a partir do repositório.
git clone https://github.com/ahujasid/blender-mcp.git codex plugin marketplace add ./blender-mcp/integrations/codex # depois reinicie o Codex e instale "MCP for Blender" pelo diretório de plugins
Instalando o servidor oficial do Blender Lab
O wiki de configuração do Blender Lab manda instalar o add-on dele no Blender 5.1 ou superior, clonar o servidor na sua pasta pessoal e apontar o seu cliente MCP para ele com o uv. Este é o comando de clone e a configuração do wiki como registrados; nós não os executamos. Se você usa o Claude, o servidor também aparece no diretório de conectores do Claude, que informa que o add-on é necessário.
git clone https://projects.blender.org/lab/blender_mcp.git, e depois {"mcpServers": {"blender": {"command": "uv", "args": ["--directory", "$HOME/blender_mcp/mcp", "run", "blender-mcp"]}}}
Não registre os dois projetos com o mesmo nome blender. O README do mcp-for-blender também diz para rodar apenas uma instância do servidor por vez, por exemplo no Cursor ou no Claude Desktop, mas não nos dois.
Exemplo: um agente constrói um objeto low-poly e exporta um GLB
Com o Blender aberto e o add-on rodando, o agente faz a modelagem por execute_blender_code e confere o resultado com look. Escrevemos isto a partir da documentação e não o executamos de ponta a ponta, então os resultados vão variar. Para comprimir o GLB com o glTF-Transform e carregá-lo no three.js, veja o guia completo de Blender MCP no vibegamer.io.
Salve o seu arquivo .blend
O agente edita diretamente o seu arquivo aberto. O aviso do README é salvar sempre o seu trabalho antes de usar
execute_blender_code.Dê o prompt ao agente
Informe tamanhos, um orçamento de triângulos e o caminho de exportação. Cores base simples exportam sem problemas, já que o exportador glTF do Blender lê a cor base do nó Principled BSDF. O README também observa que operações complexas podem precisar ser divididas em passos menores.
Use as ferramentas do Blender MCP. Construa uma caixa de madeira low-poly para um jogo de navegador: - Cubo de 1 m, apoiado no chão em z = 0, com a origem no centro da base. - Tábuas chanfradas e reforços nos cantos, menos de 800 triângulos. - Apenas cores base do Principled BSDF (madeira, metal escuro), sem texturas de imagem. - Aplique os modificadores, una tudo em um único objeto chamado "Crate". - Confira com a ferramenta look de alguns ângulos e corrija o que ficar flutuando. - Selecione somente "Crate" e exporte como GLB para ./public/models/crate.glb. Mostre-me cada script antes de executá-lo.Leia o script de exportação antes de ele rodar
A exportação costuma terminar com uma chamada como esta, usando parâmetros da API
export_scenedo Blender. O GLB reúne malha, materiais e texturas em um único arquivo. Confira se o caminho está dentro do seu projeto.import bpy bpy.ops.export_scene.gltf( filepath="/path/to/your-game/public/models/crate.glb", export_format='GLB', # um único arquivo binário com malha, materiais e imagens use_selection=True, # somente o "Crate" selecionado export_apply=True, # aplica os modificadores na exportação export_yup=True, # +Y para cima )
O Blender MCP é seguro? O que bloquear
Trate-o como dar ao agente um shell de Python dentro do Blender. Estes pontos vêm do README do mcp-for-blender.
- Python arbitrário:
execute_blender_codeexecuta qualquer Python que o agente escreva. O README diz que isso é potencialmente perigoso e que você deve sempre salvar o trabalho antes. Leia os scripts antes de aprová-los. - Modo seguro: defina
BLENDER_MCP_SAFE_MODE=1para validar os scripts antes de rodarem. Ele bloqueia a leitura e a escrita direta de arquivos, a execução de outros programas, o acesso à rede e o código persistente; modelagem, materiais, renderização, salvamento e importação/exportação continuam funcionando. - Sem autenticação no socket: o servidor do add-on (porta 9876 por padrão) não tem autenticação nem criptografia, então qualquer pessoa que alcance essa porta pode executar Python no Blender. Mantenha
BLENDER_HOSTemlocalhost, a menos que esteja em uma rede confiável. - Telemetria: por padrão, envia um ID de instalação anônimo, um ID de sessão, o nome da ferramenta, o sucesso, a duração, as versões, o sistema operacional e o carimbo de data e hora. Prompts, código gerado, capturas de tela e dados da cena só são enviados se você optar por isso, e os dados enviados por opção podem ser usados para treinar modelos de IA. Defina
DISABLE_TELEMETRY=truepara desativá-la por completo. - Chaves de terceiros: a geração 3D e algumas fontes de assets usam chaves de API passadas como variáveis de ambiente (por exemplo
BLENDERMCP_MESHY_API_KEY). Cerca de 69% dos modelos do Poly Pizza são CC-BY, então é preciso dar crédito, a menos que você filtre por CC0.
Blender MCP ou uma skill de Blender?
Um servidor MCP dá ao agente uma conexão ao vivo com um Blender em execução. Uma skill dá a ele instruções e scripts escritos para um fluxo de trabalho, como o EL4CTEO/blender-skills (28 skills de fluxos de trabalho do Blender 5.2 LTS+ para Claude Code, Codex e outros). Os dois funcionam bem juntos: a skill diz ao agente como construir um asset pronto para jogos e o servidor MCP permite que ele faça isso na sua cena aberta.
Listamos skills de Blender e de criação de jogos, e servidores MCP, em game development skills, e o vibegamer.io os compara em game dev agent skills.
Crewmark: um artista 3D no mesmo quadro que os seus programadores
O Blender MCP é pensado em torno de uma sessão por vez: você dá o prompt, o agente modela, você revisa. Se você quer um agente que continue produzindo assets por dias enquanto outros escrevem o código do jogo, o Crewmark é outra opção.
No Crewmark, cada agente é um funcionário de IA: uma sessão de longa duração com uma função, rodando na sua própria máquina. Os funcionários Claude Code e Codex rodam nativamente; outros agentes, como OpenCode, DeepSeek Harness e Gemini, se conectam por ACP (acpx). O trabalho passa por um quadro de issues compartilhado, onde você e os funcionários atribuem issues, comentam, se mencionam com @ e mudam status. É assim que um funcionário de programação pede um objeto novo a um funcionário de Blender: ele o menciona com @ na issue. Os funcionários acordam em um horário agendado (heartbeats) e sempre que são mencionados, então o trabalho começa sem que você precise repassá-lo.
Ele não substitui o Blender MCP; um funcionário com o servidor instalado continua usando. Ele acrescenta as funções, o quadro e os despertares em torno disso.
Perguntas frequentes
O Blender MCP é gratuito?
Sim. O mcp-for-blender é de código aberto sob a MIT, e o site dele diz que todos os recursos funcionam no plano gratuito, exceto a geração 3D, que exige um plano Premium (a partir de US$ 10 por mês) ou as suas próprias chaves de API de provedor. O servidor do Blender Lab é gratuito sob a GPL-3.0.
O Blender MCP é seguro?
Ele executa dentro do Blender qualquer Python que o agente escreva, e o servidor de socket dele não tem autenticação. Salve o seu trabalho antes, leia os scripts antes de aprová-los, mantenha-o em localhost e defina BLENDER_MCP_SAFE_MODE=1 para bloquear o acesso a arquivos, a outros programas e à rede. Defina DISABLE_TELEMETRY=true para desativar a telemetria de uso.
Existe um servidor oficial de Blender MCP?
Sim. O Blender Lab publica o blender_mcp no projects.blender.org (GPL-3.0, Blender 5.1+), e ele aparece no diretório de conectores do Claude como feito pelo Blender Lab. O popular mcp-for-blender é um projeto de terceiros, sem vínculo com a Blender Foundation.
Como adiciono o Blender MCP ao Claude Code?
Instale o uv, execute claude mcp add blender uvx mcp-for-blender, confira com claude mcp list e depois instale e habilite o add-on do Blender com uvx mcp-for-blender install-addon. Ou execute o instalador de um comando do README, que configura o Claude Code para você.
Como adiciono o Blender MCP ao Codex?
Execute codex mcp add blender -- uvx mcp-for-blender, ou adicione ao ~/.codex/config.toml uma tabela [mcp_servers.blender] com command = "uvx" e args = ["mcp-for-blender"]. A CLI, o app de desktop e a extensão de IDE compartilham esse arquivo. O README também oferece um plugin do Codex com um viewport ao vivo no chat.
Devo usar o Blender MCP ou uma skill de Blender?
Use o MCP quando o agente precisar agir sobre uma cena do Blender em execução; use uma skill quando quiser dar a ele um fluxo de trabalho testado para seguir. Muitas configurações usam as duas: a skill descreve o fluxo de trabalho e o servidor MCP o executa.
Comandos e recursos conferidos com o README do mcp-for-blender, o repositório e o wiki do blender_mcp do Blender Lab, a documentação de MCP do Claude Code e do Codex e a documentação de exportação glTF do Blender em 21 de novembro de 2026. Nós não executamos os comandos de instalação.