# Konfiguration — Godot · AI Game Developer Wiki

Godot MCP im AI Game Developer-Dock einrichten, Tools für KI-Agenten wählen und Einstellungen per GODOT_MCP_*-Umgebungsvariablen überschreiben.

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

Die meisten ändern nie eine Einstellung: Das Addon startet im Cloud-Modus, verbindet sich nach der Anmeldung und stellt alle seine Tools bereit. Diese Seite beschreibt, was du ändern kannst, wenn es nötig ist – im Dock **AI Game Developer**, in gespeicherten Einstellungen und über Umgebungsvariablen für CI und Skript-Läufe.

## Das AI Game Developer-Dock

Das Addon fügt dem oberen rechten Dock-Bereich des Godot-Editors ein Dock namens **AI Game Developer** hinzu. Von oben nach unten enthält es diese Abschnitte.

### Kopfzeile

Die Kopfzeile zeigt die Version des Addons und eine Auswahl für **Log Level**. Das Log-Level steuert, wie viel das Addon und seine Verbindung im Output-Panel ausgeben (`Trace`, `Debug`, `Info`, `Warning`, `Error`, `None`; Standard `Info`). Stelle es auf `Debug` oder `Trace`, wenn du ein Verbindungsproblem diagnostizierst. Wenn `GODOT_MCP_LOG_LEVEL` gesetzt ist, ist die Auswahl deaktiviert und ein Hinweis weist darauf hin.

### Verbindung

- **Cloud / Custom**: der Verbindungsmodus. Cloud verbindet mit [ai-game.dev](https://ai-game.dev); Custom verbindet mit einer Server-URL deiner Wahl.
- **Connect / Stop**: startet oder stoppt die Verbindung zum MCP-Server. Das Addon versucht es im Hintergrund weiter, bis die Verbindung steht.
- Im Cloud-Modus: dein Anmeldestatus mit **Authorize** (startet die Geräte-Anmeldung im Browser) und **Sign out**.
- Eine Zeile mit drei Punkten – Godot, MCP-Server und KI-Agent –, die zeigt, was verbunden ist. Die Zeile des KI-Agenten listet die verbundenen Clients mit Namen auf oder zeigt "(connects on demand)", wenn noch keiner verbunden ist.

Im Custom-Modus ergänzt eine Karte **MCP server**:

- **Server URL**: der Server, mit dem verbunden wird, Standard `http://localhost:8080`.
- **Authorization Token**: `none`, `oauth` (das Token deines ai-game.dev-Kontos, nur an einen localhost-Server gesendet) oder `token` (ein Bearer-Token; **New** erzeugt eines).
- **Start Server / Stop Server**: einen lokalen Server herunterladen, starten und stoppen, der zur festgelegten Serverversion des Addons passt. Siehe [KI-Clients verbinden](https://ai-game.dev/de/docs/wiki/godot/connecting-ai-clients#custom-mode).

Wenn eine Umgebungsvariable den Modus oder Host erzwingt, steht in einem gelben Hinweis "Overridden by environment (GODOT\_MCP\_\*)" und Änderungen im Dock werden nicht wirksam.

### KI-Agent

Wähle den KI-Client, den du verwendest (Claude Code ist der Standard). Der Abschnitt zeigt dann:

- **Skills**: wohin die Skill-Dateien des Agenten kommen, einen Schalter **Auto-generate**, der sie beim Laden des Addons aktualisiert, und eine Schaltfläche **Generate**. Agenten ohne Skill-Unterstützung zeigen "Skills not supported by this agent".
- **Model Context Protocol (MCP)**: ob die MCP-Konfiguration des Agenten eingerichtet ist, mit **Configure** / **Reconfigure** und **Remove**. Ein Hinweis **Reconfiguration Required** erscheint, wenn sich die Server-Einstellungen geändert haben, nachdem du den Agenten konfiguriert hast.

### MCP-Funktionen

Drei Zeilen, **Tools**, **Prompts** und **Resources**, jeweils mit der Anzahl der sichtbaren Elemente von der Gesamtzahl (Tools zeigen zusätzlich geschätzte Token-Kosten) und einer Schaltfläche **Open**. Das sich öffnende Fenster listet jedes Element mit einem Schalter **Visible** und einem Filterfeld auf.

**Visible** entscheidet nur, ob MCP-Clients das Element in ihrer Tool-Liste sehen. Nicht benötigte Tools auszublenden hält den Kontext des Agenten kleiner. Es ist keine Zugriffskontrolle: Ein ausgeblendetes Tool wird trotzdem ausgeführt, wenn ein Client es beim Namen aufruft.

### Erweiterungen

Die Liste der optionalen Godot MCP-Erweiterungen mit den Schaltflächen **Install** und **Update**. Sie liest den in deiner `.csproj` eingebetteten Erweiterungskatalog; wenn die Liste leer ist, siehe [Erweiterungen](https://ai-game.dev/de/docs/wiki/godot/extensions).

### Fußzeile

Links für Hilfe und zum Melden von Problemen sowie ein Fenster **Serialization Check**, das zeigt, wie ein ausgewählter Node oder ein Objekt für die KI serialisiert wird (nützlich beim Melden eines Bugs).

## Wo Einstellungen gespeichert werden

Das Dock speichert seine Einstellungen in `user://godot-mcp-config.json`, im benutzerspezifischen Datenordner von Godot für das Projekt (nicht im Projekt selbst). Die Datei enthält den Verbindungsmodus, den Custom-Host, die Autorisierungsoption, das Log-Level, den ausgewählten Agenten, die Tool-Sichtbarkeit und die verwendeten Tokens.

**Warnung**

Diese Datei speichert Tokens als reines JSON. Committe, synchronisiere oder teile sie nicht. Um ein Token zu wechseln, melde dich ab oder lösche es im Dock (oder lösche die Datei) und verbinde dich erneut.

Cloud-Anmeldedaten liegen getrennt im Maschinen-Speicher `~/.ai-game-dev/credentials.json`, der mit den anderen AI Game Developer-Tools geteilt wird. Projekt-Schlüssel für Agent-Konfigurationen stehen in `~/.ai-game-dev/project-keys.json`.

Im Terminal listet und ändert `godot-cli configure` die Sichtbarkeit von Tools, Prompts und Resources in der Projektdatei `.godot-mcp/features.json`:

```bash
godot-cli configure ./MyGodotProject --list
godot-cli configure ./MyGodotProject --disable-tools script-delete,script-execute
godot-cli configure ./MyGodotProject --enable-all-tools
```

## Umgebungsvariablen

Umgebungsvariablen überschreiben die gespeicherten Einstellungen, ohne dass eine Datei bearbeitet werden muss, was praktisch für CI, Headless-Läufe und lokale Entwicklung ist. Das Addon liest sie außerdem aus einer `.env`-Datei im Projekt; die Prozessumgebung hat Vorrang vor `.env`.

| Variable | Werte | Zweck |
| --- | --- | --- |
| `GODOT_MCP_CONNECTION_MODE` | `Cloud`, `Custom` | Erzwingt den Verbindungsmodus. Standard `Cloud`. |
| `GODOT_MCP_CLOUD_URL` | URL | Überschreibt die Cloud-Basis-URL. Standard `https://ai-game.dev`. |
| `GODOT_MCP_HOST` | URL | Die Server-URL im Custom-Modus. Standard `http://localhost:8080`. |
| `GODOT_MCP_AUTH_OPTION` | `none`, `oauth`, `token` | Autorisierung im Custom-Modus. |
| `GODOT_MCP_TOKEN` | String | Bearer-Token für den aktiven Modus. Überschreibt den gespeicherten und wird nie zurückgeschrieben. |
| `GODOT_MCP_LOG_LEVEL` | `Trace` bis `None` | Ausführlichkeit der Logs. |
| `GODOT_MCP_CREDENTIALS_DIR` | absoluter Pfad | Einen separaten Credential-Store verwenden, für isolierte Tests. |
| `GODOT_MCP_TOOL_FORMAT` | `Rql`, `Json` | Wie Tools Argumente annehmen und Ergebnisse zurückgeben. Standard `Rql` (kompakter Text); `Json` behält JSON-Schemas und Ergebnisse bei. |
| `GODOT_MCP_SERVER_PATH` | absoluter Pfad | Nur im Editor: diese vorhandene Server-Binary starten, statt den festgelegten Release herunterzuladen. |
| `GODOT_MCP_RUNTIME_FROM_EDITOR` | `1` | Lässt auch ein mit Play gestartetes Spiel seine eigene In-Game-MCP-Runtime verbinden. |

Beispiel: den Editor gegen einen lokalen Server starten.

```bash
export GODOT_MCP_CONNECTION_MODE=Custom
export GODOT_MCP_HOST=http://localhost:8080
godot --editor --path ./MyGodotProject
```

`godot-cli open` setzt diese für dich mit `--mode`, `--url`, `--cloud-url`, `--token`, `--auth` und `--log-level`. Siehe die [godot-cli-Referenz](https://ai-game.dev/de/docs/wiki/godot/cli#open).

## Tool-Format

Mit dem Standardformat `Rql` nehmen Tools RQL-Werte als Argumente (einen Node-Pfad wie `"Level/Player"` oder `godot.find("Name")`) und geben kompakten Text zurück, der weniger Tokens kostet. Das Format `Json`, gesetzt mit `GODOT_MCP_TOOL_FORMAT=Json` oder dem Schlüssel `toolFormat`, behält vollständige JSON-Schemas und strukturierte Ergebnisse für Clients, die diese bevorzugen. Mehr zu RQL: [Tools](https://ai-game.dev/de/docs/wiki/godot/tools#rql).

---

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

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