Blender BridgePortuguês
Blender Bridge MCP
O Blender Bridge MCP é um servidor MCP para Blender: ele fornece a qualquer aplicativo compatível com MCP as ferramentas para trabalhar no seu Blender. Claude Code, Codex, Cursor e outros agentes leem a cena, executam código, verificam o resultado em capturas e ajustam a cena conforme suas instruções. O servidor já vem no aplicativo Blender Bridge; não é preciso baixar ou compilar nada separado.
O que é MCP
MCP (Model Context Protocol) é o padrão aberto usado por aplicativos de IA para conectar ferramentas externas. O servidor informa ao agente quais ações estão disponíveis e o agente as usa quando a tarefa exige. Com o Blender Bridge MCP, essa lista passa a incluir ações no Blender: ler a cena, executar código, tirar uma captura, renderizar uma imagem, exportar um modelo e restaurar a cena em um ponto de controle.
Duas formas de conexão
| Local | Por endereço de servidor | |
|---|---|---|
| Para | O aplicativo de IA e o Blender no mesmo computador; o MCP se comunica diretamente com o aplicativo | Um chat ou aplicativo em qualquer dispositivo, inclusive no mesmo computador, e colaboração; os comandos passam pelo servidor do Blender Bridge |
| Como | A configuração stdio fornecida pelo aplicativo Blender Bridge | O endereço https://mcp.blenderbridge.com/mcp e sua conta do Blender Bridge |
| Onde | Claude Desktop, Claude Code, Codex, Cursor, VS Code, Windsurf, Antigravity, JetBrains AI Assistant, Gemini CLI, Cline, Kiro, Zed, LM Studio, Trae, Qwen Code, Kimi Code, Cherry Studio, CodeBuddy e Tongyi Lingma | ChatGPT, Claude, Mistral Le Chat, Perplexity, Gemini (contas pessoais nos EUA, pessoas com 18 anos ou mais, em inglês e com Keep Activity ativado) e outros aplicativos que aceitam endereço de servidor |
Uma única conexão funciona com o Blender deste computador e, depois do login, com seu computador em outro lugar.
Como conectar
Primeiro, entre no aplicativo Blender Bridge com e-mail confirmado e acesso ativo. Se ainda não tem uma conta, comece pela instalação do aplicativo.
A forma mais rápida: as instruções de configuração
No aplicativo Blender Bridge, abra a janela de conexão, escolha MCP e copie as instruções de configuração. Cole no chat do seu aplicativo e peça que conecte o Blender Bridge MCP. Agentes que podem editar suas próprias configurações, como Codex, Claude Code e Cursor, adicionam a conexão por conta própria. Se um aplicativo não permite isso, a IA explica onde adicionar a configuração.
Manualmente: a configuração stdio
Copie a configuração MCP no aplicativo; ela já contém o comando, os argumentos e o ambiente da sua instalação, então você nunca precisa digitar caminhos à mão.
- Claude Desktop — Settings → Developer → Edit Config; adicione a configuração.
- Cursor, Windsurf, Antigravity, Gemini CLI, Cline, Kiro — no arquivo de configurações MCP do aplicativo, como servidor stdio.
- VS Code — o comando MCP: Add Server ou
.vscode/mcp.json, cuja chave principal éservers, e nãomcpServers. - JetBrains AI Assistant — nas configurações do AI Assistant, em MCP.
- Zed — nas configurações de servidores de contexto.
- Qwen Code —
settings.jsonouqwen mcp add. - Kimi Code —
kimi mcp add. - Trae — configurações MCP, Add → Add Manually.
- Cherry Studio — Settings → MCP Servers.
- CodeBuddy — o arquivo
.mcp.json. - Tongyi Lingma — nos serviços MCP do plugin.
Depois de adicionar o servidor, ative-o e atualize a lista de ferramentas; reinicie o aplicativo se ele solicitar.
Por endereço de servidor
Nas configurações de conectores ou servidores MCP, adicione https://mcp.blenderbridge.com/mcp, entre com sua conta do Blender Bridge e peça à IA que liste seus computadores e escolha um. O aplicativo Blender Bridge precisa estar aberto nesse computador.
O que o agente pode fazer
| Tarefa | Ferramentas |
|---|---|
| Entender a cena | get_scene_state, take_screenshot, get_blender_info |
| Criar e alterar a cena | execute_blender_code — qualquer código Python do Blender, com uma etapa nomeada |
| Acompanhar uma operação longa | get_blender_operation_status, cancel_blender_operation |
| Voltar a uma etapa | scene_checkpoints — as etapas da IA são salvas como pontos de controle e é possível desfazer a restauração em um ponto disponível; undo_last_action |
| Consultar informações do Blender | lookup_blender_api — referência da API das versões disponíveis do Blender: 3.6, 4.2, 4.4, 4.5, 5.0, 5.1 e 5.2, search_blender_manual — manual do Blender 5.2, get_blender_recipe — receitas para tarefas comuns |
| Usar recursos prontos | find_free_assets — texturas do Poly Haven e ambientCG, modelos e ambientes HDRI do Poly Haven |
| Trabalhar com uma referência | set_reference_image, compare_reference_render — foto de referência e comparação lado a lado |
| Renderizar | render_project_image — um quadro PNG na pasta do projeto; para renderizações longas e animações, a IA inicia uma renderização em segundo plano por meio de execute_blender_code: uma cópia da cena é renderizada em outro Blender, com acompanhamento do progresso e opção de parar |
| Salvar e exportar | save_blend_file, export_model — GLB para a web e Godot, FBX para Unity e Unreal Engine, USDZ para AR, STL para impressão 3D |
| Configurar a própria conexão | open_blender, select_blender, ensure_blender_extension, restart_blender_with_extension, check_connection |
| Trabalhar em conjunto | invite_collaborator, accept_collaboration, end_collaboration |
O agente escolhe as ferramentas por conta própria. Você descreve a tarefa, por exemplo: "crie uma floresta low-poly para um jogo de celular e exporte em FBX para Unity".
Se o agente não consegue acessar o Blender
- Peça à IA para verificar a conexão com o Blender. O Blender Bridge informa exatamente o que falta: o aplicativo não está em execução, o Blender está fechado ou a extensão do Blender Bridge não está instalada. A própria IA abre o Blender, instala a extensão e reinicia o Blender.
- Se o aplicativo não encontra o servidor, copie novamente a configuração do aplicativo, ative o servidor e atualize a lista de ferramentas ou reinicie o aplicativo.