# Unreal MCP — AI Game Developer Wiki

Unreal MCP verbindet Claude, Cursor, Copilot und andere KI-Agenten mit dem Unreal Editor. Erfahre, wie Plugin, Bridge, CLI und App zusammenspielen.

Diese Seite wurde maschinell aus dem Englischen übersetzt. [Englisches Original lesen](https://ai-game.dev/docs/wiki/unreal).

Unreal MCP ist das Unreal-Engine-Plugin von AI Game Developer. Es ermöglicht einem KI-Agenten wie Claude Code, Cursor, GitHub Copilot, Codex oder Gemini, direkt im Unreal Editor zu arbeiten: Actors, Komponenten, Assets und Level abfragen und ändern, Blueprints erstellen und kompilieren, C++ bearbeiten und kompilieren, Editor-Python ausführen und Screenshots aufnehmen, die er sich ansehen kann. Du beschreibst in natürlicher Sprache, was du möchtest, und der Agent ruft die Werkzeuge des Editors über das Model Context Protocol (MCP) auf.

Dieses Wiki erklärt, wie du das Plugin installierst, deinen KI-Client verbindest und mit KI im Unreal Editor brauchbare Ergebnisse erzielst. Das Plugin befindet sich in der **Beta**; die aktuelle Version ist 0.26.2.

## Wie die Teile zusammenpassen

Ein Unreal MCP-Setup besteht aus vier Teilen. Wenn du sie kennst, werden Einrichtung und Fehlersuche deutlich einfacher.

- **Das Unreal MCP-Plugin** (`UnrealMCP`). Ein C++-Editor-Plugin, das im Ordner `Plugins/` deines Projekts installiert wird. Es registriert die KI-Werkzeuge und fügt das Fenster **AI Game Developer** zum Editor hinzu.
- **Die Bridge** (`unreal-mcp-bridge`). Der Unreal Editor ist in C++ geschrieben, daher läuft der .NET-MCP-Host als kleiner Hilfsprozess neben dem Editor. Das Plugin startet ihn automatisch und kommuniziert über eine lokale, token-geschützte Verbindung mit ihm. In einem gepackten Release ist die Bridge enthalten, du musst also kein .NET installieren.
- **Der MCP-Server**. Standardmäßig verbindet sich die Bridge mit dem gehosteten Server unter [ai-game.dev](https://ai-game.dev) (**Cloud**-Modus). Alternativ kannst du den gemeinsamen lokalen Server `gamedev-mcp-server` auf deinem eigenen Rechner ausführen (**Custom**-Modus).
- **Dein KI-Client**. Jeder MCP-Client verbindet sich mit demselben Server und erreicht darüber deinen Editor.

Zwei Werkzeuge helfen dir bei der Einrichtung:

- **AI Game Dev**, die Desktop-App, installiert das Plugin für dich in ein Unreal-Projekt und kann den Editor öffnen. Node.js ist nicht erforderlich. Siehe [das App-Wiki](https://ai-game.dev/de/docs/wiki/app).
- **`unreal-mcp-cli`**, ein plattformübergreifendes Kommandozeilenwerkzeug auf npm. Es installiert und aktualisiert das Plugin, meldet dich an, schreibt MCP-Client-Konfigurationen, öffnet den Editor und führt Werkzeuge von einem Terminal oder aus CI aus.

## Was der KI-Agent tun kann

Das Plugin enthält 27 Werkzeuge in 7 Familien. Die meisten Editor-Daten laufen über **RQL**, eine Abfragesprache für den gesamten Editor, statt über ein eigenes Werkzeug pro Operation:

- **RQL** (`rql-query`, `rql-mutate`, `rql-schema`): Actors, Komponenten, Assets, Level, DataTables, Gameplay-Tags, Project Settings, Blueprint-Graphen, Widget Blueprints und Level Sequences finden und ändern.
- **Blueprints**: Blueprints erstellen, bearbeiten und kompilieren, mit einer strukturierten Fehlerliste, die der Agent beheben kann.
- **C++-Quellcode**: Projekt-C++ lesen, anlegen, bearbeiten und kompilieren (Live Coding oder Unreal Build Tool).
- **Python**: Python mit der vollständigen `unreal`-Editor-API ausführen.
- **Screenshots**: Aufnahmen aus Viewport, Spielansicht, Kamera und von isolierten Actors.
- **Console**- und **Werkzeuglisten**-Helfer.

Sechs optionale Erweiterungen ergänzen Unterstützung für Control Rig, Enhanced Input, Gameplay Ability System, Landscape und Water, Niagara und PCG. Du kannst auch eigene Werkzeuge aus jedem beliebigen Unreal-Plugin registrieren.

## Wiki-Seiten

| Seite | Was du dort findest |
| --- | --- |
| [Installation](https://ai-game.dev/de/docs/wiki/unreal/installation) | Voraussetzungen und alle heute verfügbaren Installationswege: die App, die CLI und die manuelle Installation |
| [Erste Schritte](https://ai-game.dev/de/docs/wiki/unreal/getting-started) | Erste Verbindung, erste Prompts und die Prüfung, ob alles funktioniert |
| [KI-Clients verbinden](https://ai-game.dev/de/docs/wiki/unreal/connecting-ai-clients) | Cloud- vs. Custom-Modus, Device-Code-Anmeldung, Projektschlüssel und `setup-mcp` pro Agent |
| [Konfiguration](https://ai-game.dev/de/docs/wiki/unreal/configuration) | Das Fenster AI Game Developer, das Fenster MCP Tools, die Konfigurationsdatei und die Variablen `UNREAL_MCP_*` |
| [Werkzeuge](https://ai-game.dev/de/docs/wiki/unreal/tools) | Jedes integrierte Werkzeug und wonach du fragen kannst |
| [Erweiterungen](https://ai-game.dev/de/docs/wiki/unreal/extensions) | Die sechs optionalen Erweiterungen und wie du sie installierst |
| [Eigene Werkzeuge](https://ai-game.dev/de/docs/wiki/unreal/custom-tools) | Füge eigene Werkzeuge, Prompts und Ressourcen aus C++ hinzu, auch Werkzeuge zur Laufzeit im Spiel |
| [CLI-Referenz](https://ai-game.dev/de/docs/wiki/unreal/cli) | Jeder Befehl und jede Option von `unreal-mcp-cli` |
| [Fehlerbehebung](https://ai-game.dev/de/docs/wiki/unreal/troubleshooting) | Lösungen für Probleme mit Verbindung, Bridge, Build und Werkzeugen |
| [FAQ](https://ai-game.dev/de/docs/wiki/unreal/faq) | Kurze Antworten auf häufige Fragen |

## Wie es weitergeht

- Neu hier? Beginne mit [Installation](https://ai-game.dev/de/docs/wiki/unreal/installation) und dann mit [Erste Schritte](https://ai-game.dev/de/docs/wiki/unreal/getting-started).
- Du möchtest die Kurzfassung? Die [Unreal Engine-Installationsseite](https://ai-game.dev/de/engines/unreal) und der [Schnellstart](https://ai-game.dev/de/docs/quickstart) decken das Wesentliche ab.
- Sie suchen Details zu den Tools? Durchsuchen Sie den [Unreal-Toolkatalog](https://ai-game.dev/docs/tools/unreal) und die [Unreal-Best-Practices](https://ai-game.dev/docs/best-practices/unreal).
- Verwenden Sie auch eine andere Engine? Siehe das [Unity-Wiki](https://ai-game.dev/de/docs/wiki/unity) und das [Godot-Wiki](https://ai-game.dev/de/docs/wiki/godot). Alle drei Plugins nutzen denselben Server, dasselbe Konto und dieselben AI-Clients.

- [**Installation** Unreal MCP Plugin für Unreal Engine 5.5+ installieren – mit der AI Game Dev App oder unreal-mcp-cli. Voraussetzungen, Updates, Deinstallation, Fab.](https://ai-game.dev/de/docs/wiki/unreal/installation)
- [**Erste Schritte** Verbinde Unreal MCP zum ersten Mal, melde dich bei ai-game.dev an, richte deinen KI-Client ein und starte deine ersten KI-Prompts im Unreal Editor.](https://ai-game.dev/de/docs/wiki/unreal/getting-started)
- [**KI-Clients verbinden** Verbinde Claude Code, Cursor, Copilot, Codex, Gemini und weitere MCP-Clients per ai-game.dev-Cloud-Endpunkt oder lokalem Server mit Unreal MCP.](https://ai-game.dev/de/docs/wiki/unreal/connecting-ai-clients)
- [**Konfiguration** Unreal MCP konfigurieren: AI Game Developer-Fenster, MCP-Tools-Sichtbarkeit, Projekt-Konfig, .env und alle UNREAL\_MCP\_\*-Umgebungsvariablen.](https://ai-game.dev/de/docs/wiki/unreal/configuration)
- [**Werkzeuge** Die 27 integrierten Unreal MCP Tools: RQL, Blueprints, C++-Quellcode, Python, Screenshots, Konsole – mit Beispiel-Prompts für den Unreal Editor.](https://ai-game.dev/de/docs/wiki/unreal/tools)
- [**Erweiterungen** Optionale Unreal-MCP-Erweiterungen für Control Rig, Enhanced Input, GAS, Landscape, Water, Niagara und PCG: Funktionen und Installation.](https://ai-game.dev/de/docs/wiki/unreal/extensions)
- [**Eigene Tools** Füge eigene KI-Tools, RQL-Module, Prompts und Ressourcen aus jedem C++-Plugin zu Unreal MCP hinzu und biete Gameplay-Tools im laufenden Spiel an.](https://ai-game.dev/de/docs/wiki/unreal/custom-tools)
- [**CLI-Referenz** Komplette Referenz zu unreal-mcp-cli: Plugin installieren, anmelden, AI-Agents konfigurieren, Editor starten, Tools und Python ausführen.](https://ai-game.dev/de/docs/wiki/unreal/cli)
- [**Fehlerbehebung** Behebe häufige Unreal-MCP-Probleme – Plugin lädt nicht, Bridge fehlt, Verbindung hängt, Agent ohne Unreal-Tools, veraltete Builds und Tool-Fehler.](https://ai-game.dev/de/docs/wiki/unreal/troubleshooting)
- [**FAQ** Antworten auf häufige Fragen zu Unreal MCP: Engine-Versionen, KI-Clients, Blueprint-Projekte, Fab, Offline-Nutzung, Kosten und gepackte Spiele.](https://ai-game.dev/de/docs/wiki/unreal/faq)

---

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

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