KI-Clients verbinden

Godot MCP hat zwei Seiten, die sich beide mit einem MCP-Server verbinden: das Addon im Godot-Editor und der KI-Client, mit dem du chattest. Diese Seite erklärt die beiden Verbindungsmodi, wie die Anmeldung funktioniert und wie du die MCP-Konfiguration für jeden unterstützten Agenten mit godot-cli setup-mcp oder der Schaltfläche Configure im Dock schreibst.

Cloud-Modus (Standard)#

Im Cloud-Modus verbindet sich das Addon mit dem gehosteten Backend unter https://ai-game.dev, und dein KI-Client verbindet sich mit dem MCP-Endpunkt https://ai-game.dev/mcp. Auf deinem Rechner läuft nichts zusätzlich, und es funktioniert über Firewalls hinweg. Dies ist der Standardmodus und der, den wir den meisten empfehlen.

Anmelden mit dem Device-Flow#

Die Cloud-Authentifizierung nutzt den OAuth-2.1-Device-Authorization-Flow. Du kopierst nie einen Token von Hand:

godot-cli login

Die CLI gibt einen kurzen Code aus, öffnet deinen Browser und wartet, bis du ihn bestätigst. Der Zugangsnachweis (Access-Token, rotierender Refresh-Token und Ablaufzeit) wird im Speicher des Rechners unter ~/.ai-game-dev/credentials.json gespeichert (Dateimodus 0600 unter macOS und Linux, DPAPI-geschützt unter Windows). Das Editor-Addon, die anderen Engine-CLIs und die AI Game Dev App übernehmen ihn, und abgelaufene Access-Tokens werden automatisch erneuert. Ein Klick auf Authorize im Dock führt denselben Ablauf direkt in Godot aus.

Nützliche login-Flags: --force meldet sich erneut an und überschreibt einen vorhandenen Zugangsnachweis, --project <path> hält einen separaten Zugangsnachweis pro Projekt, und --tools-only erstellt einen eingeschränkteren Zugangsnachweis für CI-Runner. Siehe die godot-cli-Referenz und Authentifizierung.

Fest zugeordnete Projekt-URLs#

Der einfache Endpunkt https://ai-game.dev/mcp leitet deinen Agenten zu einem deiner verbundenen Editoren. Das ist mehrdeutig, wenn mehrere Projekte geöffnet sind, daher schreibt setup-mcp standardmäßig eine fest zugeordnete URL: https://ai-game.dev/mcp/p/<pin>, wobei der Pin aus dem Projekt abgeleitet wird. Ein mit dieser Konfiguration gestarteter Agent erreicht immer den Editor dieses Projekts. Übergib --no-pin, wenn du die einfache URL willst.

Projektschlüssel#

Wenn du angemeldet bist, setzt setup-mcp einen Projektschlüssel als Authorization: Bearer agd_pk_… in die Agenten-Konfiguration. Ein Projektschlüssel läuft nicht ab und funktioniert nur für den Pin dieses Projekts, kann also nicht auf andere Projekte in deinem Konto zugreifen. Er wird einmal pro Projekt erstellt und aus ~/.ai-game-dev/project-keys.json wiederverwendet.

• --regenerate-key erstellt einen neuen Schlüssel, schreibt die Konfiguration neu und widerruft den alten Schlüssel.
• --oauth schreibt stattdessen eine reine URL-Konfiguration: Der Agent meldet sich über seine eigene OAuth-Abfrage an.
• Ohne Anmeldung auf dem Rechner ist die Konfiguration ebenfalls nur eine URL.

Custom-Modus: dein eigener Server#

Im Custom-Modus verbindet sich das Addon mit einer Server-URL deiner Wahl, zum Beispiel einem Server auf deinem eigenen Rechner. Der Server ist der Open-Source-GameDev-MCP-Server, dieselbe Binärdatei, die auch Unity MCP und Unreal MCP verwenden.

Am einfachsten lässt du das Addon ihn starten:

1. Stelle im Dock den Modus auf Custom.
2. Lass Server URL auf http://localhost:8080 oder gib eine andere lokale URL ein.
3. Klicke auf Start Server. Das Addon lädt den Server-Build für seine festgelegte Server-Version von GitHub herunter (HTTPS, nur github.com), legt ihn in .godot/mcp-server/<platform>/ ab, startet ihn und verbindet sich.

Stop Server stoppt ihn, und das Schließen des Editors stoppt ihn ebenfalls. In CI-Umgebungen werden Downloads übersprungen. Wenn du stattdessen selbst einen Server betreiben willst, lade eine Release-Binärdatei oder das Docker-Image aigamedeveloper/mcp-server herunter:

./gamedev-mcp-server --client-transport streamableHttp --port 8080

Autorisierung für einen eigenen Server#

Der Custom-Modus hat einen Schalter Authorization Token mit drei Werten:

Bei jedem nicht-lokalen Host mit oauth weigert sich das Addon, deinen Konto-Token zu senden; setze stattdessen GODOT_MCP_TOKEN. Die Umgebungsvariablen für beide Modi sind unter Konfiguration aufgeführt.

Um einen Agenten auf einen lokalen Server zu richten, übergib die URL an setup-mcp:

godot-cli setup-mcp claude-code ./MyGodotProject --url http://localhost:8080

Eine Konfiguration für einen lokalen Server enthält nie einen Projektschlüssel.

Unterstützte Agenten und Konfigurationsdateien#

Führe godot-cli setup-mcp --list aus, um alle Agent-IDs zu sehen. Dies sind die IDs, die die aktuelle CLI kennt, und wo sie die Konfiguration ablegt:

Beispiele:

godot-cli setup-mcp cursor ./MyGodotProject
godot-cli setup-mcp codex ./MyGodotProject
godot-cli setup-mcp vscode-copilot ./MyGodotProject --oauth

Jede Konfiguration nutzt den HTTP-Transport (type: http und eine URL). Bei Codex landet der Schlüssel in http_headers.

Claude Desktop und claude.ai#

Claude Desktop übernimmt keinen HTTP-Server-Eintrag aus claude_desktop_config.json. Stattdessen erreichen Claude Desktop und claude.ai den Cloud-Endpunkt als benutzerdefinierten Claude-Connector: Füge in den Einstellungen von Claude einen benutzerdefinierten Connector hinzu, füge die gepinnte Cloud-URL des Projekts ein und melde dich mit deinem ai-game.dev-Konto an. Claude Desktop kann keinen Server im Custom-Modus verwenden, da Godot MCP dafür keinen stdio-Transport bietet. Für einen lokalen Server verwende einen Agenten aus der Tabelle, der HTTP unterstützt, etwa Claude Code.

Aus dem Dock konfigurieren#

Der Abschnitt AI agent im Dock erledigt dieselbe Aufgabe wie setup-mcp: Wähle deinen Agenten aus der Liste und klicke dann auf Configure (oder Reconfigure). Die Statuszeile zeigt an, ob die Konfigurationsdatei des Agenten eingerichtet ist, und ein Hinweis Reconfiguration Required erscheint, wenn du nach dem Konfigurieren die Server-URL, den Modus oder die Autorisierung änderst. Remove löscht den Godot MCP-Eintrag aus der Konfiguration dieses Agenten.

Skills für deinen Agenten#

Einige Agenten lesen Skill-Dateien (SKILL.md), die ihnen den Umgang mit den Tools beibringen. Die Zeile Skills im Dock, innerhalb des Abschnitts AI agent, kann sie erzeugen (Generate oder der Schalter Auto-generate). Aus einem Terminal:

godot-cli setup-skills claude-code ./MyGodotProject

Dabei werden die Dateien in den Skills-Ordner des Agenten geschrieben, etwa .claude/skills für Claude Code, ohne dass ein Editor laufen muss. setup-skills --list zeigt, welche Agenten Skills unterstützen.

Konfigurationen zum Kopieren#

Wenn dein Client nicht in der Liste steht, funktioniert jeder MCP-Client, der HTTP-Server unterstützt: Richte ihn auf https://ai-game.dev/mcp (oder die gepinnte URL) aus und lass ihn sich per OAuth anmelden, oder füge einen Bearer-Header hinzu. Fertige Snippets für viele Clients findest du auf der MCP-Endpunkt-Seite.