Unity AI Open Beta: Como começar com o MCP

No artigo de hoje sobre a Unity AI Open Beta, saiba como conectar Claude Code, GitHub Copilot e outros agentes de IA diretamente ao Editor Unity com o Model Context Protocol (MCP) Server da Unity.

O MCP Server do Unity AI abre uma nova maneira de trabalhar com agentes de IA no seu IDE. Em vez de alternar entre o editor de código e Unity, você pode conectar agentes como Claude Code, Cursor, Windsurf ou VS Code Copilot diretamente ao projeto em execução Unity - e permitir que o IDE obtenha o contexto completo do projeto, como inspecionar cenas, ler a saída da consola, editar scripts e ativar ações do Editor sem ter que copiar e colar o contexto.

Este post passa por o que é o MCP, como conectar um agente, quais ferramentas estão disponíveis e como você pode usá-lo para acelerar tarefas de desenvolvimento comuns, como corrigir bugs e gerenciar cenas.

O que é o Protocolo de Contexto Modelo?

O Model Context Protocol (MCP) é um padrão aberto que permite aos agentes da IA comunicar de forma estruturada com ferramentas externas e fontes de dados. O MCP Server da Unity implementa este protocolo para que qualquer agente de IA compatível com o MCP possa se conectar ao Editor Unity e interagir com ele como se fosse um conjunto de ferramentas chamáveis.

Sem MCP, um agente de IA em seu IDE só vê o que você mostra: os arquivos que você abriu, o código que você colou ou os erros que você copia. Com o MCP, ele tem acesso em tempo real ao estado de execução do seu projeto Unity – hierarquia de cena, GameObjects, valores de componentes, configurações de construção e mensagens da consola – através de um protocolo padronizado.

O servidor MCP oficial da Unity está incluído no pacote AI Assistant e requer uma subscrição da Unity para ser usado (embora os créditos da Unity AI não sejam consumidos).

Requisitos prévios

Para começar a usar o MCP, seu ambiente deve atender aos seguintes requisitos:

• Unity 6 (6000.0) ou posterior com o pacote AI Assistant instalado
• Um cliente de IA compatível com MCP, como Claude Code, Cursor, Windsurf ou Claude Desktop
• Um projeto Unity conectado ao Unity Cloud
• Uma trial ativa ou subscrição para Unity AI

Como integrar um Agente de IA com 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 Unity, vá para Editar > Configurações de Projeto > AI > Unity MCP. Verifique se Unity Bridge mostra Corrida (indicador verde). A ponte inicia-se automaticamente quando o Editor carrega. Se mostrar Parou, selecione Início.

2. Configure seu cliente de IA

A seção Integrações da página Configurações do Unity MCP pode configurar automaticamente clientes suportados – expanda Integrações, selecione seu cliente e selecione Configurar. Os clientes suportados podem incluir Claude Code, Cursor, Windsurf e Claude Desktop, dependendo da versão do MCP do Unity.

3. Adicione o caminho do Relay manualmente (se necessário)

Se o cliente não estiver na lista de configuração automática, adicione uma entrada de servidor que aponte para o binário Unity Relay. O Relay é instalado em ~/.unity/relay/ quando Unity é iniciado. Passe --mcp como um argumento de linha de comando para o executável Relay.

4. Aprovar a conexão em Unity

A primeira vez que o agente se conecta, o Unity exibe uma mensagem de Conectividade pendente. Vá para Editar > Configurações de Projeto > AI > Unity MCP, examine os detalhes do cliente e selecione Aceitar. Clientes aprovados anteriormente se reconectam automaticamente.

5. Teste a conexão

Seu agente deve agora listar as ferramentas Unity MCP disponíveis. Execute um comando simples como “Leia as mensagens da consola Unity e resume quaisquer avisos ou erros” para verificar se a conexão está funcionando.

Pases de Relay específicas de plataforma

O caminho binário Relay varia de acordo com o sistema operacional. Use o caminho para sua plataforma ao configurar seu 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

Uma vez conectado, seu agente de IA ganha acesso a um conjunto de ferramentas de MCP Unity integradas. Essas ferramentas são o que o agente chama quando você dá instruções - ele não interage diretamente com Unity, ele passa pelo protocolo.

As categorias de ferramentas principais incluem:

• Gestão de cenas: ler hierarquia, criar/modificar/deletar GameObjects, gerenciar cenas
• Editar scripts: criar, ler e modificar scripts C# em seu projeto
• Acesso à consola: leia logs, avisos e erros da consola Unity
• Inspecção de GameObject: leitura e escrita de valores de componentes em GameObjects específicos
• Configurações de construção: inspeccione a plataforma e a configuração de construção

Você também pode registrar ferramentas MCP personalizadas em C# para expor seus próprios fluxos de trabalho de editor a agentes conectados – útil para equipes que querem automatizar tarefas específicas de projetos.

Controlando Unity a partir de um agente de IA

Com a ligação MCP ativa, você pode dar instruções em linguagem natural ao seu agente de IA e ele as executará usando as ferramentas da Unity. Alguns exemplos:

• “Criar um novo GameObject vazio chamado PlayerSpawn em posição (0, 0, 0)”
• “Leia a hierarquia da cena e diga-me quais objetos têm componentes ausentes”
• “Escreva um script que mova a câmera para seguir o jogador, e anexá-lo à câmera principal”
• “Verifique a consola para erros e corrigir qualquer coisa relacionada a referências null”

O agente usa as ferramentas MCP para executar cada passo, mostrando seu raciocínio e as chamadas de ferramenta que ele faz. Você permanece em seu IDE durante todo o tempo - você não precisa mudar para Unity até que você queira revisar o resultado.

Fixando erros de console com Unity MCP

Um dos usos mais práticos do Unity MCP é permitir que seu agente leia e corrija erros da consola de forma autónoma. Como o agente pode ler o console e editar scripts na mesma sessão, ele pode passar de erro para correção sem que você copie nada:

1. O agente lê a consola via Unity_ReadConsole

2. Identifica o script relevante e lê seu conteúdo

3. Escreve uma correção e salva o arquivo de volta para o projeto

4. Leia a consola novamente para confirmar que o erro foi resolvido

Isso fecha o circuito de feedback que geralmente requer cópia e colagem manuais entre Unity e um assistente de IA – o agente o trata de ponta a ponta.

Mais sobre Unity AI

Se você está interessado em ler mais sobre o que está disponível na Unity AI Open Beta, convidamos você a ler outros artigos desta série:

• Introdução Unity AI Open Beta
• Como começar com o MCP
• Usando o Gerador de UI
• Criar props com o gerador de objetos 3D
• Criar materiais PBR a partir de um prompt de texto usando o Material Generator
• Criar skyboxes e reflexões de ambiente com o Cubemap Generator
• Usar o Sprite Generator para criar sprites 2D, ícones e spritesheets

Tente Unity AI hoje

A beta aberta do Unity AI está agora 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 seu fluxo de trabalho de desenvolvimento se parece com um agente de IA consciente do projeto incorporado.

Registre-se e aprenda mais sobre planos, preços e privacidade de dados em unity.com/features/en

A documentação completa está disponível nos documentos Unity AI vinculados do Editor ou em docs.unity3d.com.

Unity AI Assistant está atualmente em beta aberta. Como tal, os recursos, o comportamento e a disponibilidade descritos neste post estão em desenvolvimento ativo e podem ser alterados, limitados ou descontinuados sem aviso prévio.