Como Conectar o Claude Code ao Unity MCP: Instalação e Configuração
Instale o Unity MCP e conecte via Claude CLI: importe pelo Package Manager, ative, inicie o Servidor MCP local (porta 6589), copie o comando CLI e verifique a …
- unity
- mcp
- claude-code
- tutorial
- unity-mcp
- ai
O Que Este Guia Abrange
Siga estes cinco passos para conectar o Unity MCP a um projeto Unity local para que o Claude CLI possa operar, visualizar e depurar o editor—não apenas editar scripts no disco.
Ao terminar, você deverá ser capaz de:
- Importar o Unity MCP via Package Manager Add package from disk
- Completar a ativação do plugin (conta ou código de ativação—siga seu Mcp Panel)
- Iniciar o Unity MCP Server local (porta padrão 6589)
- Copiar o comando CLI do Quick setup, executá-lo no Claude CLI e confirmar a conexão MCP
Página de download: Unity MCP
Este guia usa o Claude CLI. Para o Gemini CLI, escolha o cliente correspondente no Quick setup e copie seu comando CLI da mesma forma.
Pré-requisitos
| Item | Observações |
|---|---|
| Unity | 2022.3+ / Unity 6 recomendado (siga as notas de suporte atuais para sua versão) |
| Pacote do plugin | Arquivo do Unity MCP baixado e descompactado |
| Ativação | Conta + senha do plugin, ou e-mail + código de ativação (conforme o Mcp Panel) |
| IDE de IA | Claude CLI (mesmo fluxo para o Gemini CLI) |
| Rede local | A ponte MCP geralmente roda em 127.0.0.1—não exponha a porta publicamente |
Passo 1: Baixar o Unity MCP
Baixe o plugin no site ou na página de releases do fornecedor do Unity MCP:
Exemplo de página de download: [https://www.vberai.com/pt/game-engines/unity?ch=CQZLC2FG)
Fluxo sugerido:
- Abra a página de download e obtenha o arquivo do Unity MCP
- Salve-o localmente e descompacte em uma pasta fixa (o próximo passo precisa do
package.jsondentro dela) - Confirme que
package.jsonexiste na pasta descompactada antes de abrir o Unity
Diferenças de licenciamento e edição variam por fornecedor—siga a documentação oficial deles.
Passo 2: Importar o pacote
- Abra seu projeto Unity de destino
- Menu Window → Package Manager
- Clique em + no canto superior esquerdo do painel do Package Manager
- Escolha Add package from disk
- Selecione o arquivo
package.jsonda pasta descompactada no Passo 1
Após uma importação bem-sucedida, o pacote Unity MCP deverá aparecer na lista do Package Manager.

Passo 3: Ativar o unity-mcp
- Menu Window → Unity MCP → Mcp Panel
- Na tela de ativação, faça uma das opções:
- Entre com conta + senha
- Ou insira e-mail + código de ativação
- Após a ativação bem-sucedida, abra a página de configurações do MCP Server (próximo passo)
Sem ativação, o serviço geralmente não inicia. Confirme que sua conta ou código corresponde à versão do plugin que você instalou.

Passo 4: Iniciar o unity-mcp-server
- Após a ativação, abra a página de configurações do Unity MCP Server
- Ajuste conforme necessário:
- Porta: padrão
6589 - Idioma: corresponda à sua preferência de interface
- Inicialização: siga as opções do painel (por exemplo, iniciar automaticamente com o editor, se disponível)
- Porta: padrão
- Clique em Start service
- Quando o painel mostrar Running, o Unity MCP Server está ativo
Agora você tem uma ponte MCP local—em seguida, configure o Claude CLI.

Passo 5: Configurar o Claude CLI
- Abra Tool management
- Revise as ferramentas expostas pelo Unity MCP Server
- Habilite apenas o que você deseja que o modelo use
- Abra Quick setup
- Escolha Claude CLI (Gemini CLI funciona da mesma forma—selecione esse cliente)
- Claude CLI / Gemini CLI não suportam Auto configure—clique em Copy no CLI command exibido no painel

- Abra um terminal do sistema, cole e execute o comando copiado (em um ambiente onde o Claude CLI esteja instalado)
- Volte ao Claude CLI e confirme que unity-mcp (ou o nome registrado equivalente) aparece na lista de MCP

Verificação rápida após conectar
No Claude CLI, comece com uma verificação somente leitura, por exemplo:
Liste os objetos raiz na Hierarchy da cena atualmente aberta no Unity.
Se a resposta corresponder ao editor, a ponte está saudável. Em seguida, tente uma pequena escrita (crie um GameObject vazio temporário e exclua-o) para confirmar permissões e seleção de ferramentas.
FAQ
Add package from disk não encontra o package.json?
Confirme que o Passo 1 descompactou totalmente o arquivo e que você selecionou package.json na raiz dessa pasta—não uma extração aninhada.
A ativação continua falhando?
Verifique se sua conta ou código de ativação é válido, não expirou e está vinculado ao e-mail correto, depois tente novamente no Mcp Panel.
Iniciou o serviço mas não está Running?
Garanta que a porta 6589 (ou sua porta personalizada) esteja livre e que o localhost não esteja bloqueado. Confirme que a ativação do Passo 3 foi bem-sucedida.
O Claude CLI não mostra unity-mcp?
Confirme que o Unity ainda mostra Running; volte ao Quick setup, copie o comando CLI novamente e execute-o completamente no terminal. Certifique-se de ter escolhido Claude CLI, não Cursor. Para o Gemini CLI, escolha Gemini CLI e copie o comando desse cliente.
Próximos passos
- Tente uma consulta de cena em linguagem natural ou uma pequena edição para aprender os limites das ferramentas
- Faça commit antes de grandes alterações; mantenha a ponte apenas no localhost
- Padrões de prompt após conectar: Unity MCP com Claude Code e Cursor
Continuar lendo
Mais guias que podem interessar
Safe Area da UI de Jogo e QA de Dispositivos: Ordem de Debug e Correções em Prefabs
Quando o Editor Unity parece certo mas o notch corta o HUD ou os toques falham: classifique falhas, depure Canvas Scaler e Screen.safeArea, corrija Prefabs vs …
- game-ui-design
- game-dev-ai
- ui-to-engine
- safe-area
Modelos 3D com IA no VberAI Studio: Text-to-3D e Image-to-3D (Meshy, Tripo, Hunyuan3D) — Editar, Renderizar e Exportar para Engine
Text-to-3D e image-to-3D no VberAI Studio com Meshy, Tripo e Hunyuan3D: PBR, GLB/FBX/USDZ, retopo, rigging, renders em turntable e exportação para Unity, Godot…
- vberai
- ai-studio
- 3d-model
- text-to-3d
Cursor Quebrado Após Cocos Creator MCP: Corrija a Conexão por Sintoma
Cursor parece 'quebrado' após conectar o VberAI Cocos Creator MCP: serviço ausente, erros MCP vermelhos, conectado mas sem ferramentas. Verifique o Cursor prim…
- cocos
- cocos-creator
- mcp
- cursor