# Godot MCP — AI Game Developer Wiki

Godot MCP verbindet Claude, Cursor, Copilot und andere KI-Agenten mit dem Godot-Editor: Installation, Einrichtung, Tools, Erweiterungen und CLI.

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

Godot MCP ist das Godot-Addon von AI Game Developer. Es ermöglicht einem KI-Agenten wie Claude Code, Cursor, GitHub Copilot, Codex oder Gemini, direkt im Godot-Editor zu arbeiten: den Scene Tree abfragen und bearbeiten, `.tscn`-Szenen öffnen und speichern, `.tres`-Ressourcen und Projekteinstellungen ändern, C#- und GDScript-Dateien lesen und schreiben, das C#-Projekt bauen, C#-Snippets im Editor ausführen und Screenshots aufnehmen, die sich das Modell ansehen kann. Dieses Wiki erklärt, wie du es installierst, einen KI-Client verbindest und es im Alltag nutzt.

## Was Godot MCP ist

Godot MCP ist ein C#-Editor-Addon (der Ordner `addons/godot_mcp/`, in den Project Settings als **Godot-MCP** angezeigt), das in einem Godot 4 .NET-Projekt läuft. Wenn der Editor es lädt, öffnet das Addon ein Dock namens **AI Game Developer** und verbindet sich mit einem MCP-Server. Der KI-Agent, mit dem du chattest, verbindet sich mit demselben Server und ruft die Tools des Addons über das Model Context Protocol (MCP) auf.

Das Addon ist Open Source (Apache-2.0) und liegt im [Godot-MCP-Repository](https://github.com/IvanMurzak/Godot-MCP). Es teilt seine MCP- und Reflection-Bibliotheken mit Unity MCP und Unreal MCP, sodass sich die drei Engine-Plugins gleich verhalten und dasselbe Cloud-Konto verwenden.

## Wie die Teile zusammenwirken

| Teil | Was es macht |
| --- | --- |
| Godot MCP Addon | Läuft im Godot-Editor, stellt die KI-Tools bereit und verbindet sich mit einem MCP-Server. |
| MCP-Server | Der Cloud-Server unter [ai-game.dev](https://ai-game.dev) (Standard) oder ein eigener Server auf deinem Rechner. |
| KI-Client | Claude Code, Cursor, VS Code Copilot, Codex, Gemini oder ein anderer MCP-Client. Er verbindet sich mit demselben Server. |
| `godot-cli` | Das npm-Kommandozeilentool, das das Addon installiert, dich anmeldet, KI-Client-Konfigurationen schreibt und den Editor öffnet. |
| AI Game Dev App | Die Desktop-App, die das Addon installieren und den Editor für dich öffnen kann – ganz ohne Terminal. |

Im standardmäßigen Cloud-Modus läuft auf deinem Rechner nichts außer Godot und deinem KI-Client: Editor und Agent verbinden sich beide mit dem gehosteten Endpoint, und du meldest dich einmal mit deinem ai-game.dev-Konto an. Im Custom-Modus kann das Addon einen lokalen MCP-Server für dich herunterladen und starten, sodass alles auf deinem Computer bleibt.

## Voraussetzungen auf einen Blick

- Der **.NET-(Mono-)Build von Godot 4.3 oder neuer**. Der reine GDScript-Standard-Build kann das Addon nicht kompilieren.
- Das **.NET 8 SDK**.
- Ein Godot-Projekt mit einer `.csproj` für C#. Dein eigener Spielcode kann weiterhin GDScript sein; das Addon braucht das C#-Projekt nur, um sich selbst zu kompilieren.
- Ein KI-Client, der MCP spricht.

Die vollständige Liste, inklusive der NuGet-Pakete, die deine `.csproj` benötigt, findest du unter [Installation](https://ai-game.dev/de/docs/wiki/godot/installation).

## Schnellstart

Wenn du dich mit dem Terminal wohlfühlst, bringen diese Befehle ein Godot-C#-Projekt von null auf einen verbundenen KI-Agenten:

```bash
npm install -g godot-cli
godot-cli install-plugin ./MyGodotProject
godot-cli login
godot-cli setup-mcp claude-code ./MyGodotProject
godot-cli open ./MyGodotProject
```

Danach bittest du deinen Agenten um etwas wie „Erstelle eine Node3D-Szene mit einer Camera3D und einem MeshInstance3D-Würfel und speichere sie als Main.tscn“. Die Seite [Getting started](https://ai-game.dev/de/docs/wiki/godot/getting-started) geht dieselben Schritte mit Erklärungen durch, und der [Quickstart](https://ai-game.dev/de/docs/quickstart) der Website deckt alle drei Engines ab.

## Seiten in diesem Wiki

- [Installation](https://ai-game.dev/de/docs/wiki/godot/installation): alle Installationswege (Desktop-App, `godot-cli`, Asset Library, Release-Zip) und die genauen NuGet-Pakete.
- [Getting started](https://ai-game.dev/de/docs/wiki/godot/getting-started): erste Verbindung, erste Prompts und wie du prüfst, ob alles funktioniert.
- [KI-Clients verbinden](https://ai-game.dev/de/docs/wiki/godot/connecting-ai-clients): Cloud-Endpoint vs. eigener Server, die Geräte-Anmeldung, Projektschlüssel und `setup-mcp` für jeden Agenten.
- [Konfiguration](https://ai-game.dev/de/docs/wiki/godot/configuration): das AI Game Developer Dock, gespeicherte Einstellungen und die Umgebungsvariablen `GODOT_MCP_*`.
- [Tools](https://ai-game.dev/de/docs/wiki/godot/tools): die eingebauten Tool-Familien, RQL und wofür jedes Tool gedacht ist.
- [Eigene Tools](https://ai-game.dev/de/docs/wiki/godot/custom-tools): eigene MCP-Tools in C# schreiben und Tools aus einem laufenden Spiel bereitstellen.
- [Erweiterungen](https://ai-game.dev/de/docs/wiki/godot/extensions): optionale Pakete für Animation, CSG, Navigation, Tilemaps und beliebte Godot-Addons.
- [godot-cli-Referenz](https://ai-game.dev/de/docs/wiki/godot/cli): jeder `godot-cli`-Befehl und seine Flags.
- [Fehlerbehebung](https://ai-game.dev/de/docs/wiki/godot/troubleshooting): das Addon lädt nicht, der Agent sieht keine Tools, Probleme beim Neuladen.
- [FAQ](https://ai-game.dev/de/docs/wiki/godot/faq): kurze Antworten auf häufige Fragen.

## Mehr auf der Website

- [Godot MCP installieren](https://ai-game.dev/de/engines/godot): die Godot-Installationsseite.
- [Godot-Tool-Katalog](https://ai-game.dev/docs/tools/godot) und [Godot-Erweiterungen](https://ai-game.dev/docs/extensions/godot).
- [Best Practices für Godot](https://ai-game.dev/docs/best-practices/godot): wie du Prompts schreibst, die gut funktionieren.
- [MCP-Endpunkt](https://ai-game.dev/de/mcp-endpoint-info) und [Authentifizierung](https://ai-game.dev/docs/auth): der gehostete Endpunkt und wie die Anmeldung funktioniert.
- Das [Wiki zur AI Game Dev App](https://ai-game.dev/de/docs/wiki/app) sowie die Wikis für [Unity MCP](https://ai-game.dev/de/docs/wiki/unity) und [Unreal MCP](https://ai-game.dev/de/docs/wiki/unreal).

- [**Installation** Installiere das Godot-MCP-Addon per AI Game Dev App, godot-cli, Asset Library oder Release-Zip – inklusive der NuGet-Pakete für deine .csproj.](https://ai-game.dev/de/docs/wiki/godot/installation)
- [**Erste Schritte** 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.](https://ai-game.dev/de/docs/wiki/godot/getting-started)
- [**KI-Clients verbinden** Verbinde Claude Code, Cursor, Copilot, Codex, Gemini und weitere MCP-Clients über die ai-game.dev-Cloud oder einen lokalen Server mit Godot MCP.](https://ai-game.dev/de/docs/wiki/godot/connecting-ai-clients)
- [**Konfiguration** Godot MCP im AI Game Developer-Dock einrichten, Tools für KI-Agenten wählen und Einstellungen per GODOT\_MCP\_\*-Umgebungsvariablen überschreiben.](https://ai-game.dev/de/docs/wiki/godot/configuration)
- [**Tools** Die Godot-MCP-Tools für KI-Agenten im Godot-Editor: RQL für Nodes, Szenen und Ressourcen, C#- und GDScript-Skripte, Screenshots, In-Game-Tools.](https://ai-game.dev/de/docs/wiki/godot/tools)
- [**Eigene Tools** Eigene Godot-MCP-Tools in C# schreiben, API-Aufrufe im Main Thread ausführen und Tools, Prompts und Ressourcen im laufenden Spiel bereitstellen.](https://ai-game.dev/de/docs/wiki/godot/custom-tools)
- [**Erweiterungen** Optionale MCP-Erweiterungen für Godot: AnimationPlayer, CSG, GridMap, Navigation, Partikel, TileMapLayer, Beehave, Dialogic, Phantom Camera, Terrain3D.](https://ai-game.dev/de/docs/wiki/godot/extensions)
- [**godot-cli-Referenz** Alle godot-cli-Befehle und -Flags für Godot MCP – von install-plugin, login und setup-mcp bis open, exec, run-tool, configure und install-extension.](https://ai-game.dev/de/docs/wiki/godot/cli)
- [**Fehlerbehebung** Häufige Godot-MCP-Probleme beheben: Addon lädt oder kompiliert nicht, leere Extensions-Liste, fehlende Tools, Reload-Fehler und .NET 10-Abstürze.](https://ai-game.dev/de/docs/wiki/godot/troubleshooting)
- [**FAQ** Kurze Antworten zu Godot MCP, dem KI-Assistenten für den Godot-Editor: Versionen, GDScript, Offline-Nutzung, Kosten, Sicherheit und Export.](https://ai-game.dev/de/docs/wiki/godot/faq)

---

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

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