TutorialStefan VaskevichStefan Vaskevich

MCP nativo da Unreal Engine 5.8 + Claude: a configuração que realmente funciona

A UE 5.8 vem com um servidor MCP nativo (PCG, Niagara, Blueprints). A demo é encenada - aqui está a configuração real: MCP nativo + VibeUE + Claude, de ponta a ponta.

Ferramentas usadas neste artigo

O Unreal Engine 5.8 acabou de sair, e a novidade é enorme: um servidor MCP nativo integrado diretamente ao editor, com ferramentas para PCG, Niagara e Blueprints. Você conecta um agente - Claude, Codex, Cursor - e a demo mostra ele construindo uma cidade inteira, gerando multidões e fazendo a direção de arte da iluminação a partir de alguns prompts.

Aqui está a parte sincera que ninguém conta para você: o MCP nativo sozinho não vai fazer isso. O reel que a Epic mostrou foi cuidadosamente preparado - assets modulares e grafos de PCG criados manualmente já estavam no projeto. Instale o Claude, ative o MCP e tente usar tudo do zero, e você quase certamente vai obter lixo. Mas ainda é uma ferramenta incrível. Você só precisa da configuração certa em volta dela - e, com tudo combinado, ela realmente pode fazer mágica. Aqui está exatamente qual é essa configuração.

A configuração em uma linha
Unreal Engine 5.8 (MCP nativo) + o plugin VibeUE (atualizado para o 5.8) + Claude Code aberto na pasta do seu projeto. O MCP nativo faz o trabalho de forma limpa, com recursos nativos; o VibeUE cobre tudo o que ele não consegue fazer. Ambos se comunicam com o mesmo agente por MCP.
Uma cidade ribeirinha japonesa finalizada no Unreal Engine 5.8 na golden hour - pagode, barcos na água, cerejeiras em flor - criada com PCG por meio do MCP nativo e do VibeUE
O resultado final: uma cidade ribeirinha japonesa controlável, construída quase inteiramente a partir de prompts no Unreal Engine 5.8 - MCP nativo para o trabalho nativo, VibeUE para tudo o que ele não consegue alcançar.

1. No que o MCP nativo do UE 5.8 é genuinamente ótimo

Pela primeira vez, o servidor MCP vem dentro do Unreal. Sem ponte de terceiros para o básico - o próprio editor expõe uma API voltada para agentes. E ele disponibiliza as ferramentas que importam de uma forma muito mais conveniente: PCG (geração procedural de conteúdo), Niagara, Blueprints e muito mais. Posicionar objetos, criar materiais e simplesmente tirar uma captura de tela anotada para que o agente possa ver o que acabou de fazer - nada disso é mais um problema.

É exatamente por isso que a Epic demonstrou uma cidade gerada por PCG. O PCG é a parte poderosa, e dar ao agente acesso à sua API completa e às suas skills é o verdadeiro diferencial. As simulações de multidão, a cidade instantânea, os passes de iluminação que você viu - tudo isso funciona com PCG e chamadas às ferramentas nativas.

Uma enorme simulação de multidão povoando uma cena no Unreal Engine, da demo do MCP nativo do UE 5.8
Demo do MCP nativo: povoar um mundo com multidões. Poderoso - e impulsionado por PCG.
O Claude fazendo a direção de arte da iluminação de uma vila japonesa no Unreal Engine - golden hour quente com sol baixo
Fazendo a direção de arte de todo o passe de iluminação: ângulo do sol, exposição, preenchimento de sombras - tudo a partir de prompts pelo MCP nativo.

2. Onde ele deixa a desejar (e por que a demo mente um pouco)

Rode o MCP nativo sozinho e você vai encontrar limitações rapidinho. Na prática, ele não consegue executar qualquer código Python, tem limitações para fazer ajustes detalhados em materiais e objetos e - o problema que pega todo mundo que trabalha com 3D gerado por IA - ele só consegue importar FBX ou OBJ. Entregue a ele um .glb gerado por IA e ele simplesmente pede para você mesmo importar o asset.

A demo da Epic foi encenada
O reel de “poucos prompts, uma cidade inteira” foi preparado com antecedência: prédios modulares, uma biblioteca de assets e grafos de PCG criados manualmente já estavam no projeto. O agente tinha acesso ao PCG - mas ele não inventou esses grafos na hora. Outros YouTubers dizendo que é “impossível de reproduzir” estão meio certos: você não consegue reproduzir a cena deles sem preparação prévia, mas com certeza pode construir a sua com a configuração abaixo.

E mais uma limitação, sendo sincero: não espere que ele olhe para uma imagem de conceito e a recrie. A visão espacial é o ponto fraco. O Opus 4.8 (usado em toda esta configuração) é razoável; o Fable 5 tem uma visão espacial visivelmente melhor, mas não está tão à frente; e a visão do ChatGPT/Codex é ainda melhor para tarefas como “leia esta captura de tela e corrija o posicionamento”. Se você trabalha no Codex, vai conseguir correções mais precisas a partir de capturas de tela do que com o Claude.

3. O VibeUE preenche as lacunas - perfeitamente

O VibeUE é o plugin da configuração anterior com Claude Code no Unreal - e, um dia antes deste vídeo, ganhou uma versão 5.8 que funciona em conjunto com o MCP nativo, não contra ele. Essa combinação é a resposta. Veja o que ele acrescenta:

Execução arbitrária de Python
O agente não fica mais preso aos métodos que a API nativa venha a expor. Se faltar alguma ferramenta, ele cria um script para contornar isso no Python do editor.
Importação de GLB (não apenas FBX/OBJ)
Aponte o Claude para uma pasta de arquivos .glb gerados por IA e ele os importa direto para o projeto - exatamente o que o MCP nativo se recusa a fazer.
Ajuste fino profundo + suas próprias skills
Terrenos, controle mais profundo de materiais e uma API para quase todos os grafos de Blueprint - incluindo widgets - além de uma biblioteca de skills que o MCP nativo não tem.
Uma regra: métodos nativos primeiro
O VibeUE é mais poderoso, mas esse poder pode fazer o editor fechar inesperadamente. Portanto, a ordem de trabalho é simples: deixe o agente usar as ferramentas nativas do MCP primeiro e recorrer ao VibeUE apenas para o que o MCP nativo não consegue fazer (Python, importação de GLB, trabalho avançado com grafos e materiais). Os arquivos de configuração disponíveis para download abaixo já definem exatamente essa prioridade.
Um grafo de PCG Road Spline aberto no Unreal Engine, com nós para civic radius, river clearance e tree scatter - editado por meio do VibeUE
O VibeUE acessa profundamente os grafos e esquemas de nós do PCG - aproveitando as assinaturas reais dos nós em vez de tentar adivinhar. Esta é a camada que o MCP nativo não consegue alcançar.

4. Instale e conecte toda a stack

Pré-requisito: Unreal Engine 5.8 instalado e o Claude Code aberto na pasta do seu projeto Unreal (aplicativo para desktop ou terminal, você escolhe). Execute-o no modo bypass-permissions para que ele possa compilar e conectar as coisas sem parar a cada etapa.

1

Instale o VibeUE primeiro (cole o link, deixe o Claude fazer isso)

Na página do VibeUE 5.8, copie o link do Git e diga ao Claude para clonar e instalar o plugin. Ele baixa o repositório na pasta Plugins/ do seu projeto e compila o módulo em C++. Feche o Unreal Editor durante a compilação (a instalação exige reinicializações de qualquer forma) e deixe o processo terminar.

2

Certifique-se de que o Git esteja configurado

Se o Claude pedir para inicializar o Git, diga que sim - o Git é essencial. Um projeto do Unreal é uma pilha enorme de código e assets; o controle de versão permite reverter as alterações sem deixar bagunça assim que um experimento der errado. Faça um commit a cada marco funcional.

3

Ative ambos os plugins e depois reinicie o Unreal

Abra Plugins e ative os dois plugins de MCP - o nativo e o VibeUE. Eles não vêm ativados por padrão. Confirme se o VibeUE aparece como instalado e ativo e, em seguida, reinicie o editor para que eles sejam carregados.

4

Ative o Auto Start Server

Vá em Editor Preferences → Model Context Protocol e ative o Auto Start Server. Agora, toda vez que o Unreal for iniciado, o servidor MCP começará a escutar em http://127.0.0.1:8000/mcp e o seu agente poderá se conectar. (Você também pode iniciá-lo sob demanda com o comando de console ModelContextProtocol.StartServer, mas a inicialização automática dá bem menos trabalho.)

5

Gere a configuração do cliente (.mcp.json)

No console do editor, grave a configuração do agente na raiz do seu projeto. Para o Claude Code, o comando é ModelContextProtocol.GenerateClientConfig ClaudeCode. A documentação oficial também mostra como fazer isso para Cursor, VS Code, Gemini, Codex ou para todos de uma vez com All, se você usar vários agentes. Depois, reinicie tanto o Unreal quanto o Claude, abra uma nova sessão e peça para ele verificar a conexão MCP.

Claude Code clonando e compilando o plugin C++ VibeUE na pasta Plugins do projeto Unreal para o UE 5.8
Passo 1: o Claude clona o VibeUE em Plugins/, confirma que ele é voltado para a EngineVersion 5.8.0 e compila o módulo em C++.
Editor Preferences no Unreal Engine mostrando o painel Model Context Protocol com Auto Start Server ativado na porta 8000
Passo 4: Editor Preferences → Model Context Protocol → Auto Start Server. O servidor se vincula a 127.0.0.1:8000/mcp.
A documentação oficial do Unreal MCP mostrando ModelContextProtocol.GenerateClientConfig para ClaudeCode, Cursor, VSCode, Gemini, Codex ou All
Passo 5: um comando de console grava o .mcp.json para o seu agente. ClaudeCode, Cursor, VSCode, Gemini, Codex - ou All.
# In the Unreal editor console (open with the backtick key):
ModelContextProtocol.GenerateClientConfig ClaudeCode   # writes .mcp.json to project root
# or wire every supported agent at once:
ModelContextProtocol.GenerateClientConfig All

# Start the MCP server on demand (if Auto Start is off):
ModelContextProtocol.StartServer        # default port 8000
ModelContextProtocol.StartServer 8000

# In Claude Code, the simplest check after restarting both:
#   "check the MCP connection"
Baixe meus arquivos CLAUDE.md e AGENTS.md para economizar tempo

Coloque um desses arquivos na raiz do seu projeto do Unreal e o agente seguirá um roteiro comprovado para essa stack específica: priorizar o MCP nativo, usar a biblioteca de habilidades do VibeUE, seguir a ordem de instalação e evitar as pegadinhas do UE 5.8 que descobri a duras penas - para que você não precise descobri-las por conta própria. Use CLAUDE.md para o Claude Code ou AGENTS.md para o Codex / Cursor / outros agentes.

5. O teste real: construir uma cidade ribeirinha japonesa com PCG

Em vez de escolher a dedo uma demonstração inútil, o objetivo aqui é algo que você realmente possa controlar. O plano: gerar assets modulares suficientes para uma cidade inteira, colocá-los no projeto e deixar o agente montar uma cidade procedural que você possa continuar editando. Primeiro, os assets - cerca de 60 deles (estradas, pontes, plantas, casas, objetos de rio), todos gerados no Tripo a partir de imagens conceituais e mantidos otimizados (cerca de 25k polígonos cada).

Referências de concept art para uma cidade ribeirinha japonesa - vistas aéreas de cima para baixo usadas para planejar os assets modulares
Comece com referências conceituais para a cidade e depois gere as peças modulares. O agente apenas as monta - ele não inventa a arte.
Por que usar o modo HD do Tripo para geração de assets em lote
Stefan gerou o conjunto no Tripo usando o HD model para poder definir um limite de polígonos (você pode usar até 5k) e fazer o bake da textura em uma única passada - o formato fica mais preciso do que com o smart-mesh para um conjunto variado como este. Uma ressalva: uma peça grande como um pagode não vai caber no limite de 20k. O Tripo atualmente lidera o ranking do top3d.ai em textura, geometria e low poly - por isso é a ferramenta principal usada aqui.
Tripo gerando um asset de cais japonês de madeira no modo HD, exportado como um GLB para importação no Unreal
Cada peça modular sai do Tripo como um GLB - e é exatamente por isso que você precisa do VibeUE: o MCP nativo não importa GLB.

Agora a construção, um prompt de cada vez, fazendo commit após cada um:

1

Landscape em branco, depois um material de grama verde

Comece de forma simples - crie um landscape em branco e aplique um material de grama. Sem problemas; posicionar objetos e materiais simples é a zona de conforto do MCP nativo.

2

Um rio que você pode mover - em uma spline

Peça para ele carregar o plugin Water do Unreal e traçar um rio como uma curva controlável. No começo, ele fica um pouco para fora do landscape, mas como é uma spline, basta arrastá-la para o lugar certo. Esse controle é justamente o objetivo do PCG.

3

Uma estrada de paralelepípedos - textura gerada na hora

Adicione uma estrada, também em uma spline. Não tem textura de paralelepípedos à mão? O agente se conecta ao fal.ai (Patina), gera a textura e cria o material a partir dela - você só precisa fornecer uma chave de API. A primeira tentativa veio esticada (aquela visão espacial fraca de novo); um prompt de ajuste corrigiu as UVs.

Claude capturando a viewport da estrada de PCG e diagnosticando uma textura de paralelepípedos com UV esticada
O ciclo de autorrevisão: o agente tira uma captura de tela do próprio trabalho, identifica a textura esticada e a corrige. Capturas de tela anotadas são um ponto forte do MCP nativo.
4

Casas ao longo das estradas - a partir de GLB

Prompt: coloque as construções perto das estradas. As casas vieram em formato GLB - importadas sem complicação graças ao VibeUE (o MCP nativo sozinho teria pedido para você colocá-las manualmente). Como tudo é spline + PCG, deslocar levemente a estrada reorganiza as casas automaticamente.

5

Mantenha as casas fora da água, depois adicione pontes procedurais

Uma captura de tela mais "não coloque casas por onde o rio passa" e ele limpa as margens em um único prompt. Para as travessias, gere um tile de ponte curto para que o PCG possa repeti-lo - agora, todo ponto onde uma estrada cruza o rio ganha uma ponte, e estender a spline gera mais.

6

Cruzamentos, para que a cidade possa realmente se ramificar

Adicione uma segunda spline e a lógica de cruzamentos para que as ruas possam se cruzar sem que casas apareçam no meio de um cruzamento. Essa etapa precisou de uma orientação explícita para dar certo - mas, depois que funciona, a cidade pode crescer e ficar tão complexa quanto você quiser.

Uma spline de estrada de PCG em um landscape verde com casas japonesas modulares distribuídas ao longo dela, ao lado de um rio
Guiado por splines e totalmente procedural: mova a estrada ou o rio e as posições das casas, pontes e props são recalculadas para acompanhar a mudança.

6. Grama, árvores e iluminação de golden hour

Com o layout funcionando, os passes finais também são todos em PCG: distribua a grama, depois espalhe árvores - e como tudo é procedural, ajustar uma estrada mais tarde redistribui a folhagem junto com ela. O agente também pode recorrer a ferramentas externas quando precisa: ele acessou o fal.ai para aquele material de estrada e, nos testes, até abriu o Blender para modelar folhas de grama, exportá-las como GLB e importá-las de volta para a Unreal.

Depois, a parte que a demo nativa nunca mencionou: iluminação. Peça um passe de golden hour e ele configura o sol, as sombras e o preenchimento do céu. A primeira tentativa ficou um pouco escura; depois de um prompt pedindo para clarear a cena, os reflexos e o sol baixo e quente deram unidade a toda a cena.

Uma vista de cima da cidade japonesa procedural finalizada - rede de estradas, casas, cerejeiras, rio e um pagode central
A cidade inteira vista de cima - estradas, casas, vegetação e rio, tudo controlado por splines de PCG que você pode continuar editando.

7. O veredito sincero

Quando brilha e quando não
  • Ele constrói mundos procedurais e controláveis com ótimos resultados - splines para o rio e as ruas, PCG para casas, pontes e vegetação, tudo se reorganizando quando você edita.
  • Ele não vai replicar uma imagem conceitual. A visão espacial é o limite - você comanda a composição, ele executa a construção.
  • Os grafos de Blueprint/PCG são um espaguete. A lógica funciona; a disposição dos nós é uma bagunça que você talvez precise organizar manualmente. (Segundo o State of Unreal, a UE6 pode acabar deixando Blueprints de lado em favor de código - algo com que os agentes lidam bem.)
  • Planeje o tempo e a ferramenta de visão. A construção completa leva ~2 horas, cerca de 5-10 minutos por prompt. A visão do Codex/ChatGPT supera o Claude em correções baseadas em capturas de tela, se esse for o seu gargalo.
Um personagem correndo pelas ruas da cidade japonesa finalizada na Unreal Engine, passando por casas sobre palafitas e cerejeiras
Não é um render escolhido a dedo - é uma cidade real e explorável a pé que você construiu e pode continuar moldando. Esse é o máximo que esse setup pode oferecer no momento.

Essa é a fantasia de “poucos prompts, uma cidade inteira” da keynote? Não - e qualquer pessoa que disser que é está tentando vender algo. Mas é a versão real e prática: com o MCP nativo + VibeUE + Claude, você tem um mundo procedural que realmente controla, e isso é muito mais útil do que uma demo ensaiada que você nunca consegue reproduzir.

O que você realmente consegue

Uma ponte MCP nativa + VibeUE
O MCP integrado da UE 5.8 para tarefas nativas, VibeUE para Python, importação de GLB e controle profundo de grafos/materiais - ambos em um único agente.
Um mundo PCG controlável
Rios, estradas, casas, pontes e vegetação em splines - edite uma spline e o restante é recalculado.
Um agente com autorrevisão
Capturas de tela anotadas para que ele veja o próprio trabalho, diagnostique uma textura esticada e a corrija.
Arquivos de configuração prontos para uso
CLAUDE.md e AGENTS.md que definem a ordem de instalação, a prioridade aos recursos nativos e as pegadinhas da UE 5.8.

Esse é o pipeline completo: instale a UE 5.8 com o VibeUE, conecte o Claude (ou Codex) via MCP, gere seus assets modulares e deixe o agente montar um mundo procedural enquanto você orienta o processo. Novas ferramentas de IA 3D que alimentam esse tipo de fluxo de trabalho chegam a todo momento - e, quando chegam, vão direto para a Arena para que você possa compará-las antes de escolher uma. Para ver o capítulo anterior dessa história, confira Claude Code + Unreal Engine 5 e o fluxo de trabalho no-code Aura.

Assista à construção completa

Todo o setup e o teste de estresse, do início ao fim, no YouTube.

Quer comparar essas ferramentas você mesmo?

MCP nativo da Unreal Engine 5.8 + Claude: a configuração que realmente funciona | Top 3D AI