SyntheticSynthetic/Docs
ProdutosNovidades
Dashboard →

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

Blender5.1 ou 5.2 LTS
Node.js18 ou superior
OSWindows 10/11 · macOS (beta: pode ter erros)
Cliente MCPClaude Desktop, Cursor, Codex ou qualquer cliente MCP
LicençaSua 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\.

O Synthetic Setup também cuida do Node.js: se o seu computador não o tiver, ele o adiciona para seus clientes MCP.

3. Ative o complemento no Blender

Faça isso uma vez para cada versão do Blender:

  1. No Blender, abra Editar → Preferências → Complementos.
  2. Abra o menu no canto superior direito da lista, escolha Instalar do Disco… e selecione o arquivo synthetic_blender_mcp.py da pasta do passo 2.
  3. 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.

O add-on é um software livre sob a GNU GPL versão 3, conforme exigido pelo Blender para add-ons; o servidor MCP é um software próprio da Synthetic e requer a sua licença.

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.

Importante: o Blender deve estar aberto, com o add‑on habilitado, sempre que seu cliente MCP executar uma ferramenta. Caso contrário, as ferramentas indicarão que o Blender não está conectado.