# KI-Clients verbinden — Godot · AI Game Developer Wiki

Verbinde Claude Code, Cursor, Copilot, Codex, Gemini und weitere MCP-Clients über die ai-game.dev-Cloud oder einen lokalen Server mit Godot MCP.

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

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:

```bash
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](https://ai-game.dev/de/docs/wiki/godot/cli#login) und [Authentifizierung](https://ai-game.dev/docs/auth).

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

**Warnung**

Ein Projektschlüssel ist ein Zugangsnachweis. Committe Konfigurationsdateien, die einen enthalten (zum Beispiel `.mcp.json` oder `.cursor/mcp.json`), nicht in ein öffentliches Repository.

## 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](https://github.com/IvanMurzak/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:

```bash
./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:

| Wert | Bedeutung |
| --- | --- |
| `none` | Keine Authentifizierung. In Ordnung für einen Server, der nur auf deinem eigenen Rechner lauscht. |
| `oauth` | Sendet den Token deines angemeldeten ai-game.dev-Kontos, aber nur an einen localhost-Server (`localhost`, `127.0.0.0/8`, `::1`). |
| `token` | Ein Bearer-Token. Klicke auf **New**, um einen zu generieren; er wird maskiert gespeichert. |

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](https://ai-game.dev/de/docs/wiki/godot/configuration#environment-variables) aufgeführt.

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

```bash
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:

| Agent | id | Konfigurationsdatei |
| --- | --- | --- |
| Claude Code | `claude-code` | `.mcp.json` im Projekt |
| Claude Desktop | `claude-desktop` | Einen benutzerdefinierten Claude-Connector verwenden (siehe unten) |
| Cursor | `cursor` | `.cursor/mcp.json` |
| Visual Studio Code (Copilot) | `vscode-copilot` | `.vscode/mcp.json` |
| Visual Studio (Copilot) | `vs-copilot` | `.vs/mcp.json` |
| Rider (Junie) | `rider-junie` | `.junie/mcp/mcp.json` |
| GitHub Copilot CLI | `github-copilot-cli` | `~/.copilot/mcp-config.json` |
| Gemini | `gemini` | `.gemini/settings.json` |
| Antigravity | `antigravity` | `~/.gemini/config/mcp_config.json` und `~/.gemini/antigravity/mcp_config.json` |
| Cline | `cline` | `cline_mcp_settings.json` im globalen Speicher von VS Code |
| Open Code | `open-code` | `opencode.json` |
| Codex | `codex` | `.codex/config.toml` |
| Kilo Code | `kilo-code` | `.kilocode/mcp.json` |
| Jeder andere MCP-Client | `custom` | `mcp.json` im Projekt |

Beispiele:

```bash
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:

```bash
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](https://ai-game.dev/de/mcp-endpoint-info).

---

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

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