Unreal MCP

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 (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.
• 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#

Para onde ir agora#

• Novo por aqui? Comece pela Instalação e depois vá para os Primeiros passos.
• Quer a versão curta? A página de instalação do Unreal Engine e o quickstart cobrem o essencial.
• Procurando detalhes das ferramentas? Navegue pelo catálogo de ferramentas do Unreal e pelas boas práticas do Unreal.
• Também usa outra engine? Veja a wiki do Unity e a wiki do Godot. Os três plugins compartilham o mesmo servidor, conta e clientes de IA.