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

Godot MCP

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

Aktualisiert am 4. November 2026 Als Markdown anzeigen

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

TeilWas es macht
Godot MCP AddonLäuft im Godot-Editor, stellt die KI-Tools bereit und verbindet sich mit einem MCP-Server.
MCP-ServerDer Cloud-Server unter ai-game.dev (Standard) oder ein eigener Server auf deinem Rechner.
KI-ClientClaude Code, Cursor, VS Code Copilot, Codex, Gemini oder ein anderer MCP-Client. Er verbindet sich mit demselben Server.
godot-cliDas npm-Kommandozeilentool, das das Addon installiert, dich anmeldet, KI-Client-Konfigurationen schreibt und den Editor öffnet.
AI Game Dev AppDie 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.

Schnellstart

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

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 geht dieselben Schritte mit Erklärungen durch, und der Quickstart der Website deckt alle drei Engines ab.

Seiten in diesem Wiki

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

Mehr auf der Website