Dev Logs

Como Gerar Modelos 3D com IA usando Claude + Blender (Guia Completo)

Kauã Miguel
Kauã Miguel

Criador do Blog e Desenvolvedor FullStack

7 min de leitura

Capa do post

Imagina descrever um objeto 3D com palavras e ver ele surgindo na tela do Blender? Isso já é possível usando o Model Context Protocol (MCP) para conectar o Claude diretamente ao Blender.

Se preferir a versão rápida, tem um vídeo no meu canal:

Neste guia completo, vou te mostrar passo a passo como configurar tudo e começar a gerar modelos 3D usando apenas prompts de texto.


O que é MCP (Model Context Protocol)

O MCP é um protocolo criado pela Anthropic que permite que o Claude se conecte a aplicações externas. Em vez de apenas conversar, o Claude pode executar ações reais em softwares como o Blender.

Como funciona na prática:

Você envia um prompt como "crie um cubo vermelho", o MCP traduz isso em comandos Python do Blender, e o objeto aparece na sua cena. Simples assim.


Pré-requisitos

Antes de começar, você precisa ter instalado:

  • Claude Desktop - Download aqui
  • Blender 3.6+ - Download aqui
  • uv (gerenciador de pacotes Python) - Instalado automaticamente
  • Conexão com internet

Nota: O Blender MCP funciona com Blender 3.6 ou superior. Se você tiver uma versão mais antiga, atualize antes de continuar.


Passo 1: Baixar o Addon do Blender MCP

Primeiro, precisamos baixar o addon que vai permitir o Blender se comunicar com o Claude.

  1. Acesse o repositório oficial: https://github.com/ahujasid/blender-mcp
  2. Clique no arquivo addon.py na lista de arquivos
  3. Clique no botão "Download raw file" (ícone de download no canto superior direito)
  4. Salve o arquivo em um local fácil de encontrar

GitHub - Onde baixar o addon


Passo 2: Instalar o Addon no Blender

Com o arquivo baixado, vamos instalar no Blender:

  1. Abra o Blender
  2. Vá em Edit → Preferences (ou Ctrl + ,)
  3. Na janela que abrir, clique na aba Add-ons (menu lateral esquerdo)
  4. Clique na setinha ↓ no canto superior direito
  5. Selecione Install from Disk...
  6. Navegue até o arquivo addon.py que você baixou e selecione-o
  7. Marque o checkbox ao lado de "Blender MCP" para ativar o addon

Blender - Menu Edit Preferences


Passo 3: Iniciar o Servidor MCP no Blender

Agora precisamos iniciar o servidor que vai receber os comandos do Claude:

  1. No Blender, pressione a tecla N para abrir o painel lateral direito
  2. Procure a aba "BlenderMCP" nas abas do painel
  3. Clique no botão "Start Server"
  4. Você verá uma mensagem confirmando que o servidor está rodando

Importante: O servidor precisa estar rodando para o Claude conseguir se comunicar com o Blender. Sempre inicie o servidor antes de usar o Claude Desktop.

Painel BlenderMCP


Passo 4: Configurar o Claude Desktop

Agora vamos configurar o Claude Desktop para se conectar ao Blender:

  1. Abra o Claude Desktop
  2. Clique no menu e vá em Settings (Configurações)
  3. Na seção Developer (Desenvolvedor), clique em Edit Config
  4. Isso vai abrir um arquivo JSON. Cole o seguinte conteúdo:
json
"mcpServers": "blender": "command": "uvx", "args": ["blender-mcp"]
  1. Salve o arquivo (Ctrl + S)
  2. Feche completamente o Claude Desktop
  3. Abra novamente o Claude Desktop

Atenção: Você precisa reiniciar o Claude Desktop completamente para as configurações serem aplicadas. Só fechar a janela não basta - feche o processo.


Passo 5: Testar a Conexão

Hora de testar se tudo está funcionando:

  1. Certifique-se que o Blender está aberto com o servidor MCP rodando
  2. Abra o Claude Desktop
  3. Procure por um ícone de martelo (ferramentas) na interface - isso indica que as ferramentas MCP estão disponíveis
  4. Teste com um prompt simples:
text
Create a red cube in the center of the scene

Se tudo estiver configurado corretamente, você verá o Claude executar comandos e um cubo vermelho vai aparecer no Blender!

Configuração Extra: Sketchfab (Modelos Prontos)

Quer ir além de objetos básicos? Você pode configurar o Blender MCP para baixar modelos prontos diretamente do Sketchfab - uma biblioteca com milhões de modelos 3D.

Como configurar:

  1. Crie uma conta gratuita no Sketchfab
  2. Acesse a página de API: https://sketchfab.com/settings/password
  3. Role até encontrar API Token e gere uma nova chave
  4. Copie a chave gerada
  5. No Blender, no painel BlenderMCP, cole a API Key no campo do Sketchfab
  6. Ative a opção "Use assets from Sketchfab"

Exemplo de uso:

text
Search Sketchfab for "sneaker shoe" and add it to the scene with studio lighting

Exemplos de Prompts

Aqui estão alguns prompts legais para você testar:

Objetos simples:

text
Create a low-poly tree with green leaves and brown trunk
text
Create a red metallic cube with rounded edges
text
Create a soccer ball with black and white hexagonal pattern

Com Sketchfab:

text
Search Sketchfab for "Nike sneaker" and place it on a white pedestal with soft lighting
text
Search Sketchfab for "wristwatch" and create a product photography setup

Cenas completas:

text
Create a beach scene with palm trees and rocks using assets from Poly Haven
text
Create a low-poly dungeon environment with a dragon guarding treasure

Materiais e iluminação:

python
# Exemplo de comando para material Add a brushed metal material to the selected object
python
# Iluminação profissional Create a 3-point lighting setup for product photography
python
# Ambiente HDRI Add a sunset HDRI to the scene

Solução de Problemas Comuns

Erro de conexão / Claude não encontra as ferramentas

  • Verifique se o servidor MCP está rodando no Blender (deve mostrar "Server running")
  • Reinicie o Claude Desktop completamente (feche o processo, não só a janela)
  • Confira se o arquivo de config JSON está correto (sem vírgulas extras, aspas corretas)
  • Não rode o comando uvx blender-mcp manualmente no terminal - o Claude faz isso automaticamente

O primeiro comando não funciona

Isso é normal! Às vezes o primeiro comando falha por timeout. Tente novamente que geralmente funciona na segunda tentativa.

Timeout em comandos complexos

Para comandos mais elaborados, tente quebrar em passos menores:

bash
# Em vez de um comando gigante: # "Create a complete living room scene with sofa, table, TV and plants" # Faça em partes: Create a modern sofa # espere completar Add a coffee table in front of the sofa # espere completar Add a TV stand with a flat screen TV

Blender trava ou fica lento

Modelos muito complexos do Sketchfab podem sobrecarregar. Tente usar modelos mais simples ou low-poly para testes iniciais.


Recursos Adicionais

RecursoLink
Repositório oficialgithub.com/ahujasid/blender-mcp
Documentação MCPmodelcontextprotocol.io
Poly Haven (texturas grátis)polyhaven.com
Sketchfab (modelos 3D)sketchfab.com

Conclusão

Neste guia você aprendeu a:

  • Configurar o Blender MCP para conectar o Claude ao Blender
  • Instalar e ativar o addon necessário
  • Gerar modelos 3D usando apenas prompts de texto
  • Usar o Sketchfab para baixar modelos prontos diretamente pelo Claude

A combinação de IA + 3D abre possibilidades incríveis para prototipagem rápida, criação de assets e experimentação. Teste, explore e crie!

Se preferir a versão em vídeo, confira no meu canal:


Gostou do conteúdo? Compartilha com alguém que curte 3D ou IA!

continue lendo

Outros Dev Logs

© 2025 Kauã Miguelkc1t.com · São Paulo