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_read | Liest ein Skript aus dem Spiel mithilfe von Punktnotation-Pfaden (zum Beispiel game.ServerScriptService.MyScript). Unterstützt das Lesen ganzer Skripte oder spezifischer Zeilenbereiche. |
| multi_edit | Wendet 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_search | Durchsucht Skripte nach Namen mithilfe von unscharfer Übereinstimmung. Gibt bis zu 10 Ergebnisse zurück. |
| script_grep | Durchsucht alle Skripte im Spiel nach einem Zeichenmuster. Gibt bis zu 50 Übereinstimmungen zurück. |
| Asset- und Inhaltsgenerierung | |
| generate_mesh | Generiert ein texturiertes 3D-Mesh aus einem Textprompt mithilfe von KI. |
| generate_material | Generiert eine benutzerdefinierte Materialvariante. Gibt das Basismaterial und den Namen der Materialvariante zurück, die auf Teile angewendet werden sollen. |
| generate_procedural_model | Erstellt 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_finished | Wartet, bis ein Job zur Generierung eines prozeduralen Modells abgeschlossen ist, und gibt den endgültigen Status zurück. |
| search_asset | Durchsucht 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_asset | Fü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_image | Lä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_image | Lä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 | |
| subagent | Startet 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_tree | Erforscht die Instanzhierarchie als flaches JSON-Array. Unterstützt die Filterung nach Pfad, Instanztyp und Schlüsselwörtern mit konfigurierbarer Tiefenbegrenzung. |
| inspect_instance | Gibt 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_luau | Fü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_state | Erhält den aktuellen Zustand von Studio, einschließlich des Spielzustands und der verfügbaren Datamodel-Typen. |
| start_stop_play | Startet oder stoppt das Playtesting. |
| get_console_output | Ruft die Ausgabe aus dem Studio-Ausgabelog ab. |
| screen_capture | Erfasst 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_navigation | Bewegt den Spielercharakter zu einer bestimmten Position oder Instanzpfad. Unterstützt einen konfigurierbaren Geschwindigkeitsmultiplikator. |
| user_keyboard_input | Sendet 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_input | Sendet 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_get | Ruft 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. |
| skill | Ruft detailliertes Wissen, bewährte Verfahren oder Referenzmaterial für spezifische Fähigkeiten wie Debugging, Gerätesimulation und Dokumentationssuche ab. |
| Sitzungsmanagement | |
| list_roblox_studios | Listet 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_studio | Setzt 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:
- Öffnen Sie Assistant.
- Klicken Sie auf … ⟩ MCP-Server verwalten.
- 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:
- Gehen Sie zu Assistant-Einstellungen ⟩ MCP-Server.
- Erweitern Sie das Dropdown-Menü Schnellverbindung, um unterstützte Clients anzuzeigen, die auf Ihrem Computer installiert sind.
- 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:
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}{
"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:
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat/Applications/RobloxStudio.app/Contents/MacOS/StudioMCPVerwenden 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:
- Öffnen Sie Assistant.
- Klicken Sie auf … ⟩ MCP-Server verwalten.
- Ü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.