Beta aberto do Unity AI: Como começar a usar o MCP
No artigo de hoje sobre o Beta Aberto do Unity AI, saiba como conectar o Claude Code, o GitHub Copilot e outros agentes de IA diretamente ao Editor do Unity usando o servidor do Protocolo de Contexto de Modelo (MCP) do Unity.
O MCP Server da Unity AI oferece uma nova maneira de trabalhar com agentes de IA no seu IDE. Em vez de alternar entre o editor de código e o Unity, você pode conectar agentes como o Claude Code, o Cursor, o Windsurf ou o VS Code Copilot diretamente ao seu projeto do Unity em execução — e permitir que o IDE tenha acesso ao contexto completo do projeto, como inspecionar cenas, ler a saída do console, editar scripts e acionar ações do Editor, sem que você precise copiar e colar o contexto.
Esta publicação explica o que é o MCP, como conectar um agente, quais ferramentas estão disponíveis e como você pode usá-lo para agilizar tarefas comuns de desenvolvimento, como corrigir bugs e gerenciar cenas.
O que é o Protocolo de Contexto de Modelo?
O Protocolo de Contexto de Modelo (MCP) é um padrão aberto que permite que agentes de IA se comuniquem com ferramentas externas e fontes de dados de maneira estruturada. O servidor MCP do Unity implementa esse protocolo para que qualquer agente de IA compatível com MCP possa se conectar ao Editor do Unity e interagir com ele como se fosse um conjunto de ferramentas que podem ser chamadas.
Sem o MCP, um agente de IA no seu IDE vê apenas o que você mostra a ele: os arquivos que você tem abertos, o código que você cola ou os erros que você copia. Com o MCP, você tem acesso em tempo real ao estado de execução do seu projeto do Unity — hierarquia de cenas, GameObjects, valores de componentes, configurações de compilação e mensagens do console — por meio de um protocolo padronizado.
O servidor MCP oficial do Unity está incluído no pacote do AI Assistant e requer uma assinatura do Unity para ser utilizado (embora não consuma créditos do Unity AI).
Pré-requisitos
Para começar a usar o MCP, seu ambiente deve atender aos seguintes requisitos:
- Unity 6 (6000.0) ou versão posterior com o pacote AI Assistant instalado
- Um cliente de IA compatível com MCP, como o Claude Code, o Cursor, o Windsurf ou o Claude Desktop
- Um projeto do Unity conectado ao Unity Cloud
- Uma versão de avaliação ou assinatura ativa do Unity AI
Como integrar um agente de IA ao Unity
A configuração do Unity MCP leva apenas alguns minutos. Aqui está o processo completo:
1. Verifique se a ponte Unity MCP está em execução
No Editor do Unity, vá para Editar > Configurações do projeto > Unity AI > Unity MCP. Verifique se o Unity Bridge está exibindo “Em execução” (indicador verde). A ponte é iniciada automaticamente quando o Editor é carregado. Se aparecer “Parado”, selecione “Iniciar”.
2. Configure seu cliente de IA
A seção “Integrações” da página de configurações do Unity MCP permite configurar automaticamente os clientes compatíveis – expanda “Integrações”, selecione o seu cliente e clique em “Configurar”. Os clientes compatíveis podem incluir o Claude Code, o Cursor, o Windsurf e o Claude Desktop, dependendo da sua versão do Unity MCP.
3. Adicione o caminho do Relay manualmente (se necessário)
Se o seu cliente não estiver na lista de configuração automática, adicione uma entrada de servidor que aponte para o binário do Unity Relay. O Relay é instalado em ~/.unity/relay/ quando o Unity é iniciado. Passe --mcp como um argumento de linha de comando ao executável do Relay.
4. Aprovar a conexão no Unity
Na primeira vez que seu agente se conectar, o Unity exibe uma mensagem informando que a conexão está pendente. Vá em Editar > Configurações do projeto > IA > Unity MCP, verifique os detalhes do cliente e selecione Aceitar. Os clientes já aprovados são reconectados automaticamente.
5. Teste a conexão
Seu agente deve agora listar as ferramentas do Unity MCP disponíveis. Execute um comando simples como “Leia as mensagens do console do Unity e resuma quaisquer avisos ou erros” para verificar se a conexão está funcionando.
Caminhos de retransmissão específicos da plataforma
O caminho binário do Relay varia de acordo com o sistema operacional. Use o caminho específico para a sua plataforma ao configurar o agente manualmente:
- macOS (Apple Silicon): ~/.unity/relay/relay_mac_arm64.app/Contents/MacOS/relay_mac_arm64
- macOS (Intel): ~/.unity/relay/relay_mac_x64.app/Contents/MacOS/relay_mac_x64
- Windows: %USERPROFILE%\.unity\Relay\Relay_win.exe
- Linux: ~/.unity/Relay/Relay_linux
Ferramentas disponíveis
Depois de conectado, seu agente de IA passa a ter acesso a um conjunto de ferramentas integradas do Unity MCP. Essas ferramentas são o que o agente aciona quando você lhe dá instruções — ele não interage diretamente com o Unity, mas sim por meio do protocolo.
As principais categorias de ferramentas incluem:
- Gerenciamento de cenas: ler a hierarquia, criar/modificar/excluir GameObjects, gerenciar cenas
- Edição de scripts: crie, leia e modifique scripts em C# no seu projeto
- Acesso ao console: ler registros, avisos e erros no console do Unity
- Inspeção de GameObjects: ler e gravar valores de componentes em GameObjects específicos
- Configurações de compilação: verificar a plataforma e a configuração de compilação
Você também pode registrar ferramentas MCP personalizadas em C# para disponibilizar seus próprios fluxos de trabalho de editor aos agentes conectados – o que é útil para equipes que desejam automatizar tarefas específicas de cada projeto.
Controlando o Unity a partir de um agente de IA
Com a conexão MCP ativa, você pode dar instruções em linguagem natural ao seu agente de IA, e ele as executará usando as ferramentas do Unity. Alguns exemplos:
- “Crie um novo GameObject vazio chamado PlayerSpawn na posição (0, 0, 0)”
- “Analise a hierarquia da cena e me diga quais objetos têm componentes faltando”
- “Escreva um script que mova a câmera para acompanhar o jogador e anexe-o à câmera principal”
- “Verifique se há erros no console e corrija tudo o que estiver relacionado a referências nulas”
O agente utiliza as ferramentas do MCP para executar cada etapa, mostrando seu raciocínio e as chamadas de ferramentas que realiza. Você permanece no seu IDE o tempo todo — não precisa alternar para Unity até que queira verificar o resultado.
Corrigindo erros de console com o Unity MCP
Uma das utilidades mais práticas do Unity MCP é permitir que seu agente leia e corrija erros do console de forma autônoma. Como o agente pode tanto ler o console quanto editar scripts na mesma sessão, ele consegue passar do erro à correção sem que você precise copiar nada:
1. O agente lê o console por meio do Unity_ReadConsole
2. Identifica o script relevante e lê seu conteúdo
3. Aplica uma correção e salva o arquivo de volta no projeto
4. Verifica o console novamente para confirmar se o erro foi resolvido
Isso fecha o ciclo de feedback que normalmente exige copiar e colar manualmente entre o Unity e um assistente de IA – o agente cuida de tudo do início ao fim.
Mais informações sobre o Unity AI
Se você quiser saber mais sobre o que está disponível na versão beta aberta do Unity AI, convidamos você a ler outros artigos desta série:
Experimente o Unity AI hoje mesmo
A versão beta aberta do Unity AI já está disponível para todos os desenvolvedores do Unity 6. Inscreva-se para um teste gratuito, explore o Unity AI Assistant, conecte suas ferramentas preferidas através do Unity AI Gateway e comece a experimentar como fica seu fluxo de trabalho de desenvolvimento com um agente de IA integrado e sensível ao projeto.
Cadastre-se e saiba mais sobre planos, preços e privacidade de dados em unity.com/features/ai
A documentação completa está disponível na seção de documentação do Unity AI, acessível através do link no Editor, ou em docs.unity3d.com.
O Unity AI Assistant está atualmente em fase de beta aberta. Portanto, os recursos, o comportamento e a disponibilidade descritos nesta publicação estão em fase de desenvolvimento ativo e podem sofrer alterações, ser limitados ou ser descontinuados sem aviso prévio.