# Unity — AI Game Developer

Instale o plugin do AI Game Developer para Unity 6. Dois caminhos de instalação — unity-mcp-cli e o instalador .unitypackage — além de como conectar seu cliente de IA e rodar seu primeiro prompt.

Esta página foi traduzida automaticamente do inglês. [Leia o original em inglês](https://ai-game.dev/engines/unity).

Motores · Unity

Adicione o plugin AI Game Developer ao seu projeto Unity e controle o Editor com IA.

Unity 2022.3 LTS Unity 2023 Unity 6 (6000.x) Qualquer versão 2022.3+

01

## Instale o plugin

Duas formas de colocar o plugin no seu projeto — escolha a que combina com seu fluxo de trabalho.

Recomendado

### CLI

Instale com a ferramenta unity-mcp-cli. Nada para baixar manualmente — execute os comandos no seu terminal.

1 Instalar a CLI

Instale o unity-mcp-cli globalmente via npm.

`npm install -g unity-mcp-cli`

2 Instalar o Unity (opcional)

Instale o Editor Unity usando a CLI. Pule esta etapa se já estiver instalado.

`unity-mcp-cli install-unity 6000.3.9f1`

3 Criar projeto Unity (opcional)

Crie um novo projeto Unity ou use um existente.

`unity-mcp-cli create-project ./MyUnityProject`

4 Instalar plugin

Instale o pacote Unity MCP no seu projeto.

`unity-mcp-cli install-plugin ./MyUnityProject`

5 Abrir projeto Unity

Abra o projeto no Editor Unity.

`unity-mcp-cli open ./MyUnityProject`

### Instalador

Baixe o instalador .unitypackage e importe-o diretamente no seu projeto Unity — uma instalação única e direta.

[Baixar .unitypackage](https://github.com/IvanMurzak/Unity-MCP/releases/latest/download/AI-Game-Dev-Installer.unitypackage)

1 Instalar o Unity (opcional)

Baixe o [Unity Hub](https://unity.com/download) e instale qualquer Editor Unity 2022.3 LTS ou mais recente. Pule esta etapa se já estiver instalado.

2 Criar projeto Unity (opcional)

Crie um novo projeto Unity com o Unity Hub ou use um existente.

3 Baixar instalador

Use o botão **Baixar .unitypackage** acima para obter `AI-Game-Dev-Installer.unitypackage`.

4 Importar o pacote

No Unity, use **Assets → Import Package → Custom Package…** e selecione o arquivo baixado.

Prefere um registro de pacotes? Adicione-o pelo OpenUPM: `openupm add com.ivanmurzak.unity.mcp`. Veja o [guia de configuração do plugin Unity](https://ai-game.dev/docs/unity-plugin-setup) para todos os detalhes.

02

## Conectar

Conecte pelo endpoint de nuvem hospedado ou aponte para o seu próprio servidor.

### Nuvem

Padrão

Conecte pelo **ai-game.dev** usando o fluxo OAuth de código de dispositivo — sem tokens para copiar à mão. Na janela do AI Game Developer, escolha **Cloud**, clique em **Authorize** e aprove o código do dispositivo no navegador. Funciona através de firewalls e oferece análises de uso. É o padrão e o que recomendamos para a maioria dos usuários.

### Personalizado

Prefere rodar tudo localmente? Aponte o plugin para a sua própria instância `gamedev-mcp-server` em vez do endpoint hospedado. Seu cliente de IA passa a falar direto com a sua máquina. Os trechos de configuração de cada cliente estão na [página de endpoint MCP](https://ai-game.dev/mcp-endpoint-info).

Precisa de trechos de configuração por cliente (Claude, Cursor, Copilot, Gemini e mais)? [Veja a página de endpoint MCP →](https://ai-game.dev/mcp-endpoint-info)

03

## Configure seu agente de IA

Escolha o agente de IA que você usa e copie o comando `unity-mcp-cli` exato que o conecta ao servidor MCP do Unity.

Seu agente de IA

**Claude Code**

Rode isto no seu projeto para configurar **Claude Code** para Unity:

`unity-mcp-cli setup-mcp claude-code ./MyUnityProject`

**Claude Desktop**

Rode isto no seu projeto para configurar **Claude Desktop** para Unity:

`unity-mcp-cli setup-mcp claude-desktop ./MyUnityProject`

**Cursor**

Rode isto no seu projeto para configurar **Cursor** para Unity:

`unity-mcp-cli setup-mcp cursor ./MyUnityProject`

**VS Code (Copilot)**

Rode isto no seu projeto para configurar **VS Code (Copilot)** para Unity:

`unity-mcp-cli setup-mcp vscode-copilot ./MyUnityProject`

**Visual Studio (Copilot)**

Rode isto no seu projeto para configurar **Visual Studio (Copilot)** para Unity:

`unity-mcp-cli setup-mcp vs-copilot ./MyUnityProject`

**GitHub Copilot CLI**

Rode isto no seu projeto para configurar **GitHub Copilot CLI** para Unity:

`unity-mcp-cli setup-mcp github-copilot-cli ./MyUnityProject`

**Codex**

Rode isto no seu projeto para configurar **Codex** para Unity:

`unity-mcp-cli setup-mcp codex ./MyUnityProject`

**Gemini**

Rode isto no seu projeto para configurar **Gemini** para Unity:

`unity-mcp-cli setup-mcp gemini ./MyUnityProject`

**Cline**

Rode isto no seu projeto para configurar **Cline** para Unity:

`unity-mcp-cli setup-mcp cline ./MyUnityProject`

**Rider (Junie)**

Rode isto no seu projeto para configurar **Rider (Junie)** para Unity:

`unity-mcp-cli setup-mcp rider-junie ./MyUnityProject`

**Kilo Code**

Rode isto no seu projeto para configurar **Kilo Code** para Unity:

`unity-mcp-cli setup-mcp kilo-code ./MyUnityProject`

**Open Code**

Rode isto no seu projeto para configurar **Open Code** para Unity:

`unity-mcp-cli setup-mcp open-code ./MyUnityProject`

**Antigravity**

Rode isto no seu projeto para configurar **Antigravity** para Unity:

`unity-mcp-cli setup-mcp antigravity ./MyUnityProject`

**Unity AI**

Rode isto no seu projeto para configurar **Unity AI** para Unity:

`unity-mcp-cli setup-mcp unity-ai ./MyUnityProject`

**Reinicie seu agente depois de configurar.** O novo servidor MCP só é reconhecido em uma reinicialização completa do agente — feche-o por completo e abra de novo (não basta recarregar a janela).

04

## Primeira execução

Abra a janela, autorize e teste seu primeiro prompt.

1. Abra o projeto no Editor Unity e acesse **Window → AI Game Developer**.
2. No painel, escolha **Cloud** e clique em **Authorize** para concluir o fluxo de código do dispositivo.
3. Aguarde o indicador de status mostrar **Ready** (verde) e então conecte seu cliente de IA.
4. Experimente um prompt como o abaixo a partir do seu cliente de IA e veja a IA agir no Editor.

Prompt de exemplo

```text
Crie uma nova cena com uma luz direcional e um cubo rotativo e entre no modo Play.
```

Quer mais exemplos de prompts e os padrões para solicitações de IA eficazes? [Veja as boas práticas do Unity →](https://ai-game.dev/docs/best-practices/unity)

[O plugin do Unity expõe **72 recursos (21 ferramentas MCP + RQL)** para seu cliente de IA.](https://ai-game.dev/docs/tools/unity)

Explore o catálogo de ferramentas do Unity →

Quer ainda mais ferramentas? [Explore as extensões do Unity →](https://ai-game.dev/docs/extensions/unity)

---

Source (HTML): https://ai-game.dev/pt-br/engines/unity

Machine-translated (pt-BR) from the English page: https://ai-game.dev/engines/unity
