# Unity-Plugin einrichten — AI Game Developer

Richte das AI Game Developer-Plugin für Unity Schritt für Schritt ein: installieren, anmelden, AI-Client verbinden und Erweiterungen hinzufügen — mit Lösungen für die häufigsten Probleme.

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

Unity · manuelle Einrichtung

Alles, um von einem leeren Unity-Projekt zu einem AI-Agenten zu kommen, der im Editor arbeitet: Plugin installieren, anmelden, AI-Client verbinden und die Erweiterungen hinzufügen, die du brauchst. Die [Unity-Installationsseite](https://ai-game.dev/de/engines/unity) hat die Kurzfassung.

01

## Bevor du loslegst

Unity 2022.3 oder neuer, ein ai-game.dev-Konto und ein AI-Client.

- **Unity 2022.3 oder neuer** — Unity 6 wird unterstützt.
- **Ein ai-game.dev-Konto** für die standardmäßige Cloud-Verbindung — [lege eins an](https://ai-game.dev/create-account), wenn du noch keins hast.
- **Ein AI-Client** — die AI Game Dev App, Claude Code, Cursor, Copilot, Gemini, Codex oder einer der [14 unterstützten MCP-Clients](https://ai-game.dev/de/mcp-endpoint-info).
- **Internetzugang beim ersten Öffnen** — das Plugin lädt seine .NET-Pakete von NuGet.

02

## Plugin installieren

Mit der App, der CLI, OpenUPM oder dem Installer-Paket — such dir einen Weg aus.

Vier Wege, das Plugin hinzuzufügen, vom einfachsten angefangen:

**Desktop-App**

Öffne dein Unity-Projekt in der [AI Game Dev App](https://ai-game.dev/de/download) und klicke auf **Install Package**. Die App installiert das neueste Plugin von OpenUPM, meldet es an und richtet deinen Agenten ein.

**unity-mcp-cli**

Installiere die CLI aus npm und füge dann das Plugin zu deinem Projekt hinzu (sie bearbeitet `Packages/manifest.json` für dich):

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

**OpenUPM**

Mit der OpenUPM CLI führst du im Projektordner Folgendes aus:

```bash
openupm add com.ivanmurzak.unity.mcp
```

Keine OpenUPM CLI? Füge die Scoped Registry zu `Packages/manifest.json` hinzu und dann das Paket in **Window → Package Manager**:

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

**.unitypackage**

Lade den Installer herunter und importiere ihn mit **Assets → Import Package → Custom Package…**. Er fügt die OpenUPM-Registry und das Paket zu deinem Projekt hinzu, sodass spätere Updates über den Package Manager kommen.

[⬇ AI-Game-Dev-Installer.unitypackage herunterladen](https://github.com/IvanMurzak/Unity-MCP/releases/latest/download/AI-Game-Dev-Installer.unitypackage)

03

## Fenster öffnen und anmelden

Öffne das AI Game Developer-Fenster und melde dich einmal mit deinem Konto an.

1. Wähle in Unity **Window → AI Game Developer — MCP** (`Ctrl+Alt+A`, oder `Cmd+Option+A` unter macOS).
2. Lass den Schalter **Connection** auf **Cloud** und klicke auf **Authorize**.
3. Dein Browser öffnet die Anmeldeseite von ai-game.dev mit einem kurzen Code. Prüfe, ob der Code übereinstimmt, und bestätige ihn.
4. Der Unity-Status wechselt auf **Connected**.

Die Anmeldung gilt für den ganzen Computer: Wenn du dich bereits mit der App oder mit `unity-mcp-cli login` angemeldet hast, nutzt der Editor diese und du kannst diesen Schritt überspringen.

04

## AI-Client verbinden

Ein Befehl oder ein Klick im Fenster schreibt die Konfiguration deines Clients.

Klicke im Fenster neben deinem AI-Agenten auf **Configure** — oder führe `setup-mcp` in einem Terminal aus. Beides schreibt die projektgebundene URL und einen Projektschlüssel in die Konfiguration des Clients, sodass er sich sofort verbindet:

```bash
# Claude Code — use your agent's id (cursor, codex, gemini, vscode-copilot, …)
unity-mcp-cli setup-mcp claude-code ./MyUnityProject
```

Starte den AI-Client neu, nachdem sich seine Konfiguration geändert hat. Für andere Clients und die manuelle Konfiguration siehe [AI-Clients verbinden](https://ai-game.dev/de/docs/wiki/unity/connecting-ai-clients) und die [MCP-Endpunkt-Seite](https://ai-game.dev/de/mcp-endpoint-info).

05

## Erweiterungen hinzufügen (optional)

Animation, Cinemachine, Terrain, Timeline und mehr — installiere nur, was du brauchst.

Jede Erweiterung ist ein eigenes Unity-Paket. Sie bringt dem Agenten direkt nach der Installation einen Bereich von Unity über RQL bei. Ein paar beliebte:

- [AI Animation](https://ai-game.dev/docs/extensions/unity/animation) 3 Funktionen
  ```bash
  openupm add com.ivanmurzak.unity.mcp.animation
  ```
- [AI Cinemachine](https://ai-game.dev/docs/extensions/unity/cinemachine) 4 Funktionen
  ```bash
  openupm add com.ivanmurzak.unity.mcp.cinemachine
  ```
- [AI Terrain](https://ai-game.dev/docs/extensions/unity/terrain) 4 Funktionen
  ```bash
  openupm add com.ivanmurzak.unity.mcp.terrain
  ```
- [AI Timeline](https://ai-game.dev/docs/extensions/unity/timeline) 5 Funktionen
  ```bash
  openupm add com.ivanmurzak.unity.mcp.timeline
  ```

[Alle 10 Unity-Erweiterungen →](https://ai-game.dev/docs/extensions/unity)

?

## Fehlerbehebung

Lösungen für die häufigsten Probleme. Mehr im [Leitfaden zur Unity-Fehlerbehebung](https://ai-game.dev/de/docs/wiki/unity/troubleshooting).

**Mein KI-Client verbindet sich, zeigt aber keine Tools**

Stelle sicher, dass der Unity-Status **Connected** lautet, und verbinde den Client dann neu (in Claude Code: `/mcp`) oder starte ihn neu. Wenn immer noch nichts aufgelistet wird, klicke erneut auf **Configure** für deinen Agenten und starte den Client neu.

**Das Fenster von AI Game Developer erscheint nicht**

Das Plugin lädt erst, wenn das Projekt kompiliert wurde. Prüfe die Console auf Kompilierungsfehler irgendwo im Projekt und öffne den Editor dann erneut. Fehlende Typen aus McpPlugin oder ReflectorNet bedeuten meist, dass der erste Import noch nicht abgeschlossen ist: Warte, oder nutze **Tools → AI Game Developer → Dependencies → Force Resolve NuGet DLLs**.

**Custom-Modus: Der lokale MCP-Server startet nicht**

Im Custom-Modus lädt das Plugin `gamedev-mcp-server` nach `Library/mcp-server/<platform>/` herunter. Wenn eine Firewall oder ein Proxy das blockiert hat, zeigt das Fenster einen Serverfehler mit dem Button **Download / Retry**. Im Cloud-Modus ist kein lokaler Server nötig.

**Portkonflikt im Custom-Modus**

Jedes Projekt bekommt einen festen lokalen Port zwischen 20000 und 29999, abgeleitet aus seinem Pfad. Wenn ein anderer Prozess ihn bereits belegt, wird der Server als **External** angezeigt: Beende den Prozess, oder gib in **Server URL** einen anderen Port ein und klicke erneut auf **Configure**.

**Package Manager meldet, dass das Paket ein neueres Unity benötigt**

Das Plugin benötigt Unity 2022.3 oder neuer. Aktualisiere das Projekt, oder installiere mit `unity-mcp-cli install-unity` einen neueren Editor.

### Nächster Halt

[**Unity-Wiki →** Konfiguration, Tools und RQL, eigene Tools, die CLI-Referenz und mehr.](https://ai-game.dev/de/docs/wiki/unity) [**Unity-Tools →** Alles, was der Agent in Unity kann – mit Beispielen.](https://ai-game.dev/docs/tools/unity) [**Best Practices →** Wie du den Agenten um Aufgaben bittest, die er gut löst.](https://ai-game.dev/docs/best-practices/unity)

---

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

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