# Unreal MCP — AI Game Developer Wiki

O Unreal MCP conecta Claude, Cursor, Copilot e outros agentes de IA ao Unreal Editor. Veja como o plugin, a bridge, a CLI e o app se encaixam.

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

O Unreal MCP é o plugin de Unreal Engine do AI Game Developer. Ele permite que um agente de IA como Claude Code, Cursor, GitHub Copilot, Codex ou Gemini trabalhe dentro do Unreal Editor: consultar e alterar actors, componentes, assets e níveis, criar e compilar Blueprints, editar e compilar C++, executar Python do editor e capturar screenshots que ele pode analisar. Você descreve o que quer em linguagem natural e o agente chama as ferramentas do editor através do Model Context Protocol (MCP).

Este wiki explica como instalar o plugin, conectar seu cliente de IA e obter resultados úteis da IA no Unreal Editor. O plugin está em **beta**; a versão atual é 0.26.2.

## Como as peças se encaixam

Uma configuração do Unreal MCP tem quatro partes. Conhecê-las deixa a instalação e a solução de problemas muito mais fáceis.

- **O plugin Unreal MCP** (`UnrealMCP`). Um plugin de editor em C++ instalado na pasta `Plugins/` do seu projeto. Ele registra as ferramentas de IA e adiciona a janela **AI Game Developer** ao editor.
- **A bridge** (`unreal-mcp-bridge`). O editor do Unreal é C++, então o host MCP em .NET roda como um pequeno processo auxiliar ao lado do editor. O plugin o inicia automaticamente e se comunica com ele por uma conexão local protegida por token. Uma versão empacotada já inclui a bridge, então você não precisa instalar o .NET.
- **O servidor MCP**. Por padrão, a bridge se conecta ao servidor hospedado em [ai-game.dev](https://ai-game.dev) (modo **Cloud**). Você pode, em vez disso, rodar o servidor local compartilhado `gamedev-mcp-server` na sua própria máquina (modo **Custom**).
- **Seu cliente de IA**. Qualquer cliente MCP se conecta ao mesmo servidor e chega ao seu editor por meio dele.

Duas ferramentas ajudam você a configurar isso:

- **AI Game Dev**, o aplicativo desktop, instala o plugin em um projeto Unreal para você e pode abrir o editor. Não é necessário Node.js. Veja [o wiki do app](https://ai-game.dev/pt-br/docs/wiki/app).
- **`unreal-mcp-cli`**, uma ferramenta de linha de comando multiplataforma no npm. Ela instala e atualiza o plugin, faz seu login, grava configurações de clientes MCP, abre o editor e executa ferramentas a partir de um terminal ou de CI.

## O que o agente de IA pode fazer

O plugin traz 27 ferramentas em 7 famílias. A maior parte dos dados do editor passa pelo **RQL**, uma única linguagem de consulta para todo o editor, em vez de uma ferramenta por operação:

- **RQL** (`rql-query`, `rql-mutate`, `rql-schema`): encontrar e alterar actors, componentes, assets, níveis, DataTables, gameplay tags, Project Settings, grafos de Blueprint, Widget Blueprints e Level Sequences.
- **Blueprints**: criar, editar e compilar Blueprints, com uma lista estruturada de erros que o agente pode corrigir.
- **Código-fonte C++**: ler, gerar estrutura, editar e compilar o C++ do projeto (Live Coding ou Unreal Build Tool).
- **Python**: executar Python com a API completa do editor `unreal`.
- **Screenshots**: capturas do viewport, da visão do jogo, da câmera e de actors isolados.
- Auxiliares de **Console** e de **lista de ferramentas**.

Seis extensões opcionais adicionam suporte a Control Rig, Enhanced Input, Gameplay Ability System, Landscape e Water, Niagara e PCG. Você também pode registrar suas próprias ferramentas a partir de qualquer plugin do Unreal.

## Páginas do wiki

| Página | O que você vai encontrar |
| --- | --- |
| [Instalação](https://ai-game.dev/pt-br/docs/wiki/unreal/installation) | Requisitos e todos os caminhos de instalação que existem hoje: o app, a CLI e a instalação manual |
| [Primeiros passos](https://ai-game.dev/pt-br/docs/wiki/unreal/getting-started) | Primeira conexão, primeiros prompts e como verificar se tudo funciona |
| [Conectando clientes de IA](https://ai-game.dev/pt-br/docs/wiki/unreal/connecting-ai-clients) | Modo Cloud vs Custom, login por código de dispositivo, chaves de projeto e `setup-mcp` por agente |
| [Configuração](https://ai-game.dev/pt-br/docs/wiki/unreal/configuration) | A janela AI Game Developer, a janela MCP Tools, o arquivo de configuração e as variáveis `UNREAL_MCP_*` |
| [Ferramentas](https://ai-game.dev/pt-br/docs/wiki/unreal/tools) | Todas as ferramentas integradas e o que pedir |
| [Extensões](https://ai-game.dev/pt-br/docs/wiki/unreal/extensions) | As seis extensões opcionais e como instalá-las |
| [Ferramentas personalizadas](https://ai-game.dev/pt-br/docs/wiki/unreal/custom-tools) | Adicione suas próprias ferramentas, prompts e recursos em C++, incluindo ferramentas em tempo de execução (in-game) |
| [Referência da CLI](https://ai-game.dev/pt-br/docs/wiki/unreal/cli) | Todos os comandos e flags do `unreal-mcp-cli` |
| [Solução de problemas](https://ai-game.dev/pt-br/docs/wiki/unreal/troubleshooting) | Correções para problemas de conexão, bridge, build e ferramentas |
| [FAQ](https://ai-game.dev/pt-br/docs/wiki/unreal/faq) | Respostas curtas para perguntas comuns |

## Para onde ir agora

- Novo por aqui? Comece pela [Instalação](https://ai-game.dev/pt-br/docs/wiki/unreal/installation) e depois vá para os [Primeiros passos](https://ai-game.dev/pt-br/docs/wiki/unreal/getting-started).
- Quer a versão curta? A [página de instalação do Unreal Engine](https://ai-game.dev/pt-br/engines/unreal) e o [quickstart](https://ai-game.dev/pt-br/docs/quickstart) cobrem o essencial.
- Procurando detalhes das ferramentas? Navegue pelo [catálogo de ferramentas do Unreal](https://ai-game.dev/docs/tools/unreal) e pelas [boas práticas do Unreal](https://ai-game.dev/docs/best-practices/unreal).
- Também usa outra engine? Veja a [wiki do Unity](https://ai-game.dev/pt-br/docs/wiki/unity) e a [wiki do Godot](https://ai-game.dev/pt-br/docs/wiki/godot). Os três plugins compartilham o mesmo servidor, conta e clientes de IA.

- [**Instalação** Instale o plugin Unreal MCP para Unreal Engine 5.5+ com o app AI Game Dev ou o unreal-mcp-cli. Requisitos, atualizações, remoção e status no Fab.](https://ai-game.dev/pt-br/docs/wiki/unreal/installation)
- [**Primeiros passos** Conecte o Unreal MCP pela primeira vez, entre no ai-game.dev, configure seu cliente de IA e execute seus primeiros prompts de IA no Unreal Editor.](https://ai-game.dev/pt-br/docs/wiki/unreal/getting-started)
- [**Conectando clientes de IA** Conecte Claude Code, Cursor, Copilot, Codex, Gemini e outros clientes MCP ao Unreal MCP via endpoint na nuvem do ai-game.dev ou servidor local.](https://ai-game.dev/pt-br/docs/wiki/unreal/connecting-ai-clients)
- [**Configuração** Configure o Unreal MCP: janela AI Game Developer, visibilidade em MCP Tools, arquivo de config do projeto, .env e variáveis UNREAL\_MCP\_\*.](https://ai-game.dev/pt-br/docs/wiki/unreal/configuration)
- [**Ferramentas** As 27 ferramentas MCP integradas do Unreal - RQL, Blueprints, C++, Python, capturas de tela e console - e exemplos de prompts para IA no Unreal Editor.](https://ai-game.dev/pt-br/docs/wiki/unreal/tools)
- [**Extensões** Extensões opcionais do Unreal MCP para Control Rig, Enhanced Input, GAS, Landscape e Water, Niagara e PCG. O que cada uma adiciona e como instalar.](https://ai-game.dev/pt-br/docs/wiki/unreal/extensions)
- [**Ferramentas personalizadas** Adicione suas ferramentas de IA, módulos RQL, prompts e recursos ao Unreal MCP de qualquer plugin C++ e exponha ferramentas de gameplay no jogo.](https://ai-game.dev/pt-br/docs/wiki/unreal/custom-tools)
- [**Referência da CLI** Referência completa do unreal-mcp-cli: instale o plugin Unreal MCP, faça login, configure agentes de IA, abra o editor e execute Python.](https://ai-game.dev/pt-br/docs/wiki/unreal/cli)
- [**Solução de problemas** Corrija problemas comuns do Unreal MCP: plugin não carrega, bridge ausente, conexão travada, agente sem ferramentas do Unreal e erros.](https://ai-game.dev/pt-br/docs/wiki/unreal/troubleshooting)
- [**FAQ** Respostas às perguntas mais comuns sobre o Unreal MCP: versões da engine, clientes de IA, projetos só com Blueprint, Fab, uso offline e custo.](https://ai-game.dev/pt-br/docs/wiki/unreal/faq)

---

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

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