Configuração do plugin do Unity, passo a passo

Tudo para sair de um projeto Unity vazio e chegar a um agente de IA trabalhando no Editor: instale o plugin, faça login, conecte seu cliente de IA e adicione as extensões de que precisa. A página de instalação do Unity tem a versão resumida.

Antes de começar

Unity 2022.3 ou mais recente, uma conta ai-game.dev e um cliente de IA.

Unity 2022.3 ou mais recente — o Unity 6 é compatível.
Uma conta ai-game.dev para a conexão Cloud padrão — crie uma se ainda não tiver.
Um cliente de IA — o app AI Game Dev, Claude Code, Cursor, Copilot, Gemini, Codex ou qualquer um dos 14 clientes MCP compatíveis.
Acesso à internet na primeira abertura — o plugin baixa seus pacotes .NET do NuGet.

Instale o plugin

Com o app, a CLI, o OpenUPM ou o pacote instalador — escolha um.

Quatro formas de adicionar o plugin, da mais fácil:

Abra seu projeto Unity no app AI Game Dev e clique em Install Package. O app instala o plugin mais recente do OpenUPM, faz o login dele e configura seu agente.

Instale a CLI pelo npm e adicione o plugin ao seu projeto (ele edita o Packages/manifest.json para você):

npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProject

Com a CLI do OpenUPM, execute isto na pasta do projeto:

openupm add com.ivanmurzak.unity.mcp

Sem a CLI do OpenUPM? Adicione o registro com escopo ao Packages/manifest.json e depois adicione o pacote em Window → Package Manager:

{
  "scopedRegistries": [
    {
      "name": "package.openupm.com",
      "url": "https://package.openupm.com",
      "scopes": ["com.ivanmurzak", "extensions.unity"]
    }
  ]
}

Abra a janela e faça login

Abra a janela do AI Game Developer e faça login uma vez com sua conta.

No Unity, escolha Window → AI Game Developer — MCP (Ctrl+Alt+A, ou Cmd+Option+A no macOS).
Mantenha a opção Connection em Cloud e clique em Authorize.
Seu navegador abre a página de login do ai-game.dev com um código curto. Confira se o código confere e aprove.
O status do Unity muda para Connected.

O login fica armazenado para o computador inteiro: se você já entrou com o app ou com unity-mcp-cli login, o Editor usa essa sessão e você pode pular esta etapa.

Conecte seu cliente de IA

Um comando, ou um clique na janela, grava a configuração do seu cliente.

Na janela, clique em Configure ao lado do seu agente de IA — ou execute setup-mcp no terminal. Os dois gravam a URL fixada do projeto e uma chave do projeto na configuração do cliente, então ele se conecta na hora:

# Claude Code — use your agent's id (cursor, codex, gemini, vscode-copilot, …)
unity-mcp-cli setup-mcp claude-code ./MyUnityProject

Reinicie o cliente de IA depois de alterar a configuração. Para outros clientes e configuração manual, veja Como conectar clientes de IA e a página do endpoint MCP.

Adicione extensões (opcional)

Animação, Cinemachine, Terreno, Timeline e mais — instale só o que precisar.

Cada extensão é um pacote Unity próprio. Assim que é instalada, ela ensina ao agente uma área do Unity por meio do RQL. Algumas populares:

AI Animation3 recursos

openupm add com.ivanmurzak.unity.mcp.animation

AI Cinemachine4 recursos

openupm add com.ivanmurzak.unity.mcp.cinemachine

AI Terrain4 recursos

openupm add com.ivanmurzak.unity.mcp.terrain

AI Timeline5 recursos

openupm add com.ivanmurzak.unity.mcp.timeline

Todas as 10 extensões do Unity →

Solução de problemas

Soluções para os problemas mais comuns. Saiba mais no guia de solução de problemas do Unity.

Próximos passos

Wiki do Unity →Configuração, ferramentas e RQL, ferramentas personalizadas, referência da CLI e mais.Ferramentas do Unity →Tudo o que o agente pode fazer no Unity, com exemplos.Boas práticas →Como pedir ao agente aquilo que ele faz bem.