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. Sobald die Verbindung hergestellt ist, kann Ihr KI-Client direkt mit Ihrer offenen Studio-Sitzung interagieren, das Datenmodell erkunden, Skripte schreiben, Luau-Code ausführen und Ihr Erlebnis im Spielmodus testen.
Dieser Leitfaden zeigt Ihnen, wie Sie den Studio MCP-Server mit beliebten KI-Clients verbinden. Obwohl die Einrichtung je nach Client variiert, ist die Grundidee dieselbe: Sie konfigurieren Ihren Client, um eine Verbindung zum MCP-Server herzustellen, und senden dann Befehle vom Client an Ihre aktive Studio-Sitzung.
Voraussetzungen
Bevor Sie eine Verbindung zum Server herstellen 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 Gerät 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 Tools:
| Skripte | |
|---|---|
| script_read | Liest ein Skript aus dem Spiel mit Punkt-Notation-Pfaden (zum Beispiel game.ServerScriptService.MyScript). Unterstützt das Lesen ganzer Skripte oder spezifischer Zeilenbereiche. |
| multi_edit | Wendet mehrere Änderungen auf ein 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 Text-Prompt unter Verwendung 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 zusammengesetzt sind. Unterstützt Referenzbilder und benutzerdefinierte Teil-Schemas. |
| wait_job_finished | Wartet, bis ein Auftrag 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-Inventar) nach Assets. Unterstützt das Filtern nach Asset-Typ, Preis, Tags und Umfang. |
| insert_asset | Fügt ein Asset ins Spiel mit seiner numerischen Roblox-Asset-ID ein. Unterstützt Modelle, Meshes, Bilder, Audio, Video, Animationen und Pakete. |
| upload_image | Lädt eine Vielzahl 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). |
| Datenmodellerkundung | |
| subagent | Startet einen spezialisierten Subagenten, um komplexe, mehrstufige Aufgaben autonom zu bewältigen. Verfügbare Typen sind explore (für die Untersuchung des Codes und Spielstandsabfragen) und playtest (für das Ausführen von Spielszenerien und Überprüfen von Ergebnissen). |
| search_game_tree | Erforscht die Instanzhierarchie als flaches JSON-Array. Unterstützt das Filtern nach Pfad, Instanztyp und Schlüsselwörtern, mit konfigurierbarer Tiefenbegrenzung. |
| inspect_instance | Gibt detaillierte Informationen über eine spezifische 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 Spielmodus und verfügbarer Datamodel-Typen. |
| start_stop_play | Startet oder stoppt die Playtesting-Sitzung. |
| get_console_output | Ruft die Ausgabe aus dem Studio-Output-Log ab. |
| screen_capture | Nimmt das aktuelle Studio-Viewport auf und gibt die Bilddaten zurück. Akzeptiert optional eine benutzerdefinierte Kameraposition und ein Ziel zum Ansehen. |
| Spielereingabesimulation | |
| character_navigation | Bewegt den Spielercharakter zu einer bestimmten Position oder Instanzpfad. Unterstützt einen konfigurierbaren Geschwindigkeitsmultiplikator. |
| user_keyboard_input | Sendet eine oder mehrere Tastenaktionen in folgender Reihenfolge: Taste drücken, Taste loslassen, Taste betätigen, Texteingabe oder warten. Unterstützt das Zielen auf spezifische UI-Instanzen. |
| user_mouse_input | Sendet eine oder mehrere Mausaktionen in folgender Reihenfolge: bewegen, klicken, Taste drücken/lösen, scrollen oder warten. Unterstützt das Zielen auf spezifische Instanzen oder Bildschirmkoordinaten. |
| Dokumentation und Fähigkeiten | |
| http_get | Holt Inhalte von zugelassenen Roblox-Dokumentations-URLs (Engine API-Referenz, Creator-Dokumentation, Cloud-API, Leistungsoptimierungsleitfäden). Unterstützt die Schlüsselwortsuche innerhalb der abgerufenen Inhalte. |
| skill | Ruft detailliertes Wissen, bewährte Praktiken oder Referenzmaterial für spezifische Fähigkeiten wie Debugging, Gerätesimulation und Dokumentationssuche ab. |
| Sessionsverwaltung | |
| list_roblox_studios | Listet alle verbundenen Studio-Instanzen auf, einschließlich deren Name, ID und aktiven Status. Nützlich, wenn mehrere Studio-Fenster geöffnet sind. |
| set_active_studio | Legt eine Studio-Instanz als aktiv fest, sodass alle nachfolgenden Tool-Anrufe 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 dies aktiviert ist, wird im Einstellungsfeld die Schnellverbindungsoption und die Einrichtungsanweisungen für verschiedene Clients angezeigt. Wenn ein Client erfolgreich eine Verbindung herstellt, zeigt ein grüner Indikator die Anzahl der verbundenen Clients an.
Verbinden Sie Ihren Client
Sie können Ihren Client über die Schnellverbindung, eine JSON-Konfiguration oder einen CLI-Befehl mit dem Studio MCP-Server verbinden.
- Verwenden Sie Schnellverbindung, wenn Ihr Client unterstützt wird.
- Andernfalls 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. Fügen Sie nach dem Hinzufügen der Konfiguration Ihre Clientdokumentation hinzu, 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 über die Schnellverbindung zu verbinden:
- Gehen Sie zu Assistant Settings ⟩ MCP-Server.
- Klappen Sie das Dropdown-Menü Schnellverbindung aus, um unterstützte Clients anzuzeigen, die auf Ihrem Computer installiert sind.
- Aktivieren Sie Ihren gewählten Client.
Wenn der von Ihnen 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 so wie sie sind. Wenn Sie mehrere MCP-Server verwenden, kopieren Sie den Roblox_Studio-Eintrag und fügen Sie ihn Ihrem bestehenden mcpServers-dictionary hinzu.
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:
Windowscmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat
macOS/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
Verwenden Sie mehrere Studio-Instanzen
Sie können einen einzigen MCP-Client mit mehreren laufenden Studio-Instanzen gleichzeitig verbinden. Der Server bestimmt automatisch, welche Instanz verwendet werden soll, basierend auf dem Kontext (zum Beispiel, wenn Sie auf ein bestimmtes Erlebnis oder ein Objekt verweisen, das nur in dieser Instanz existiert).
Sie können die Instanzen manuell 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 bestätigt, dass sich der Client erfolgreich verbunden hat.
Fehlerbehebung
Wenn der Server nicht angezeigt wird oder die Tools nicht verfügbar sind:
- Starten Sie sowohl Roblox Studio als auch Ihren MCP-Client neu.
- Überprüfen Sie, ob der Befehl oder der Pfad zur Binärdatei korrekt ist und die Datei existiert.
- Überprüfen Sie Ihre JSON-Syntax. Selbst ein fehlendes Komma oder eine fehlende Klammer kann verhindern, dass die Konfiguration geladen wird.