Como Executar o Blender MCP no Windows 11 (com Cursor)

Blender MCP é uma ferramenta essencial para integrar Blender com ferramentas como Cursor, permitindo que desenvolvedores otimizem seu fluxo de trabalho. No entanto, muitos usuários enfrentam problemas, como o erro Cliente Fechado, ao tentar fazer o MCP funcionar no Windows 11.

Este guia cobre tudo que você precisa saber sobre MCP, seu processo de configuração e como solucionar problemas comuns.

O que é MCP?

MCP (Processamento de Código Modular) é um sistema que permite que o Cursor interaja com aplicativos externos como Blender. Ele habilita automação, execução de scripts e interações impulsionadas por IA dentro do Blender, facilitando a execução de tarefas como:

• Renderização automatizada
• Execução de scripts
• Edição ao vivo com suporte de IA

Em resumo, MCP atua como uma ponte entre Cursor e Blender, permitindo uma integração mais fluida e aumentando a produtividade.

Blender + MCP, a Mágica da Programação

Se você é um desenvolvedor ou designer usando Blender, MCP com Cursor oferece vários benefícios:
- Desenvolvimento Impulsionado por IA – Escreva e execute scripts de forma mais eficiente.
- Integração Sem Costura – Automatize tarefas do Blender diretamente do Cursor.
- Fluxo de Trabalho Mais Rápido – Evite alternar entre várias ferramentas usando uma única interface.

blender mcp 🤯🤯🤯

create an airplane model

crazy!!!!!! pic.twitter.com/wHjsO8nQPz

— Melvin Vivas (@donvito) 14 de março de 2025

No entanto, devido a alguns problemas de compatibilidade com o Windows 11, fazer com que o Blender MCP funcione corretamente requer alguma configuração manual.

Problema Comum: Erro ‘Cliente Fechado’ no Windows 11

Many users report that MCP fails to start properly, showing a ‘Client Closed’ error. The primary reasons for this include:
- Configuração de Caminho Incorreta – O arquivo de configuração do MCP não aponta para o diretório correto.
- Falta do Gerenciador de Pacotes uv – O MCP requer uv para funcionar corretamente.
- Restrições de Firewall/Antivírus – Configurações de segurança podem bloquear a conexão do MCP.

Siga os passos abaixo para corrigir esses problemas e garantir que o Blender MCP funcione sem problemas no Windows 11.

Passo 1: Instalar o Gerenciador de Pacotes uv

Antes de configurar o Blender MCP, você precisa instalar uv, que é necessário para gerenciar as dependências do MCP.

Instalando uv no Windows 11

Abra PowerShell ou Prompt de Comando com privilégios de administrador.

Execute o seguinte comando:

curl -fsSL https://astral.sh/uv/install.sh | sh

Reinicie seu computador para aplicar as alterações.

Para verificar a instalação, execute:

uv --version

Se o comando retornar um número de versão, uv foi instalado com sucesso.

Passo 2: Configurar as Configurações do MCP

O Blender MCP requer um arquivo de configuração (mcp.json) para especificar o caminho executável correto.

Editando mcp.json

Navigate to your Cursor configuration directory.

Localize o arquivo mcp.json. Se ele não existir, crie um.

Abra-o em um editor de texto como VS Code ou Notepad++.

Adicione a seguinte configuração:

{
  "mcpServers": {
    "blender": {
      "command": "C:\\Users\\<seu-nome-de-usuário>\\.local\\bin\\uvx.exe",
      "args": ["blender-mcp"]
    }
  }
}

• Certifique-se de substituir <seu-nome-de-usuário> pelo seu nome de usuário do Windows real.
• Verifique se o caminho do arquivo para uvx.exe está correto.

Salve e feche o arquivo.

Passo 3: Reinicie e Atualize o Cursor

Após atualizar sua configuração, siga estas etapas:

1. Reinicie seu PC para aplicar as mudanças.
2. Abra Cursor e verifique se o Blender MCP está listado entre as integrações disponíveis.
3. Se o MCP não aparecer:

• Pressione Ctrl + Shift + R para atualizar manualmente o Cursor.
• Atualize o Cursor uma ou duas vezes.
• Aguarde alguns segundos para que o sistema reconheça o MCP.

1. Se tudo estiver configurado corretamente, você deve ver um indicador verde ao lado do Blender MCP, confirmando que está funcionando corretamente.

Passo 4: Solução de Problemas Adicional

Se o MCP ainda não estiver funcionando, tente essas correções:

1. Execute o Cursor como Administrador

Alguns recursos requerem permissões elevadas para funcionar corretamente.

• Clique com o botão direito no atalho do Cursor e selecione Executar como administrador.

2. Reinstale o MCP

Se o MCP estiver faltando ou corrompido, reinstale usando:

uv install blender-mcp

3. Verifique as Configurações de Firewall e Antivírus

O Firewall do Windows ou o software antivírus podem bloquear a conexão do MCP.

• Adicione Cursor e Blender MCP à lista de exceções do Windows Defender.
• Desative temporariamente seu antivírus e verifique se o MCP inicia.

Passo 5: Verifique se o MCP está Funcionando

Uma vez que tudo esteja configurado, teste o MCP executando um script simples no Cursor.

Abra o Cursor e crie um novo script do Blender.

Copie e cole este comando Python:

import bpy
bpy.ops.mesh.primitive_cube_add()

Execute o script e verifique se um cubo aparece no Blender.
-  Se o script for executado com sucesso, o MCP está totalmente operacional!

Vibecoding ➡️ Vibesculpting (in 3D)

I generated a 3D model of a Spitfire-looking plane in Blender, using Claude 3.7 + Blender MCP (link below 👇), piece by piece... using natural language only.

Seeing this alongside Google's new image edition demo, I think we're ahead of a true… pic.twitter.com/UNzwn79ioY

— Emm 🔜 GDC 2025 (@emmanuel_2m) 15 de março de 2025

Conclusão

Configurar o Blender MCP no Windows 11 pode ser complicado, mas seguindo este guia, você deve ter uma integração totalmente funcional entre Cursor e Blender.

Pontos Importantes:

✔ Instale uv para gerenciar as dependências do MCP.
✔ Atualize mcp.json com o caminho correto para uvx.exe.
✔ Reinicie o Cursor e seu PC para aplicar as alterações.
✔ Solucione problemas verificando permissões, reinstalando o MCP e ajustando as configurações do firewall.

Com esses passos, você pode agora usar o Blender MCP de forma integrada no Cursor, desbloqueando automação poderosa e fluxos de trabalho assistidos por IA.