Diese Seite wurde maschinell aus dem Englischen übersetzt. Englisches Original lesen.

Konfiguration

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

Aktualisiert am 4. November 2026 Als Markdown anzeigen

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; 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.

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.

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.

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:

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.

VariableWerteZweck
GODOT_MCP_CONNECTION_MODECloud, CustomErzwingt den Verbindungsmodus. Standard Cloud.
GODOT_MCP_CLOUD_URLURLÜberschreibt die Cloud-Basis-URL. Standard https://ai-game.dev.
GODOT_MCP_HOSTURLDie Server-URL im Custom-Modus. Standard http://localhost:8080.
GODOT_MCP_AUTH_OPTIONnone, oauth, tokenAutorisierung im Custom-Modus.
GODOT_MCP_TOKENStringBearer-Token für den aktiven Modus. Überschreibt den gespeicherten und wird nie zurückgeschrieben.
GODOT_MCP_LOG_LEVELTrace bis NoneAusführlichkeit der Logs.
GODOT_MCP_CREDENTIALS_DIRabsoluter PfadEinen separaten Credential-Store verwenden, für isolierte Tests.
GODOT_MCP_TOOL_FORMATRql, JsonWie Tools Argumente annehmen und Ergebnisse zurückgeben. Standard Rql (kompakter Text); Json behält JSON-Schemas und Ergebnisse bei.
GODOT_MCP_SERVER_PATHabsoluter PfadNur im Editor: diese vorhandene Server-Binary starten, statt den festgelegten Release herunterzuladen.
GODOT_MCP_RUNTIME_FROM_EDITOR1Lässt auch ein mit Play gestartetes Spiel seine eigene In-Game-MCP-Runtime verbinden.

Beispiel: den Editor gegen einen lokalen Server starten.

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.

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.