# Unreal Engine — AI Game Developer

Instale o plugin do AI Game Developer para Unreal Engine (5.5+). Dois caminhos de instalação — Fab e o unreal-mcp-cli — 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/unreal).

Motores · Unreal Engine

Instale o plugin Unreal-MCP no seu projeto C++ e controle o editor com IA.

Unreal Engine 5.5+ Testado em 5.7 Projeto C++

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 unreal-mcp-cli no npm. Funciona hoje com qualquer projeto C++ de UE 5.5+.

1 Instalar a CLI

Instale o unreal-mcp-cli globalmente pelo npm.

`npm install -g unreal-mcp-cli`

2 Instalar o plugin

Instale o plugin Unreal-MCP no seu projeto.

`unreal-mcp-cli install-plugin ./YourProject`

3 Autorizar

Faça login para que o plugin possa se conectar via ai-game.dev.

`unreal-mcp-cli login ./YourProject`

4 Abrir o projeto

Abra o projeto no Unreal Editor.

`unreal-mcp-cli open ./YourProject`

Em breve

### Fab / Epic Marketplace

Instale o Unreal-MCP pelo Fab via Epic Games Launcher — pré-compilado, sem build. Ainda não está no Fab; até lá, use a opção da CLI, que funciona hoje.

1 Instalar pelo Fab

Instale o Unreal-MCP pelo Fab via Epic Games Launcher.

2 Ativar o plugin

No editor: **Edit → Plugins**, encontre **Unreal-MCP** e ative o plugin.

3 Abrir o projeto

Reabra seu projeto — o plugin já vem pré-compilado, então não há nada para compilar.

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 `unreal-mcp-cli` exato que o conecta ao servidor MCP do Unreal Engine.

Seu agente de IA

**Claude Code**

Rode isto no seu projeto para configurar **Claude Code** para Unreal Engine:

`unreal-mcp-cli setup-mcp claude-code --path ./YourProject`

**Claude Desktop**

Rode isto no seu projeto para configurar **Claude Desktop** para Unreal Engine:

`unreal-mcp-cli setup-mcp claude-desktop --path ./YourProject`

**Cursor**

Rode isto no seu projeto para configurar **Cursor** para Unreal Engine:

`unreal-mcp-cli setup-mcp cursor --path ./YourProject`

**VS Code (Copilot)**

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

`unreal-mcp-cli setup-mcp vscode-copilot --path ./YourProject`

**Visual Studio (Copilot)**

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

`unreal-mcp-cli setup-mcp vs-copilot --path ./YourProject`

**Rider (Junie)**

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

`unreal-mcp-cli setup-mcp rider-junie --path ./YourProject`

**GitHub Copilot CLI**

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

`unreal-mcp-cli setup-mcp github-copilot-cli --path ./YourProject`

**Gemini**

Rode isto no seu projeto para configurar **Gemini** para Unreal Engine:

`unreal-mcp-cli setup-mcp gemini --path ./YourProject`

**Antigravity**

Rode isto no seu projeto para configurar **Antigravity** para Unreal Engine:

`unreal-mcp-cli setup-mcp antigravity --path ./YourProject`

**Cline**

Rode isto no seu projeto para configurar **Cline** para Unreal Engine:

`unreal-mcp-cli setup-mcp cline --path ./YourProject`

**Open Code**

Rode isto no seu projeto para configurar **Open Code** para Unreal Engine:

`unreal-mcp-cli setup-mcp open-code --path ./YourProject`

**Codex**

Rode isto no seu projeto para configurar **Codex** para Unreal Engine:

`unreal-mcp-cli setup-mcp codex --path ./YourProject`

**Kilo Code**

Rode isto no seu projeto para configurar **Kilo Code** para Unreal Engine:

`unreal-mcp-cli setup-mcp kilo-code --path ./YourProject`

**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 a janela do AI Game Developer no menu **Tools** do editor.
2. Escolha **Cloud** e clique em **Authorize** para concluir o fluxo de código de dispositivo.
3. Aguarde a conexão ficar verde e conecte seu cliente de IA.
4. Experimente um prompt como o abaixo e veja a IA agir no editor.

Prompt de exemplo

```text
Crie um novo Blueprint de Actor com um cubo de Static Mesh e coloque três deles no nível.
```

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

[O plugin do Unreal Engine expõe **90 ferramentas MCP** para seu cliente de IA.](https://ai-game.dev/docs/tools/unreal)

Explore o catálogo de ferramentas do Unreal Engine →

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

---

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

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