Installation

Diese Seite zeigt alle Möglichkeiten, das Unity MCP Plugin zu einem Unity-Projekt hinzuzufügen, was jede einzelne mit deinem Projekt macht und wie du das Plugin wieder entfernst. Alle Wege installieren dasselbe Paket com.ivanmurzak.unity.mcp aus der OpenUPM-Registry, du kannst also den Weg wählen, der zu deinem Workflow passt.

Voraussetzungen#

• Unity 2022.3 oder neuer. Das Paket gibt 2022.3 als Mindestversion an; Unity-6-Releases werden unterstützt.
• Ein Projektpfad ohne Leerzeichen. C:/Projects/MyGame ist in Ordnung, C:/My Projects/My Game nicht. Das Plugin protokolliert beim Start einen Fehler, wenn der Pfad ein Leerzeichen enthält.
• Ein kurzer Projektpfad unter Windows. Das Plugin kopiert seine NuGet-DLLs nach Assets/Plugins/NuGet. Würde der resultierende Pfad das 260-Zeichen-Limit von Windows überschreiten, bricht die Installation ab und bittet dich, das Projekt in einen kürzeren Ordner zu verschieben.
• Internetzugang beim ersten Öffnen. Das Plugin lädt seine .NET-Abhängigkeiten von NuGet herunter und im Custom-Modus seine MCP-Server-Binärdatei von GitHub.
• Nur für unity-mcp-cli: Node.js ^20.19.0 oder >=22.12.0.

Option 1: die AI Game Dev Desktop-App (empfohlen)#

Die AI Game Dev App installiert und verbindet das Plugin für dich – ohne Terminal und ohne Node.js auf deinem Rechner.

1. Lade die App herunter und melde dich mit deinem ai-game.dev-Konto an.
2. Öffne deinen Unity-Projektordner in der App. Die App erkennt, dass es sich um ein Unity-Projekt handelt.
3. Klicke auf Install Package. Die App fügt das Plugin in Packages/manifest.json in der neuesten auf OpenUPM veröffentlichten Version hinzu und stuft eine neuere Version, die du bereits hast, niemals herab. Ein Projekt, das du aus der App heraus erstellst, erhält das Plugin automatisch.
4. Öffne den Editor aus der App. Die App übergibt deine Sitzung, sodass sich das Plugin über ai-game.dev verbindet, ohne separate Anmeldung.

Die App installiert außerdem Erweiterungen und führt den AI-Agenten selbst aus, du brauchst also keinen separaten MCP-Client. Details stehen im App-Wiki: Installation und Projekte und Engines.

Option 2: unity-mcp-cli#

unity-mcp-cli bearbeitet Packages/manifest.json direkt, daher muss Unity nicht geöffnet sein:

npm install -g unity-mcp-cli
unity-mcp-cli install-plugin ./MyUnityProject

Du kannst es auch ohne globale Installation ausführen:

npx unity-mcp-cli install-plugin ./MyUnityProject

install-plugin fügt die OpenUPM-Scoped-Registry mit den Scopes com.ivanmurzak und extensions.unity hinzu, trägt com.ivanmurzak.unity.mcp in der neuesten OpenUPM-Version in dependencies ein und stuft eine bereits installierte höhere Version niemals herab. Übergib --plugin-version <version>, um eine Version festzulegen. Der Pfad ist optional, wenn du den Befehl aus dem Projektordner heraus ausführst.

Die CLI kann auch zuerst Unity installieren und ein Projekt erstellen:

unity-mcp-cli install-unity
unity-mcp-cli create-project ./MyUnityProject

Wenn Unity Hub fehlt, installiert die CLI es. Öffne das Projekt anschließend in Unity, damit der Package Manager das Paket auflöst. Alle Befehle stehen in der CLI-Referenz.

Option 3: OpenUPM#

Wenn die OpenUPM CLI installiert ist, führe dies im Projektordner aus:

openupm add com.ivanmurzak.unity.mcp

Ohne die OpenUPM CLI fügst du die Registry und die Abhängigkeit selbst zu Packages/manifest.json hinzu. Verwende die Version, die auf der OpenUPM-Paketseite angezeigt wird:

{
  "scopedRegistries": [
    {
      "name": "package.openupm.com",
      "url": "https://package.openupm.com",
      "scopes": ["com.ivanmurzak", "extensions.unity"]
    }
  ],
  "dependencies": {
    "com.ivanmurzak.unity.mcp": "1.6.2"
  }
}

Füge diese Einträge in deine vorhandene Datei ein; ersetze nicht die anderen Abhängigkeiten.

Option 4: der .unitypackage-Installer#

1. Lade AI-Game-Dev-Installer.unitypackage herunter.
2. Öffne dein Projekt in Unity.
3. Doppelklicke die Datei oder verwende Assets > Import Package > Custom Package und wähle sie aus.
4. Klicke auf Import.

Der Installer ist ein kleines Editor-Skript. Er fügt die OpenUPM-Scoped-Registry und die Plugin-Abhängigkeit zu Packages/manifest.json hinzu und löscht sich anschließend selbst aus Assets. Der Package Manager lädt dann das eigentliche Paket herunter.

Was beim ersten Öffnen passiert#

Nachdem das Paket eingetroffen ist, bereitet sich das Plugin vor:

• Es lädt die benötigten .NET-Bibliotheken (die MCP-Plugin-Bibliothek, ReflectorNet, RQL, SignalR, System.Text.Json und andere) von NuGet nach Assets/Plugins/NuGet herunter, mit einem Cache in Library/NuGetCache, und Unity kompiliert einmal neu. Falls diese DLLs jemals nicht mehr synchron sind, verwende Tools > AI Game Developer > Dependencies > Force Resolve NuGet DLLs.
• Es lädt die gamedev-mcp-server-Binary für deine Plattform von GitHub nach Library/mcp-server/<platform>/ herunter (zum Beispiel win-x64, osx-arm64 oder linux-x64). Der Server wird nur im Custom-Modus mit dem HTTP-Transport gestartet; der Cloud-Modus, der Standard, startet keinen lokalen Server.
• Das Fenster AI Game Developer ist dann unter Window > AI Game Developer — MCP verfügbar (Tastenkürzel Strg+Alt+A bzw. Cmd+Option+A unter macOS). Die Toolbar der Scene View erhält außerdem eine AI-Overlay-Schaltfläche, die es öffnet.

Library/ ist standardmäßig von der Versionskontrolle ausgeschlossen, daher wird die Server-Binary nie eingecheckt. In CI-Umgebungen überspringt das Plugin den Download und den Start des Servers.

Das Plugin aktualisieren#

Wenn auf OpenUPM eine neuere Version verfügbar ist, zeigt das Plugin beim Start des Editors ein Update-Popup an. Manuell prüfen kannst du mit Tools > AI Game Developer > Updates > Check for Updates. Zum Aktualisieren änderst du die Version im Package Manager, führst unity-mcp-cli install-plugin erneut aus (installiert die neueste Version) oder lässt die Desktop-App das Update durchführen.

In Teams, in denen eine Person die Plugin-Version verwaltet, öffnest du Edit > Project Settings > AI Game Developer und aktivierst Disable update notifications for the entire team. Die Einstellung wird in ProjectSettings/AI-Game-Developer-UpdateSettings.asset gespeichert; committe diese Datei. Derselbe Schalter findet sich unter Tools > AI Game Developer > Updates > Disable Update Notifications (Team).

Deinstallieren#

1. Öffne Window > Package Manager, wähle AI Game Developer — MCP und klicke auf Remove, oder führe unity-mcp-cli remove-plugin ./MyUnityProject aus. Die CLI behält die Scoped Registry bei, da andere Pakete sie verwenden könnten.
2. Schließe Unity und lösche den Ordner Assets/Plugins/NuGet sowie die zugehörige Datei Assets/Plugins/NuGet.meta.

Nächste Schritte#

• Erste Schritte: verbinde einen KI-Client und führe deinen ersten Prompt aus.
• Erweiterungen: füge Tool-Pakete für Cinemachine, ProBuilder, Tilemap und mehr hinzu.
• Wenn bei der Installation etwas schiefgeht, siehe Fehlerbehebung.