# Unity MCP — AI Game Developer Wiki

Unity MCP verbindet Claude Code, Cursor, Copilot und weitere KI-Agenten mit dem Unity Editor. Installation, Setup, Tools, Erweiterungen und CLI.

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

Unity MCP ist das Unity-Plugin von AI Game Developer. Es bringt KI in den Unity Editor: Ein Agent wie Claude Code, Cursor, GitHub Copilot, Codex oder Gemini kann deine Szenen, GameObjects, Komponenten, Prefabs und Assets lesen und ändern, C#-Skripte schreiben, C#-Snippets ausführen, deine EditMode- und PlayMode-Tests laufen lassen, die Console lesen und Screenshots aufnehmen, die er sich ansehen kann. Dieses Wiki erklärt, wie du das Plugin installierst, einen KI-Client verbindest und es im Alltag nutzt.

## Was Unity MCP ist

Unity MCP ist ein Unity-Paket, `com.ivanmurzak.unity.mcp`, das im Package Manager als **AI Game Developer — MCP** angezeigt wird. Es läuft im Unity Editor (und, wenn du möchtest, in deinem gebauten Spiel). Es stellt über das Model Context Protocol (MCP) eine Reihe von Tools bereit – den offenen Standard, mit dem KI-Clients externe Tools aufrufen. Der Agent, mit dem du chattest, sieht diese Tools und ruft sie auf, um die Arbeit zu erledigen, die du ihm gibst.

Das Plugin ist Open Source unter der Apache-2.0-Lizenz und liegt im [Unity-MCP-Repository](https://github.com/IvanMurzak/Unity-MCP). Es teilt seine MCP- und Reflection-Bibliotheken mit Unreal MCP und Godot MCP, sodass die drei Engine-Plugins gleich funktionieren und dasselbe ai-game.dev-Konto verwenden.

Seit Version 1.0.0 läuft der größte Teil der Editor-Arbeit über **RQL**, eine Abfragesprache für die Daten des Editors: Ein `rql-query`-Tool liest, ein `rql-mutate`-Tool ändert, und `rql-schema` beschreibt, was verfügbar ist. Ein kleiner Satz fokussierter Tools deckt Screenshots, Skripte, Tests und Pakete ab. Siehe [Tools und RQL](https://ai-game.dev/de/docs/wiki/unity/tools-and-rql).

## Wie die Teile zusammenpassen

| Teil | Was es tut |
| --- | --- |
| Unity MCP-Plugin | Läuft im Unity Editor, stellt die KI-Tools bereit und verbindet sich mit einem MCP-Server. |
| MCP-Server | Der gehostete Server unter ai-game.dev (Cloud-Modus, der Standard) oder ein lokaler `gamedev-mcp-server`, den das Plugin für dich herunterlädt und startet (Custom-Modus). |
| KI-Client | Claude Code, Claude Desktop, Cursor, VS Code Copilot, Codex, Gemini, Rider und andere. Er verbindet sich mit demselben Server. |
| `unity-mcp-cli` | Das npm-Kommandozeilentool, das das Plugin installiert, dich anmeldet, Konfigurationen für KI-Clients schreibt, Unity öffnet und Tools von einem Terminal aus aufruft. |
| AI Game Dev App | Die Desktop-App, die das Plugin installiert, den Editor öffnet und den KI-Agenten für dich ausführt. |

Im **Cloud**-Modus verbinden sich der Editor und dein KI-Client beide mit `https://ai-game.dev/mcp`, und du meldest dich einmal mit deinem ai-game.dev-Konto an. Im **Custom**-Modus startet das Plugin einen lokalen MCP-Server auf deinem Rechner, sodass alles auf deinem Computer bleibt. [Konfiguration](https://ai-game.dev/de/docs/wiki/unity/configuration) erklärt beides.

## Anforderungen auf einen Blick

- Unity **2022.3** oder neuer, einschließlich Unity 6.
- Ein Projektpfad **ohne Leerzeichen** (enthält der Pfad eines, protokolliert das Plugin beim Start einen Fehler).
- Internetzzugang bei der ersten Verwendung: Das Plugin lädt seine .NET-Abhängigkeiten von NuGet und im Custom-Modus die Binärdatei seines MCP-Servers herunter.
- Ein KI-Client, der MCP spricht, oder die [AI Game Dev App](https://ai-game.dev/docs/app).

## Schnellstart

Der einfachste Weg ist die Desktop-App: [lade sie herunter](https://ai-game.dev/de/download), melde dich an und öffne dein Unity-Projekt. Sie installiert das Plugin und verbindet es für dich. Das [App-Wiki](https://ai-game.dev/de/docs/wiki/app) beschreibt diesen Ablauf.

Wenn du ein Terminal und deinen eigenen KI-Client bevorzugst, bringen diese Befehle ein Unity-Projekt zu einem verbundenen Agenten:

```bash
npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProject
unity-mcp-cli login
unity-mcp-cli setup-mcp claude-code ./MyUnityProject
unity-mcp-cli open ./MyUnityProject
```

Dann bitte deinen Agenten um etwas wie „Erstelle 3 Würfel im Kreis mit Radius 2“. [Erste Schritte](https://ai-game.dev/de/docs/wiki/unity/getting-started) führt durch dieselben Schritte mit Erklärungen.

## Seiten in diesem Abschnitt

- [Installation](https://ai-game.dev/de/docs/wiki/unity/installation): alle Möglichkeiten, das Plugin zu installieren (die App, `unity-mcp-cli`, OpenUPM, der `.unitypackage`-Installer) und wie du es deinstallierst.
- [Erste Schritte](https://ai-game.dev/de/docs/wiki/unity/getting-started): deine erste Verbindung und deine ersten Prompts.
- [KI-Clients verbinden](https://ai-game.dev/de/docs/wiki/unity/connecting-ai-clients): Cloud- vs. lokale Endpunkte, Anmeldung, feste URLs und der Konfigurator für jeden Agenten.
- [Konfiguration](https://ai-game.dev/de/docs/wiki/unity/configuration): das AI Game Developer-Fenster, Verbindungsmodi, Ports, die Konfigurationsdatei, Umgebungsvariablen-Overrides und Builds.
- [Tools und RQL](https://ai-game.dev/de/docs/wiki/unity/tools-and-rql): was der Agent im Editor tun kann.
- [Eigene Tools](https://ai-game.dev/de/docs/wiki/unity/custom-tools): verwandle deine eigenen C#-Methoden in KI-Tools, Prompts und Skills, auch in einem laufenden Spiel.
- [Erweiterungen](https://ai-game.dev/de/docs/wiki/unity/extensions): optionale Pakete für Animation, Cinemachine, Input System, Navigation, ProBuilder, Terrain, Tilemap, Timeline und mehr.
- [unity-mcp-cli-Referenz](https://ai-game.dev/de/docs/wiki/unity/cli): jeder Befehl und jedes Flag.
- [Fehlerbehebung](https://ai-game.dev/de/docs/wiki/unity/troubleshooting): Lösungen für häufige Probleme.
- [FAQ](https://ai-game.dev/de/docs/wiki/unity/faq): kurze Antworten auf häufige Fragen.

## Mehr auf der Website

- [Unity-Tool-Katalog](https://ai-game.dev/docs/tools/unity) und die [RQL-Referenz](https://ai-game.dev/docs/rql).
- [Katalog der Unity-Erweiterungen](https://ai-game.dev/docs/extensions/unity).
- [Best Practices für Unity](https://ai-game.dev/docs/best-practices/unity) für Prompts und Projekt-Setup.
- [MCP-Endpunkt](https://ai-game.dev/de/mcp-endpoint-info) mit Konfigurations-Snippets für jeden unterstützten Client.
- [Authentifizierung](https://ai-game.dev/docs/auth), der [Schnellstart](https://ai-game.dev/de/docs/quickstart) und die [Unity-Engine-Seite](https://ai-game.dev/de/engines/unity).
- Die anderen Engines: [Unreal MCP](https://ai-game.dev/de/docs/wiki/unreal) und [Godot MCP](https://ai-game.dev/de/docs/wiki/godot).

- [**Installation** Installiere Unity MCP (AI Game Developer) in einem Unity-Projekt mit der Desktop-App, unity-mcp-cli, OpenUPM oder dem .unitypackage-Installer.](https://ai-game.dev/de/docs/wiki/unity/installation)
- [**Erste Schritte** Verbinde deinen ersten AI-Agenten mit Unity MCP mit dem Unity Editor, prüfe die Verbindung und teste deine ersten Prompts in Claude Code, Cursor oder Copilot.](https://ai-game.dev/de/docs/wiki/unity/getting-started)
- [**KI-Clients verbinden** Verbinde Claude Code, Cursor, Copilot, Codex, Gemini und weitere MCP-Clients über die ai-game.dev-Cloud oder einen lokalen Server mit Unity MCP.](https://ai-game.dev/de/docs/wiki/unity/connecting-ai-clients)
- [**Konfiguration** Unity MCP im AI Game Developer-Fenster konfigurieren: Cloud- und Custom-Modus, lokaler Server, Port, Transport, Autorisierung, Tools und CI.](https://ai-game.dev/de/docs/wiki/unity/configuration)
- [**Tools und RQL** Was ein AI-Agent mit Unity MCP im Unity Editor kann: RQL-Abfragen und -Mutationen, Screenshots, C#-Skripte, Tests, Pakete und Profiling.](https://ai-game.dev/de/docs/wiki/unity/tools-and-rql)
- [**Benutzerdefinierte Tools** Eigene Unity MCP Tools, Prompts, Ressourcen und Skills in C# mit AiTool-Attributen schreiben, im Main Thread ausführen und im fertigen Spiel nutzen.](https://ai-game.dev/de/docs/wiki/unity/custom-tools)
- [**Erweiterungen** Unity-MCP-Erweiterungen für Animation, Cinemachine, Input System, Navigation, ProBuilder, Splines, Terrain, Tilemap, Timeline und Partikel.](https://ai-game.dev/de/docs/wiki/unity/extensions)
- [**unity-mcp-cli-Referenz** Befehlsreferenz für unity-mcp-cli: Unity MCP installieren, anmelden, Agent-Konfigs schreiben, Unity headless öffnen, Tools und C# per CLI starten.](https://ai-game.dev/de/docs/wiki/unity/cli)
- [**Fehlerbehebung** Behebe häufige Unity-MCP-Probleme – keine Tools im KI-Client, Anmelde- und Verbindungsfehler, Server-Download-Fehler, NuGet-DLL-Fehler und Portkonflikte.](https://ai-game.dev/de/docs/wiki/unity/troubleshooting)
- [**FAQ** Antworten auf häufige Fragen zu Unity MCP: Unity-Versionen, KI-Clients, Cloud- vs. lokaler Modus, Kosten, Datenschutz, Builds, CI und RQL.](https://ai-game.dev/de/docs/wiki/unity/faq)

---

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

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