Blender MCP · Instalação
Instalando o Blender MCP
O Blender MCP é um servidor que roda no seu computador e que o seu cliente MCP inicia (Claude Desktop, Cursor, Claude Code, Codex). Você o instala com o Synthetic Setup. Ele se comunica com o Blender através do complemento Synthetic Blender MCP, que você ativa uma única vez no Blender. Verificado no Windows.
Requisitos
| Blender | 5.1 ou 5.2 LTS |
| Node.js | 18 ou superior |
| OS | Windows 10/11 · macOS (beta: pode ter erros) |
| Cliente MCP | Claude Desktop, Cursor, Codex ou qualquer cliente MCP |
| Licença | Sua chave de licença do Blender MCP (veja /dashboard/licenses) |
1. Instalar com o Synthetic Setup
Baixe o Synthetic Setup em /dashboard/downloads e execute-o. Ele encontrará seus clientes MCP (Claude Desktop, Cursor, Claude Code, Codex) e adicionará o Blender MCP a cada um deles com sua licença já carregada.
Prefere editar a configuração do seu cliente manualmente? O Guia de configuração do cliente MCP mostra a entrada exata.
2. Reinicie seu cliente MCP
Feche seu cliente MCP e abra-o novamente: os servidores são carregados na inicialização. Na primeira vez, o servidor é baixado em poucos segundos e, assim que sua licença for verificada, ele deixa o add-on do Blender no seu computador, em C:\Users\YOUR_USER\.synthetic\mcp\blender-mcp\<version>\blender-addon\.
3. Ative o complemento no Blender
Faça isso uma vez para cada versão do Blender:
- No Blender, abra Editar → Preferências → Complementos.
- Abra o menu no canto superior direito da lista, escolha Instalar do Disco… e selecione o arquivo
synthetic_blender_mcp.pyda pasta do passo 2. - Verifique se o “Synthetic Blender MCP” está ativado na lista.
O add-on inicia com o Blender automaticamente. O status dele fica na barra lateral da 3D Viewport (pressione N) → aba Synthetic MCP.
4. Teste
Com o Blender aberto, peça algo simples ao seu cliente MCP:
Qual versão do Blender está aberta e quais objetos estão na cena?Se ele responder com a sua versão do Blender e os seus objetos, tudo está funcionando. Agora tente algo maior: crie uma cena pequena, ilumine-a e faça a renderização.