FAQ

Kurze Antworten auf die Fragen, die am häufigsten zu Unity MCP gestellt werden, dem AI Game Developer Plugin für Unity. Jede Antwort verlinkt auf die Seite mit den Details.

Allgemein#

Was ist Unity MCP?#

Ein Unity Editor-Plugin, mit dem KI-Agenten über das Model Context Protocol in deinem Projekt arbeiten können. Der Agent kann Szenen, GameObjects, Komponenten, Prefabs und Assets lesen und ändern, C# schreiben und ausführen, Tests laufen lassen und Screenshots aufnehmen. Siehe die Übersicht.

Ist das Plugin kostenlos und Open Source?#

Das Plugin ist Open Source unter der Apache-2.0-Lizenz, im Unity-MCP-Repository. Der Custom-Modus betreibt einen lokalen Server und benötigt kein Konto. Der Cloud-Modus verwendet dein ai-game.dev-Konto; Tarife findest du auf der Preisseite.

Welche Unity-Versionen werden unterstützt?#

Unity 2022.3 und neuer, einschließlich Unity 6.

Welche KI-Clients funktionieren damit?#

Das Fenster AI Game Developer bietet Konfiguratoren für Claude Code, Claude Desktop, Cursor, Visual Studio Code (Copilot), Visual Studio (Copilot), Rider (Junie), GitHub Copilot CLI, Gemini, Antigravity, Cline, Open Code, Codex, Kilo Code, Zoo Code und Unity AI sowie einen eigenen Eintrag für jeden anderen MCP-Client. Siehe KI-Clients verbinden.

Brauche ich einen eigenen KI-Client?#

Nein. Die AI Game Dev Desktop-App enthält den Agenten, installiert das Plugin und verbindet es. Nutze deinen eigenen Client, wenn du bereits Claude Code, Cursor oder einen anderen MCP-Client verwendest.

Einrichtung#

Was ist der einfachste Weg, es zu installieren?#

Die Desktop-App. Ohne sie führe unity-mcp-cli install-plugin aus oder verwende OpenUPM bzw. den .unitypackage-Installer. Siehe Installation.

Wo ist das Plugin-Fenster?#

Window > AI Game Developer — MCP, Tastenkürzel Strg+Alt+A (Cmd+Option+A unter macOS), oder die AI-Schaltfläche in der Symbolleiste der Scene-Ansicht.

Was ist der Unterschied zwischen Cloud- und Custom-Modus?#

Im Cloud-Modus, dem Standard, verbinden sich der Editor und dein KI-Client mit https://ai-game.dev/mcp und du meldest dich einmal an. Im Custom-Modus betreibt das Plugin einen lokalen MCP-Server auf einem Port, der aus deinem Projektpfad abgeleitet wird, und alles bleibt auf deinem Rechner. Siehe Konfiguration.

Muss ich einen Port auswählen?#

Nein. Der Port wird aus dem Projektpfad abgeleitet (Bereich 20000 bis 29999), ist also pro Projekt stabil und unterscheidet sich zwischen Projekten. Du kannst ihn in Server URL überschreiben.

Wo werden die Einstellungen gespeichert?#

In UserSettings/AI-Game-Developer-Config.json innerhalb des Projekts. Die ai-game.dev-Anmeldung wird einmal pro Rechner in ~/.ai-game-dev/credentials.json gespeichert.

Kann ich mehrere Unity-Projekte gleichzeitig verwenden?#

Ja. Jedes Projekt hat seinen eigenen Port, und angepinnte URLs (https://ai-game.dev/mcp/p/<pin>) leiten jeden Agenten zum richtigen Editor.

Verwendung#

Wohin sind Tools wie gameobject-create verschwunden?#

Version 1.0.0 hat die Tools mit einem Tool pro Aktion durch RQL ersetzt: rql-query, rql-mutate und rql-schema decken Szenen, GameObjects, Komponenten, Assets, die Console und den Editor-Status ab. Siehe Tools und RQL.

Kann die KI ihre Änderungen rückgängig machen?#

Jeder rql-mutate-Aufruf wird als ein Undo-Schritt aufgezeichnet, sodass Strg+Z (Cmd+Z) ihn rückgängig macht. Für alles Größere nutze eine Versionskontrolle.

Warum sieht der Agent nur wenige Tools?#

Um Kontext zu sparen. Standardmäßig sind sieben Tools sichtbar; der Rest ist installiert, aber ausgeblendet und wird trotzdem ausgeführt, wenn er per Name aufgerufen wird. Blende mehr im Fenster unter Tools > Open ein.

Kann ich eigene Tools hinzufügen?#

Ja. Markiere eine Klasse mit [AiToolType] und eine Methode mit [AiTool]. Siehe Eigene Tools.

Wie füge ich Unterstützung für Cinemachine, ProBuilder oder Tilemaps hinzu?#

Installiere die passende Erweiterung im Extensions-Bereich des Fensters oder mit unity-mcp-cli install-extension. Siehe Erweiterungen.

Funktioniert es im Play-Modus?#

Ja. Der Agent kann den Play-Modus über RQL betreten und verlassen (editor-Member wie isPlaying). Die Verbindung wird nach dem Domain-Reload wiederhergestellt.

Builds, CI und Datenschutz#

Landet das Plugin in meinem Spiel-Build?#

Der Runtime-Teil wird in Player-Builds kompiliert, aber ein Build verbindet sich nie von selbst. Du entscheidest dich im Code mit UnityMcpPluginRuntime.Initialize(...) dafür, um einer KI Tools in deinem Spiel zu geben. Um das Plugin vollständig auszuschließen, füge das Scripting-Define UNITY_MCP_EXCLUDE_FROM_COMPILATION hinzu. Siehe Konfiguration.

Wie halte ich es aus CI-Testläufen heraus?#

Setze UNITY_MCP_DISABLE=1 in der Umgebung des Unity-Prozesses oder verwende das Define UNITY_MCP_EXCLUDE_FROM_COMPILATION. Siehe Konfiguration.

Kann ich es ohne KI-Client skripten?#

Ja. unity-mcp-cli run-tool ruft jedes Tool von einem Terminal aus auf, und unity-mcp-cli exec führt C# im Editor aus. Siehe die CLI-Referenz.

Welche Daten verlassen meinen Rechner?#

Im Custom-Modus mit none- oder token-Autorisierung läuft nichts über ai-game.dev: Der Agent und Unity kommunizieren über den lokalen Server. Dein KI-Client sendet deine Konversation weiterhin an seinen eigenen Modellanbieter. Im Cloud-Modus laufen Tool-Aufrufe und Ergebnisse auf dem Weg zwischen deinem Agenten und dem Editor über den ai-game.dev-Server.

Wie schalte ich das Update-Popup für mein Team aus?#

Aktiviere Disable update notifications for the entire team in Edit > Project Settings > AI Game Developer und committe ProjectSettings/AI-Game-Developer-UpdateSettings.asset.

Weitere Hilfe#

• Fehlerbehebung bei Fehlern.
• Die websiteweite FAQ und Unity-Best-Practices.