Mit dem Roblox Studio MCP-Server verbinden

*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

Der Roblox Studio MCP-Server ist in Roblox Studio integriert. Er implementiert das Model Context Protocol (MCP), einen offenen Standard, der es KI-Tools ermöglicht, sicher mit externen Anwendungen zu kommunizieren. Nach der Verbindung kann Ihr KI-Client direkt mit Ihrer offenen Studio-Sitzung interagieren, das Datenmodell erkunden, Skripte schreiben, Luau-Code ausführen und Ihr Spiel im Spielmodus testen.

Diese Anleitung zeigt Ihnen, wie Sie den Studio MCP-Server mit beliebten KI-Clients verbinden. Während die Einrichtung je nach Client variiert, bleibt die Grundidee gleich: Sie konfigurieren Ihren Client, um sich mit dem MCP-Server zu verbinden, und senden dann Befehle vom Client an Ihre aktive Studio-Sitzung.

Voraussetzungen

Bevor Sie sich mit dem Server verbinden können, stellen Sie sicher, dass Sie die neueste Version von Roblox Studio und Ihren bevorzugten MCP-Client auf Ihrem Computer installiert haben.

Wie der Studio MCP-Server funktioniert

Der Server läuft als lokaler Prozess auf Ihrem Computer und kommuniziert mit dem KI-Client über stdio-Transport, der Standard-Eingabe-/Ausgabeströme verwendet. Alle Aktionen werden über Ihren KI-Client initiiert, der dann eine Anfrage über diesen Kanal sendet, um Aktionen innerhalb Ihrer Studio-Sitzung auszuführen.

Der Server bietet die folgenden Werkzeuge:

Skripte
script_readLiest ein Skript aus dem Spiel mithilfe von Punktnotation-Pfaden (zum Beispiel game.ServerScriptService.MyScript). Unterstützt das Lesen ganzer Skripte oder spezifischer Zeilenbereiche.
multi_editWendet mehrere Änderungen an einem Skript in einem Vorgang an. Wenn der Zielpfad nicht existiert, wird ein neues Skript erstellt. Erfordert die Angabe eines datamodel_type (Edit).
script_searchDurchsucht Skripte nach Namen mithilfe von unscharfer Übereinstimmung. Gibt bis zu 10 Ergebnisse zurück.
script_grepDurchsucht alle Skripte im Spiel nach einem Zeichenmuster. Gibt bis zu 50 Übereinstimmungen zurück.
Asset- und Inhaltsgenerierung
generate_meshGeneriert ein texturiertes 3D-Mesh aus einem Textprompt mithilfe von KI.
generate_materialGeneriert eine benutzerdefinierte Materialvariante. Gibt das Basismaterial und den Namen der Materialvariante zurück, die auf Teile angewendet werden sollen.
generate_procedural_modelErstellt 3D-Objekte, die aus primitiven Teilen (Blöcke, Kugeln, Zylinder, Keile) als ProceduralModel mit konfigurierbaren Attributen bestehen. Unterstützt Referenzbilder und benutzerdefinierte Teil-Schemas.
wait_job_finishedWartet, bis ein Job zur Generierung eines prozeduralen Modells abgeschlossen ist, und gibt den endgültigen Status zurück.
search_assetDurchsucht die Creator Store (öffentlicher Marktplatz) und das Creator Inventory (Benutzer-, Gruppen- oder Universum). Unterstützt die Filterung nach Asset-Typ, Preis, Tags und Umfang.
insert_assetFügt ein Asset in das Spiel ein, indem es die numerische Roblox-Asset-ID verwendet. Unterstützt Modelle, Meshes, Bilder, Audio, Video, Animationen und Pakete.
upload_imageLädt eine Batch von Bildern von HTTP-URLs auf den Roblox-Asset-Server hoch und gibt eine Bildpfad-zu-Asset-ID-Karte zurück.
store_imageLädt ein Bild von einem lokalen Dateipfad und gibt eine Bild-URI zurück, die an andere Tools übergeben werden kann (zum Beispiel als Referenzbild für generate_procedural_model).
Datenmodell-Erkundung
subagentStartet einen spezialisierten Subagenten, um komplexe, mehrstufige Aufgaben autonom zu bearbeiten. Verfügbare Typen sind explore (für Codebasisuntersuchungen und Abfragen des Spielstatus) und playtest (für das Ausführen von Spielszenarien und Überprüfen von Ergebnissen).
search_game_treeErforscht die Instanzhierarchie als flaches JSON-Array. Unterstützt die Filterung nach Pfad, Instanztyp und Schlüsselwörtern mit konfigurierbarer Tiefenbegrenzung.
inspect_instanceGibt detaillierte Informationen über eine bestimmte Instanz zurück, einschließlich aller lesbaren Eigenschaften, benutzerdefinierten Attribute und einer Zusammenfassung ihrer Kinder und Nachkommen.
Luau-Ausführung
execute_luauFührt Luau-Code in Studio aus. Gibt entweder das Ergebnis oder einen Fehler zurück. Erfordert die Angabe eines datamodel_type (Edit, Client oder Server).
Playtesting
get_studio_stateErhält den aktuellen Zustand von Studio, einschließlich des Spielzustands und der verfügbaren Datamodel-Typen.
start_stop_playStartet oder stoppt das Playtesting.
get_console_outputRuft die Ausgabe aus dem Studio-Ausgabelog ab.
screen_captureErfasst den aktuellen Studio-Viewport und gibt die Bilddaten zurück. Akzeptiert optional eine benutzerdefinierte Kameraposition und ein Ziel, auf das geschaut werden soll.
Spielereingabesimulation
character_navigationBewegt den Spielercharakter zu einer bestimmten Position oder Instanzpfad. Unterstützt einen konfigurierbaren Geschwindigkeitsmultiplikator.
user_keyboard_inputSendet eine oder mehrere Tastatureingaben in der Reihenfolge: Taste gedrückt, Taste losgelassen, Taste gedrückt, Texteingabe oder warten. Unterstützt das Zielen auf spezifische UI-Instanzen.
user_mouse_inputSendet eine oder mehrere Mausklicks in der Reihenfolge: bewegen, klicken, Taste gedrückt/losgelassen, scrollen oder warten. Unterstützt das Zielen auf spezifische Instanzen oder Bildschirmkoordinaten.
Dokumentation und Fähigkeiten
http_getRuft Inhalte von erlaubten Roblox-Dokumentations-URLs ab (Engine API-Referenz, Creator-Dokumente, Cloud-API, Leistungsoptimierungsleitfäden). Unterstützt die Schlüsselwortsuche innerhalb der abgerufenen Inhalte.
skillRuft detailliertes Wissen, bewährte Verfahren oder Referenzmaterial für spezifische Fähigkeiten wie Debugging, Gerätesimulation und Dokumentationssuche ab.
Sitzungsmanagement
list_roblox_studiosListet alle verbundenen Studio-Instanzen auf, einschließlich ihres Namens, ihrer ID und ihres aktiven Status. Dies ist nützlich, wenn mehrere Studio-Fenster geöffnet sind.
set_active_studioSetzt eine Studio-Instanz als aktiv, sodass alle nachfolgenden Toolaufrufe auf diese Instanz abzielen.

Aktivieren Sie den MCP-Server in Studio

Um den MCP-Server in Studio zu aktivieren:

  1. Öffnen Sie Assistant.
  2. Klicken Sie auf MCP-Server verwalten.
  3. Aktivieren Sie Studio als MCP-Server aktivieren.

Sobald aktiviert, zeigt das Einstellungsfeld die Schnellverbindungsoption und die Einrichtungsanweisungen für verschiedene Clients an. Wenn ein Client erfolgreich verbunden ist, zeigt ein grüner Indikator die Anzahl der verbundenen Clients an.

Verbinden Sie Ihren Client

Sie können Ihren Client mit dem Studio MCP-Server über die Schnellverbindung, eine JSON-Konfiguration oder einen CLI-Befehl verbinden.

  • Verwenden Sie Schnellverbindung, wenn Ihr Client unterstützt wird.
  • Wenn nicht, verwenden Sie eine JSON-Konfiguration, wenn Ihr Client MCP-Konfigurationsdateien unterstützt.
  • Andernfalls verwenden Sie einen CLI-Befehl.

Der Studio MCP-Server funktioniert mit jedem Client, der stdio-Transport unterstützt. Nachdem Sie die Konfiguration hinzugefügt haben, folgen Sie der Dokumentation Ihres Clients, um die Einrichtung abzuschließen, und starten Sie dann den Client neu, um Ihre Änderungen anzuwenden.

Schnellverbindung

Die Schnellverbindung unterstützt die folgenden Clients:

  • Antigravity
  • Codex CLI
  • Claude Code
  • Claude Desktop
  • Cursor
  • Gemini CLI
  • Visual Studio Code

Um sich über die Schnellverbindung zu verbinden:

  1. Gehen Sie zu Assistant-EinstellungenMCP-Server.
  2. Erweitern Sie das Dropdown-Menü Schnellverbindung, um unterstützte Clients anzuzeigen, die auf Ihrem Computer installiert sind.
  3. Aktivieren Sie Ihren gewählten Client.

Wenn der gewünschte Client nicht in der Liste Schnellverbindung angezeigt wird, installieren Sie ihn und starten Sie Roblox Studio neu.

JSON-Konfiguration

Die meisten MCP-Clients unterstützen JSON-Konfigurationsdateien. Die folgenden Beispiele zeigen vollständige Konfigurationen, die Sie verwenden können.

Wenn Roblox Studio Ihr einziger MCP-Server ist, verwenden Sie diese Konfigurationen unverändert. Wenn Sie mehrere MCP-Server verwenden, kopieren Sie den Eintrag Roblox_Studio und fügen Sie ihn Ihrem vorhandenen mcpServers-Dictionary hinzu.

Die Konfigurationen variieren je nach Betriebssystem:

Windows
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
macOS
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}

CLI-Befehl

Einige MCP-Clients erfordern einen CLI-Befehl anstelle einer JSON-Konfiguration. Verwenden Sie den entsprechenden Befehl für Ihr Betriebssystem:

Windows
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat
macOS
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

Verwenden Sie mehrere Studio-Instanzen

Sie können einen einzelnen MCP-Client mit mehreren laufenden Instanzen von Studio gleichzeitig verbinden. Der Server bestimmt automatisch, welche Instanz basierend auf dem Kontext verwendet werden soll (zum Beispiel, wenn Sie auf ein bestimmtes Spiel oder ein Objekt verweisen, das nur in dieser Instanz existiert).

Sie können manuell zwischen Instanzen mit list_roblox_studios und set_active_studio wechseln.

Überprüfen Sie Ihre Verbindung

Nachdem Sie Ihren Client eingerichtet haben, überprüfen Sie, ob die Verbindung in Roblox Studio funktioniert:

  1. Öffnen Sie Assistant.
  2. Klicken Sie auf MCP-Server verwalten.
  3. Überprüfen Sie unter Studio als MCP-Server aktivieren, ob der grüne Indikator anzeigt, dass der Client erfolgreich verbunden ist.

Fehlersuche

Wenn der Server nicht angezeigt wird oder die Werkzeuge nicht verfügbar sind:

  • Starten Sie sowohl Roblox Studio als auch Ihren MCP-Client neu.
  • Überprüfen Sie, ob der Befehl oder der Binärpfad korrekt ist und die Datei existiert.
  • Überprüfen Sie Ihre JSON-Syntax. Selbst ein fehlendes Komma oder eine Klammer kann das Laden der Konfiguration verhindern.
©2026 Roblox Corporation. Roblox, das Roblox-Logo und "Powering Imagination" gehören zu unseren eingetragenen und nicht eingetragenen Markenzeichen in den USA und anderen Ländern.