Blender MCP · Configuração do cliente

Configurando seu cliente MCP

O Synthetic Setup faz tudo isso por você. Esta página mostra o que ele adiciona a cada cliente, caso você prefira editar a configuração manualmente: a entrada, onde ela fica em cada cliente e como verificar se o Blender está respondendo.

1. A entrada para o seu cliente

Instalar com Synthetic Setup primeiro: ele adiciona esta entrada ao Claude Desktop, Cursor, Claude Code e Codex com a sua licença, e deixa o servidor no seu computador. Para editar um cliente manualmente, o comando é node com o caminho para o servidor que o Synthetic Setup deixou na sua pasta de usuário, e a sua licença em BLENDER_MCP_LICENSE (se o Synthetic Setup instalou o Node.js para você, mantenha o comando que ele escreveu em vez de node). Substitua your-license-key pela sua chave real de /dashboard/licenses e YOUR_USER pelo seu nome de usuário nesse computador.

{
  "mcpServers": {
    "blender": {
      "command": "node",
      "args": ["C:\\Users\\YOUR_USER\\.synthetic\\launchers\\blender-mcp\\launcher.mjs"],
      "env": {
        "BLENDER_MCP_LICENSE": "your-license-key",
        "NODE_USE_SYSTEM_CA": "1"
      }
    }
  }
}

2. Onde inserir em cada cliente

Claude Desktop

Edite %APPDATA%\Claude\claude_desktop_config.json. Insira o bloco no objeto mcpServers. Se você já tiver outros servidores, adicione-o como mais uma chave.

Cursor

Ajustes → Cursor Settings → MCP → Edit Config. Cole o trecho no JSON e salve.

Codex CLI / Outros

O arquivo ~/.codex/config.toml usa o formato TOML. Converta o trecho — exemplo:

[mcp_servers.blender]
command = "node"
args = ['C:\Users\YOUR_USER\.synthetic\launchers\blender-mcp\launcher.mjs']
env = { BLENDER_MCP_LICENSE = "your-license-key", NODE_USE_SYSTEM_CA = "1" }

3. Reinicie o cliente e teste

Encerre o cliente MCP e abra-o novamente — os servidores são carregados na inicialização. Depois, abra o Blender com o add-on ativado (veja o guia de instalação) e pergunte algo ao cliente como:

Se ele responder com os seus objetos, a conexão está funcionando. Caso contrário, veja o guia de solução de problemas.