Esta página foi traduzida automaticamente do inglês. Leia o original em inglês.

Motores · Unreal Engine

Unreal EngineDisponível

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

Unreal Engine 5.5+Testado em 5.7Projeto 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+.

1Instalar a CLI

Instale o unreal-mcp-cli globalmente pelo npm.

npm install -g unreal-mcp-cli
2Instalar o plugin

Instale o plugin Unreal-MCP no seu projeto.

unreal-mcp-cli install-plugin ./YourProject
3Autorizar

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

unreal-mcp-cli login ./YourProject
4Abrir 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.

1Instalar pelo Fab

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

2Ativar o plugin

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

3Abrir 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.

Precisa de trechos de configuração por cliente (Claude, Cursor, Copilot, Gemini e mais)? Veja a página de endpoint MCP →

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

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

unreal-mcp-cli setup-mcp claude-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
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 →

O plugin do Unreal Engine expõe 90 ferramentas MCP para seu cliente de IA.

Explore o catálogo de ferramentas do Unreal Engine →

Quer ainda mais ferramentas? Explore as extensões do Unreal Engine →