# Erste Schritte — Godot · AI Game Developer Wiki

Verbinde Godot MCP mit der Cloud, richte einen AI-Agenten wie Claude Code ein, prüfe die Verbindung und starte erste Prompts im Godot-Editor.

Diese Seite wurde maschinell aus dem Englischen übersetzt. [Englisches Original lesen](https://ai-game.dev/docs/wiki/godot/getting-started).

Diese Seite führt dich von einem installierten Addon zu einem AI-Agenten, der deine Godot-Szene bearbeitet. Sie setzt voraus, dass das Addon bereits in deinem Projekt ist; falls nicht, beginne mit [Installation](https://ai-game.dev/de/docs/wiki/godot/installation). Die Schritte verwenden den Standard-Cloud-Modus, bei dem sowohl der Editor als auch dein Agent sich mit [ai-game.dev](https://ai-game.dev) verbinden und du dich einmal anmeldest.

## Schritt 1: Projekt öffnen

Öffne das Projekt mit der CLI:

```bash
godot-cli open ./MyGodotProject
```

`open` baut zuerst die C#-Assembly und startet dann den Editor. Der Build ist beim allerersten Öffnen wichtig: Godot lädt aktivierte Addons sofort, und ohne eine gebaute Assembly meldet es, dass es `GodotMcpPlugin.cs` nicht laden kann, und deaktiviert das Addon. Wenn du das Projekt stattdessen über den Godot-Projektmanager öffnest, baue es einmal (die Schaltfläche Build im Editor oder `godot-cli build`) und aktiviere das Plugin erneut, falls Godot es deaktiviert hat.

Wenn das Addon geladen wird, gibt das Output-Panel des Editors `[Godot-MCP] plugin loaded` aus und das Dock **AI Game Developer** erscheint im Dock-Bereich oben rechts.

## Schritt 2: Anmelden

Der Cloud-Modus benötigt dein ai-game.dev-Konto. Wähle eine der folgenden Möglichkeiten:

- Behalte im Dock den Modus **Cloud** bei und klicke auf **Authorize**. Dein Browser öffnet sich mit einem kurzen Code; bestätige ihn mit deinem ai-game.dev-Konto.
- Führe in einem Terminal `godot-cli login` aus. Es nutzt denselben OAuth-Device-Flow und speichert die Anmeldedaten in `~/.ai-game-dev/credentials.json`, die der Editor von selbst aufnimmt.

Du meldest dich einmal pro Rechner an. Dieselben Anmeldedaten dienen Godot MCP, Unity MCP, Unreal MCP, den Engine-CLIs und der AI Game Dev App. Die Sitzung erscheint in den verbundenen Geräten deines Kontos, wo du sie widerrufen kannst. Details: [Authentifizierung](https://ai-game.dev/docs/auth).

## Schritt 3: AI-Agent verbinden

Schreibe die MCP-Konfiguration für den Agenten, den du verwendest. Für Claude Code:

```bash
godot-cli setup-mcp claude-code ./MyGodotProject
```

Damit wird `.mcp.json` im Projekt mit einer auf dieses Projekt festgelegten URL geschrieben, sodass der Agent diesen Editor auch dann erreicht, wenn du mehrere Editoren geöffnet hast. Du kannst dasselbe auch im Dock tun: Wähle deinen Agenten im Abschnitt **AI agent** und klicke auf **Configure**. Weitere Agenten (Cursor, VS Code Copilot, Codex, Gemini und mehr) sind unter [AI-Clients verbinden](https://ai-game.dev/de/docs/wiki/godot/connecting-ai-clients) aufgeführt.

Starte den Agenten neu oder lade seine MCP-Server neu, nachdem die Konfiguration geschrieben wurde. Starte den Agenten aus dem Projektordner, wenn die Konfiguration dort liegt (Claude Code liest `.mcp.json` aus dem Ordner, in dem es gestartet wird).

## Schritt 4: Verbindung prüfen

Der Abschnitt **Connection** im Dock zeigt eine Reihe von drei Punkten: Godot, den MCP-Server und den AI-Agenten. Wenn der Editor verbunden ist und eine Agent-Sitzung aktiv ist, leuchten alle drei, und die Agent-Zeile nennt den Client. In einem Terminal kannst du außerdem darauf warten, dass der Editor antwortet:

```bash
godot-cli wait-for-ready ./MyGodotProject
godot-cli status ./MyGodotProject
```

`wait-for-ready` fragt die Bereitschaftsprüfung (`ping`) ab, bis sie antwortet, standardmäßig bis zu zwei Minuten lang. `status` meldet, ob für das Projekt ein Editor läuft und ob der Server antwortet.

Bitte deinen Agenten, seine Tools aufzulisten, oder führe `/mcp` in Claude Code aus. Du solltest Tools wie `rql-query`, `rql-mutate`, `script-create` und `screenshot-viewport` sehen.

## Schritt 5: Erste Prompts

Probiere diese im Chat deines Agenten aus. Jeder davon entspricht echten Tools, sodass du beobachten kannst, wie sich die Szene im Editor verändert:

- „Füge eine Node3D-Szene mit einer Camera3D und einem MeshInstance3D-Würfel hinzu und speichere sie als Main.tscn.“
- „Erstelle 3 Würfel im Kreis mit Radius 2.“
- „Liste alle OmniLight3D in der Szene mit ihrer Energy auf.“
- „Erstelle ein StandardMaterial3D für den Boden und setze seine Albedo-Farbe auf Grau.“
- „Erstelle ein Skript Player.cs mit einem öffentlichen float Speed, hänge es an den Player-Node und baue das Projekt.“
- „Füge eine Eingabeaktion namens jump auf der Leertaste hinzu.“
- „Mach einen Screenshot des Viewports und sag mir, was du siehst.“

Szenenänderungen des Agenten lassen sich rückgängig machen: Drücke im Editor Strg+Z, um einen Schritt zurückzugehen, genau wie bei deinen eigenen Änderungen. Szenenänderungen markieren die Szene als ungespeichert, also bitte den Agenten zu speichern oder speichere selbst. Weitere Prompt-Ideen findest du unter [Best Practices für Godot](https://ai-game.dev/docs/best-practices/godot).

## Was der Agent sehen kann und was nicht

Der Agent arbeitet über die Tools, die das Addon bereitstellt. Er kann den Szenenbaum, Godot-Eigenschaften (einschließlich GDScript-Variablen), Ressourcen, Dateien, Projekteinstellungen, die Input Map, Autoloads, die Konsole und den Editor-Status über RQL lesen und sich Screenshots ansehen. Er kann nicht in der Editor-UI klicken. Die vollständige Liste steht unter [Tools](https://ai-game.dev/de/docs/wiki/godot/tools) und im [Godot-Toolkatalog](https://ai-game.dev/docs/tools/godot).

## Lieber offline bleiben?

Du kannst den MCP-Server auf deinem eigenen Rechner statt in der Cloud ausführen. Stelle im Dock den Modus auf **Custom** und klicke auf **Start Server**: Das Addon lädt den passenden Server-Build von GitHub herunter, startet ihn und verbindet sich damit. Richte deinen Agenten dann auf die lokale URL. Siehe [Verbindung von KI-Clients](https://ai-game.dev/de/docs/wiki/godot/connecting-ai-clients#custom-mode).

## Nächste Schritte

- [Konfiguration](https://ai-game.dev/de/docs/wiki/godot/configuration): das Dock, Log-Level und welche Tools der Agent sieht.
- [Erweiterungen](https://ai-game.dev/de/docs/wiki/godot/extensions): Unterstützung für AnimationPlayer, CSG, Navigation, Tilemap und Addons hinzufügen.
- [Fehlerbehebung](https://ai-game.dev/de/docs/wiki/godot/troubleshooting): falls ein oben genannter Schritt nicht funktioniert hat.

---

Source (HTML): https://ai-game.dev/de/docs/wiki/godot/getting-started

Machine-translated (de) from the English page: https://ai-game.dev/docs/wiki/godot/getting-started