# Installation — Unity · AI Game Developer Wiki

Installiere Unity MCP (AI Game Developer) in einem Unity-Projekt mit der Desktop-App, unity-mcp-cli, OpenUPM oder dem .unitypackage-Installer.

Diese Seite wurde maschinell aus dem Englischen übersetzt. [Englisches Original lesen](https://ai-game.dev/docs/wiki/unity/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](https://ai-game.dev/docs/app) installiert und verbindet das Plugin für dich – ohne Terminal und ohne Node.js auf deinem Rechner.

1. [Lade die App herunter](https://ai-game.dev/de/download) 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](https://ai-game.dev/de/docs/wiki/app/installation) und [Projekte und Engines](https://ai-game.dev/de/docs/wiki/app/projects-and-engines).

## Option 2: unity-mcp-cli

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

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

Du kannst es auch ohne globale Installation ausführen:

```bash
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:

```bash
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](https://ai-game.dev/de/docs/wiki/unity/cli).

## Option 3: OpenUPM

Wenn die [OpenUPM CLI](https://openupm.com/) installiert ist, führe dies im Projektordner aus:

```bash
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](https://openupm.com/packages/com.ivanmurzak.unity.mcp/) angezeigt wird:

```json
{
  "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](https://github.com/IvanMurzak/Unity-MCP/releases/latest/download/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](https://ai-game.dev/de/docs/wiki/unity/getting-started): verbinde einen KI-Client und führe deinen ersten Prompt aus.
- [Erweiterungen](https://ai-game.dev/de/docs/wiki/unity/extensions): füge Tool-Pakete für Cinemachine, ProBuilder, Tilemap und mehr hinzu.
- Wenn bei der Installation etwas schiefgeht, siehe [Fehlerbehebung](https://ai-game.dev/de/docs/wiki/unity/troubleshooting).

---

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

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