Unreal 5.8 MCP mit Claude Code oder Cursor einrichten

Unreal MCP (Plugin-Name ModelContextProtocol) betreibt einen MCP-Server im Unreal Editor. Ein KI-Client wie Claude Code oder Cursor verbindet sich damit und ruft die Werkzeuge des Editors auf. Die Werkzeuge stammen aus Toolsets, die in Unreals Toolset Registry registriert sind, und Epic liefert viele mit: Actors, Blueprints, Widget Blueprints, Materialien, MetaSounds, PCG, Niagara, Sequencer, Slate-Inspektion, Profiling und Automatisierungstests.

Epic markiert das Plugin als Experimental. Rechne mit Änderungen zwischen Engine-Versionen.

1. Öffne dein Projekt in Unreal Engine 5.8. Gehe zu Edit > Plugins und suche nach Unreal MCP. Epics Seite sagt, es sei standardmäßig an; das Quellcode-Release 5.8.0 markiert es als aus, also setze den Haken selbst.
2. Suche nach All Toolsets und setze den Haken, um alle Standard-Toolsets zu laden. Wenn du weniger Werkzeuge willst, kannst du Toolset-Plugins auch einzeln aktivieren.
3. Starte den Editor neu.
4. Öffne Edit > Editor Preferences > Agentic Workflows > Model Context Protocol. Auto Start Server ist an, der Port ist 8000 und der URL-Pfad /mcp, der Server lauscht also auf http://127.0.0.1:8000/mcp.
5. Wähle im selben Bereich unter Client Selection deinen Client (Standard ist Claude Code) und klicke auf Generate Client Config.

Für Claude Code schreibt Generate Client Config eine Datei .mcp.json: in den Projektordner bei einer Launcher-Engine (installiert), in den Engine-Ordner bei einem Source-Build. Bei einem Source-Build musst du den Eintrag eventuell in die Konfiguration deines Projekts kopieren. Der Eintrag sieht so aus:

{
  "mcpServers": {
    "unreal-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

Starte Claude Code aus dem Ordner mit der Konfiguration, nachdem der Editor offen ist und der Server läuft. War Claude Code schon offen, verbinde es neu.

Epics Seite hat kein fertiges Snippet für Cursor. Führe im Editor den Konsolenbefehl ModelContextProtocol.GenerateClientConfig Cursor aus, kopiere den Eintrag aus dem Output Log und füge ihn dort ein, wo Cursors eigene MCP-Dokumentation es angibt. Der Server ist derselbe HTTP-Endpunkt wie oben.

• Nur Streamable HTTP und SSE. stdio und WebSocket werden nicht unterstützt.
• Der Server lauscht nur auf 127.0.0.1, prüft den Origin-Header gegen eine Erlaubnisliste und hat keine Authentifizierung. Epic rät davon ab, ihn über den eigenen Rechner hinaus freizugeben.
• Werkzeugaufrufe laufen nacheinander auf dem Game-Thread, ein langer Aufruf blockiert also den nächsten.

• ModelContextProtocol.StartServer [port] und ModelContextProtocol.StopServer
• ModelContextProtocol.RefreshTools, nachdem du Werkzeuge hinzugefügt oder geändert hast
• ModelContextProtocol.GenerateClientConfig mit einem Client-Namen wie ClaudeCode, Cursor, Codex oder Gemini
• -ModelContextProtocolPort=8001 auf der Kommandozeile für einen anderen Port
• Log LogModelContextProtocol Verbose für mehr Details im Output Log

Zwei Editoren gleichzeitig

Generate Client Config schreibt nur einen Eintrag namens unreal-mcp. Starte einen zweiten Editor auf einem anderen Port (zum Beispiel 8001) und trage ihn von Hand als zweiten Eintrag in die Client-Konfiguration ein.

Es kann:

• Deinem KI-Client die Editor-Werkzeuge aller aktivierten Toolsets geben.
• Die Werkzeugliste kurz halten: Mit Enable Tool Search sieht der Client eine kleine Zahl von Meta-Werkzeugen (etwa list_toolsets und call_tool) und schlägt den Rest bei Bedarf nach.
• Eigene C++-Funktionen als Werkzeuge anbieten, markiert mit dem Attribut AICallable.

Laut Epics Seite kann es nicht:

• MCP Resources aus den Engine-Toolsets oder MCP Prompts bereitstellen.
• In einem gecookten (gepackten) Spiel mehr als die AIRuntimeCallable-Werkzeuge anbieten.
• Ein neues C++-Werkzeug per Live Coding aufnehmen. Dafür muss der Editor neu starten.

Es prüft oder testet auch nicht die Änderungen, die dein Client macht. Das bleibt bei dir und deinem Client.

• Der Server startet nicht: Suche im Output Log nach einem belegten Port oder einem fehlenden Plugin. Probiere einen anderen Port.
• Der Client findet den Server nicht: Öffne zuerst den Editor, warte auf den Server, starte dann den Client aus dem Ordner mit der Konfiguration und verbinde neu.
• Werkzeuge fehlen: Aktiviere das Toolset-Plugin, führe ModelContextProtocol.RefreshTools aus und verbinde den Client neu.
• Lange Aufrufe brechen ab: Claude Code wartet etwa 120 Sekunden. Teile die Arbeit in kleinere Aufrufe auf.
• Unklar, welcher Editor antwortet: Verbinde den MCP Inspector (npx @modelcontextprotocol/inspector) mit derselben URL und lies die Instanz im Ergebnis von initialize.

Dola ist nicht Epics MCP-Plugin und braucht es nicht. Es ist eine Desktop-App plus ein eigenes Plugin für den Unreal Editor, verbunden über eine lokale Bridge. Die veröffentlichten Plugin-Builds sind für Unreal Engine 5.7 unter Windows und Linux; für ein 5.8-Projekt ist heute Epics MCP eine Option.

• Fertig gepackt: App installieren, Plugin zum Projekt hinzufügen, anmelden. Keine Client-Konfiguration zu schreiben.
• Prüfen, bevor du behältst: Jede Änderung wartet im Changes-Panel. Öffne den Diff in Unreal und nimm sie an, oder lehne sie ab, um das alte Asset wiederherzustellen.
• QA durch Spielen: Ein QA-Agent liest den Graphen und spielt die Änderung in Play in Editor, bevor er den Lauf als fertig meldet.

Ein echter Dola-Lauf vom 9. November 2026: ein Prompt, "make BP_Lamp blink", in PIE geprüft und dann zur Prüfung zurückgehalten.

Dolas App ist außerdem ein MCP-Client für Server, die du hinzufügst (Unreal Engine MCP und Dola). Der ganze Lauf Schritt für Schritt: Dola bei der Arbeit sehen.