Diese Seite wurde maschinell aus dem Englischen übersetzt. Englisches Original lesen.

Unity MCP

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

Aktualisiert am 4. November 2026 Als Markdown anzeigen

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. 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.

Wie die Teile zusammenpassen

TeilWas es tut
Unity MCP-PluginLäuft im Unity Editor, stellt die KI-Tools bereit und verbindet sich mit einem MCP-Server.
MCP-ServerDer 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-ClientClaude Code, Claude Desktop, Cursor, VS Code Copilot, Codex, Gemini, Rider und andere. Er verbindet sich mit demselben Server.
unity-mcp-cliDas 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 AppDie 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 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.

Schnellstart

Der einfachste Weg ist die Desktop-App: lade sie herunter, melde dich an und öffne dein Unity-Projekt. Sie installiert das Plugin und verbindet es für dich. Das App-Wiki beschreibt diesen Ablauf.

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

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 führt durch dieselben Schritte mit Erklärungen.

Seiten in diesem Abschnitt

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

Mehr auf der Website