Pe scurt
În Roblox Studio deschide Assistant, apasă … > Manage MCP Servers și pornește Enable Studio as MCP server. Apoi conectează un client. Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI, Visual Studio Code și Antigravity au în acest panou Quick connect cu un singur comutator. Orice alt client cu suport stdio poate folosi configurația JSON sau comanda pe care le documentează Roblox.
- Indicatorul verde din același panou arată câți clienți sunt conectați. Dacă al tău nu a apărut, repornește și Studio, și clientul.
- ChatGPT nu e în lista de conectare rapidă, iar Roblox nu documentează configurarea ChatGPT. Căile OpenAI documentate de Roblox sunt Codex CLI prin MCP (OpenAI oferă pentru el Sign in with ChatGPT) sau o cheie API OpenAI în Assistant. OpenAI documentează și adăugarea serverelor locale în aplicația desktop ChatGPT în modul Codex, pe care Roblox nu o are în listă.
- Un client conectat poate edita scripturi, rula Luau, insera asset-uri și porni playtesturi în orice place deschis. Salvează mai întâi o versiune și conectează doar clienți în care ai încredere.
Pe această pagină
Ce face serverul MCP din Studio
MCP (Model Context Protocol) este un standard deschis care le permite instrumentelor AI să comunice cu alte aplicații. Roblox a integrat un server MCP în Studio. Când e pornit, un client AI de pe computerul tău poate explora place-ul deschis, poate citi și scrie scripturi, poate rula Luau și poate testa jocul în modul de joc, totul prin instrumentele pe care le oferă serverul.
Serverul rulează ca un proces local pe computerul tău și comunică cu clientul prin stdio (intrarea și ieșirea standard). Singur nu face nimic: fiecare acțiune începe cu o cerere a clientului, iar clientul decide ce instrument apelează. Ai nevoie de ultima versiune de Roblox Studio și de clientul MCP dorit, ambele pe același computer.
Două moduri de a folosi Claude sau GPT cu Studio
| Serverul MCP din Studio | Assistant cu cheia API proprie | |
|---|---|---|
| Unde scrii | În clientul AI, de exemplu Claude Desktop, Claude Code sau Cursor | În panoul Assistant din Studio |
| Ce configurezi | Pornești serverul în Studio, apoi conectezi clientul | Assistant > … > Manage API Keys, apoi alegi modelul |
| Modele | Cele pe care le folosește clientul tău | Anthropic, OpenAI sau Google Gemini |
| De ce ai nevoie | Clientul și autentificarea lui proprie | O cheie API de la acel furnizor |
| Cine acționează în Studio | Clientul tău, prin instrumentele MCP | Assistant, pe modelul ales |
Acest ghid este despre prima cale. Dacă vrei doar un model Claude sau OpenAI care să răspundă în Studio, a doua cale e mai scurtă: obține o cheie API de la furnizor, deschide Assistant, apasă … > Manage API Keys, alege furnizorul, lipește cheia și alege modelul din lista Model.
Pasul 1: pornește serverul MCP în Studio
- Deschide Roblox Studio și deschide un place. Dacă Studio îți propune o actualizare, instaleaz-o mai întâi: serverul are nevoie de ultima versiune.
- Apasă Assistant în dreapta sus în Studio (partea dreaptă a barei mezzanine) ca să deschizi fereastra Assistant.
- Apasă … și alege Manage MCP Servers.
- Pornește Enable Studio as MCP server.
Acum panoul arată opțiunea Quick connect și instrucțiuni de configurare pentru diferiți clienți. Nu-l închide: îți trebuie la pasul următor, iar în el apare indicatorul de conectare.
Dacă butonul Assistant lipsește sau fereastra nu se deschide, vezi cum deschizi panoul Assistant (în engleză).
Pasul 2: conectează un client AI
Roblox dă trei moduri de conectare, în această ordine: quick connect, dacă clientul tău e în listă, configurația JSON, dacă clientul citește fișiere de configurare MCP, și comanda CLI pentru clienții care au nevoie de ea.
Quick connect
Quick connect suportă șapte clienți (după lista de la 30 septembrie 2026): Antigravity, Codex CLI, Claude Code, Claude Desktop, Cursor, Gemini CLI și Visual Studio Code.
- În panoul de la pasul 1 (Assistant Settings > MCP Servers) deschide lista Quick connect. În ea sunt clienții suportați instalați pe computerul tău.
- Pornește clientul dorit.
- Dacă clientul nu e în listă, instalează-l și repornește Roblox Studio. Dacă l-ai instalat cu Studio deschis, poate fi nevoie să repornești Studio, clientul sau pe amândouă.
Configurare pe clienți
| Client | Cale | Note |
|---|---|---|
| Claude Desktop (Anthropic) | Quick connect | Aplicația desktop. Roblox nu descrie folosirea Claude în browserul web. |
| Claude Code (Anthropic) | Quick connect | Ghidul Roblox despre coding harness îl folosește ca extensie Visual Studio Code, cu autentificare prin contul Anthropic. |
| Cursor | Quick connect | Asistentul AI e integrat. Autentifică-te cu contul Cursor. |
| Visual Studio Code | Quick connect | Îți trebuie o extensie AI, de exemplu Claude Code. |
| Codex CLI (OpenAI) | Quick connect | Clientul OpenAI din lista Roblox. Documentația Codex de la OpenAI oferă Sign in with ChatGPT la prima pornire. |
| Gemini CLI (Google) | Quick connect | |
| Antigravity | Quick connect | |
| Orice alt client cu suport stdio | Configurație JSON sau comandă CLI | Vezi secțiunea următoare. Termină configurarea după documentația clientului, apoi repornește-l. |
| ChatGPT | Nedocumentat | Nu e în lista quick connect. OpenAI documentează o cale prin aplicația desktop ChatGPT în modul Codex; vezi se poate conecta ChatGPT la Roblox Studio. |
Ghidul Roblox despre coding harness combină conexiunea MCP cu un editor: Cursor sau Visual Studio Code cu o extensie precum Claude Code. Dacă vrei ca agentul să scrie cod și ca fișiere, nu doar să controleze Studio, vezi secțiunea Script Sync și Git de mai jos.
Alți clienți: configurație JSON sau comandă CLI
Serverul funcționează cu orice client care suportă transportul stdio. Dacă al tău nu are quick connect, adaugă Roblox Studio în configurația lui MCP. Mai jos sunt configurațiile complete pe care le documentează Roblox. Dacă Roblox Studio e singurul tău server MCP, folosește-le așa cum sunt.
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
Unde se află fișierul de configurare depinde de client (în exemplul Roblox se numește mcp.json). Instrucțiunile Roblox spun să termini configurarea după documentația clientului, apoi să repornești clientul ca să preia schimbările.
Comanda CLI
Unii clienți acceptă o comandă în locul unui fișier de configurare. Iată comanda care pornește serverul; înregistreaz-o așa cum descrie documentația clientului tău:
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
Amândouă indică un fișier pe care îl instalează Studio. În Windows, %LOCALAPPDATA% este folderul local de date ale aplicațiilor al utilizatorului tău. În macOS, calea merge în interiorul RobloxStudio.app din /Applications. Dacă fișierul lipsește, clientul nu va putea porni serverul: vezi rezolvarea problemelor.
Pasul 3: verifică conexiunea
- În Studio deschide Assistant și apasă … > Manage MCP Servers.
- Sub Enable Studio as MCP server caută indicatorul verde. El arată numărul de clienți conectați.
- În client începe cu o cerere care doar citește, ca o configurare greșită să nu schimbe nimic. De exemplu: Folosind instrumentele Roblox Studio MCP, enumeră ce se află în Workspace. Nu schimba nimic.
Pe un Baseplate proaspăt, răspunsul trebuie să enumere obiectele standard Camera, Terrain, Baseplate și SpawnLocation. Clientul poate cere să aprobi apelul unui instrument sau poate propune să adaugi instrumentul în lista celor permise. Pentru acest test ajunge să aprobi o dată.
Se poate conecta ChatGPT la Roblox Studio?
ChatGPT din browserul web nu: serverul MCP din Studio e un program local, iar OpenAI spune că ChatGPT pe web nu citește fișierele locale de configurare Codex. Calea documentată de Roblox este Codex CLI, în care te poți autentifica cu contul ChatGPT. La 11 octombrie 2026 pagina MCP a Roblox nu descrie configurarea ChatGPT, iar ChatGPT nu e în lista quick connect. Iată ce acoperă fiecare cale.
- Documentat de Roblox: Codex CLI, agentul de cod în consolă al OpenAI, este un client quick connect. Configurează-l ca pe ceilalți la pasul 2. Documentația Codex de la OpenAI oferă Sign in with ChatGPT la prima pornire, așa că acesta e cel mai apropiat mod documentat de a aduce un cont ChatGPT în Studio. Partea Codex, inclusiv setarea de aprobări cu care Codex întreabă înainte să folosească instrumentele Studio, e descrisă în ghidul cum folosești OpenAI Codex cu Roblox Studio (în engleză).
- Documentat de Roblox: Assistant acceptă o cheie API OpenAI. Deschide Assistant, apasă … > Manage API Keys, alege OpenAI, lipește cheia și alege modelul. Assistant va folosi acest model în Studio.
- Documentat de OpenAI, dar nu de Roblox: aplicația desktop ChatGPT în modul Codex. Pagina MCP a OpenAI spune că aplicația desktop poate adăuga un server STDIO local în Settings > MCP servers > Add server și împarte această configurație cu Codex CLI. OpenAI nu spune dacă chaturile obișnuite ChatGPT pot folosi serverul. Roblox nu include aplicația desktop în quick connect, iar noi nu am testat-o, așa că socotește asta neconfirmat. Comanda necesară e descrisă în secțiunea comanda CLI.
Poți în continuare să copiezi cod dintr-un chat ChatGPT într-un Script, dar pe această cale nimic nu îți citește place-ul și nu verifică rezultatul în Studio. Ghidul despre AI în Roblox Studio compară variantele una lângă alta.
Ce instrumente îi dă serverul clientului
Roblox enumeră 26 de instrumente în opt grupe (la 30 septembrie 2026). Pe care să-l apeleze alege clientul; tu nu le apelezi de mână. Fiecare apel poartă un studio_id, care indică fereastra Studio țintă.
| Grupă | Instrumente | Ce fac |
|---|---|---|
| Scripturi | script_read, multi_edit, script_search, script_grep | Citesc un script după o cale de tipul game.ServerScriptService.MyScript, întreg sau pe un interval de linii. Aplică mai multe editări odată și creează scriptul dacă nu există calea. Caută scripturi după nume (până la 10 rezultate) sau text în toate scripturile (până la 50 de potriviri). |
| Modelul de date | search_game_tree, inspect_instance, subagent | Parcurg ierarhia de obiecte cu filtre și limită de adâncime, citesc toate proprietățile și atributele disponibile ale unui obiect sau predau munca în mai mulți pași unui subagent explore sau playtest. |
| Rularea Luau | execute_luau | Rulează Luau în Studio în modelul de date Edit, Client sau Server și returnează rezultatul sau eroarea. |
| Playtesturi | get_studio_state, start_stop_play, get_console_output, screen_capture | Verifică starea jocului, pornesc sau opresc un playtest, citesc jurnalul Output și captează viewportul ca imagine. |
| Inputul jucătorului | character_navigation, user_keyboard_input, user_mouse_input | Mută personajul spre o poziție sau un obiect și trimit apăsări de taste, text, clicuri și derulare. |
| Asset-uri și generare | generate_mesh, generate_material, generate_procedural_model, wait_job_finished, search_asset, insert_asset, upload_image, store_image | Generează meshuri, materiale și modele procedurale din text. Caută în Creator Store și în inventarele tale și inserează un asset după ID. Încarcă imagini de la un URL în Roblox sau iau o imagine locală ca referință. |
| Documentație și abilități | http_get, skill | Încarcă pagini de pe site-urile permise ale documentației Roblox și materiale de referință pentru sarcini precum depanarea și simularea dispozitivelor. |
| Sesiuni | list_roblox_studios | Enumeră ferestrele Studio conectate, cu nume, ID-uri de instanță Studio și ID-uri de place. |
Două tipuri de instrumente merită atenție. Primul, cele care schimbă: multi_edit și execute_luau schimbă place-ul direct, insert_asset aduce conținut extern după ID-ul asset-ului, iar upload_image trimite imagini pe serverul de asset-uri Roblox. Al doilea, instrumentele de playtest, cu care agentul își verifică munca: referința Roblox pentru StudioTestService spune că start_stop_play pornește o singură sesiune Play Client, iar instrumentele de input controlează personajul cât timp ea rulează.
Roblox mai trece prin server și alte funcții Studio: datele Scene Analysis prin SceneAnalysisService, analiza MicroProfiler, controlul Device Simulator și o abilitate AI care trece jocul pe streaming.
Lucrul cu mai multe ferestre Studio
Un singur client se poate conecta la mai multe ferestre Studio pornite deodată. Pentru că fiecare apel își numește ținta prin studio_id, agentul trebuie să știe la ce fereastră te referi. Poate apela list_roblox_studios ca să vadă numele, ID-ul de instanță Studio și ID-ul de place al fiecărei ferestre. Place-urile locale fără ID sunt enumerate doar după nume, iar când două ferestre au același nume, le deosebește ID-ul de place.
În practică: numește place-ul în prompt și închide place-urile care nu trebuie atinse. Serverul poate ajunge la orice place deschis, nu doar la cel la care te uiți.
Lucrează în siguranță: copie de rezervă, aprobări, verificare
Avertismentul Roblox e scurt: clienții MCP pot citi și schimba conținutul place-urilor deschise, așa că conectează doar clienți în care ai încredere. Cu instrumente care rulează cod, inserează asset-uri și pornesc playtesturi, o singură instrucțiune înțeleasă greșit poate face pagube reale. Aceste obiceiuri fac totul recuperabil.
- Salvează o versiune înainte de fiecare sesiune. File > Save to Roblox with Notes (Ctrl+Alt+S sau Cmd+Option+S pe Mac) creează un punct de control cu nume. Ca să revii, deschide Window > Version History, apasă ⋮ lângă versiune, alege Open Local Copy, apoi în copie File > Save to Roblox As ca s-o restaurezi peste place. File > Save to File salvează în plus o copie pe computer.
- Nu te baza pe Ctrl+Z. Pagina MCP a Roblox nu spune dacă editările clientului ajung în istoricul de undo al Studio, așa că drumul înapoi este versiunea salvată.
- Lucrează într-o copie de test, nu în jocul live. Cu Enable Studio Access to API Services pornit (File > Experience Settings > Security), Studio citește și scrie aceleași data stores ca jocul live, iar Roblox recomandă să pornești asta doar într-o versiune de test separată. Asta privește și codul pe care îl rulează agentul, și playtesturile pe care le pornește.
- Păstrează aprobările pentru instrumentele care schimbă. Să permiți instrumente de citire precum
script_readșisearch_game_treee aproape sigur. Aprobămulti_edit,execute_luau,insert_assetșiupload_imageapel cu apel, până ajungi să ai încredere în proces. - Verifică înainte să păstrezi. Citește scripturile schimbate, verifică în Explorer obiectele noi sau dispărute și testează singur. Playtestul agentului arată ce a decis el să verifice, nu tot ce va face un jucător.
Pentru proiecte mari: Script Sync și Git
Ghidul Roblox despre coding harness combină conexiunea MCP cu încă două părți. Script Sync leagă serviciile Studio de foldere de pe disc, ca editorul și agentul să lucreze cu fișiere .luau care apar în Studio ca scripturi, iar Git dă acestui cod un istoric la care poți reveni. Fă commit la o stare curată înainte să-i ceri agentului ceva mare.
Script Sync acoperă scripturile din serviciile legate; conexiunea MCP acoperă în continuare ce nu atinge el, de exemplu StarterGui, playtesturile și Output. Configurarea pas cu pas, împreună cu Rojo ca alternativă, e în ghidul cum folosești Cursor sau VS Code cu Roblox Studio, iar versiunea pentru Claude Code în ghidul cum folosești Claude Code cu Roblox Studio (amândouă în engleză).
Rezolvarea problemelor: când clientul nu se conectează
Lista de verificare Roblox are trei puncte: repornește și Studio, și clientul, verifică dacă calea spre comandă sau fișier e corectă și fișierul există și verifică sintaxa JSON. Iată situațiile din spatele lor.
Nu găsesc Manage MCP Servers
Actualizează Roblox Studio la ultima versiune, apoi deschide Assistant în dreapta sus în Studio și apasă …. Manage MCP Servers e în acest meniu.
Clientul meu nu e în lista Quick connect
Lista arată doar clienții suportați instalați pe computer. Instalează clientul, apoi repornește Studio. Dacă nu e dintre cei șapte suportați, folosește configurația JSON sau comanda CLI.
Clientul nu arată instrumente Roblox sau scrie că serverul nu a pornit
Verifică dacă fișierul din configurație există: %LOCALAPPDATA%\Roblox\mcp.bat în Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP în macOS. Dacă Studio nu e instalat pe Mac-ul tău în /Applications, corectează calea. Apoi repornește clientul, ceea ce, după Roblox, e necesar ca schimbările de configurație să se aplice, și repornește Studio.
Fișierul de configurare nu se mai încarcă după ce am adăugat Roblox Studio
O virgulă lipsă între două intrări din mcpServers sau o acoladă în plus fac fișierul JSON invalid și îl împiedică să se încarce. Verifică fișierul cu un validator JSON, corectează linia indicată și repornește clientul.
În Studio nu există indicatorul verde
Clientul nu s-a conectat. Verifică faptul că Enable Studio as MCP server e încă pornit și că ai repornit clientul după ce ai adăugat serverul, apoi repornește și Studio, și clientul.
Agentul a schimbat alt place
Cu mai multe ferestre Studio deschise, clientul alege ținta după studio_id. Cere-i să apeleze list_roblox_studios și numește place-ul dorit sau închide celelalte ferestre. Place-ul schimbat restaurează-l din Version History.
Clientul cere permisiune la fiecare pas
Acesta e clientul tău, nu Studio. Roblox notează că poate fi nevoie să aprobi o comandă sau să adaugi un instrument MCP în lista celor permise. Permite instrumentele doar de citire dacă cererile te încurcă și continuă să le aprobi pe cele care schimbă place-ul.
Sau sari peste configurarea MCP: RoCode
RoCode (RoCode.app) este o altă cale și nu e un produs MCP. Este un agent AI independent pentru Roblox Studio: descrii schimbarea în chatul web de pe rocode.app, iar pluginul gratuit RoCode din Creator Store execută pașii în place-ul deschis. Nu există fișier de configurare, linie de comandă sau server MCP de configurat. Îi permiți pluginului HTTP și Script Injection în Studio. Apoi pluginul se conectează singur, dacă Studio e autentificat în același cont Roblox ca RoCode; altfel legi o singură dată chatul și pluginul cu un cod de 8 caractere din panoul pluginului.
Compromisurile, direct. RoCode nu poate conecta un abonament Claude, Claude Code sau ChatGPT. Rulează modele terțe prin OpenRouter, sub numele lor proprii: GPT-6 Luna pe orice plan, GLM 5.3 Flash și Claude Sonnet 5.5 cu Pro, Claude Opus 5.5 cu Studio și GPT-6 Astra pe Ultra. Cu pluginul 3.9 sau mai nou poate porni un playtest scurt și poate citi erorile, iar cu 3.9.11 sau mai nou poate controla un personaj de test. Cu pluginul 3.9.14 sau mai nou mai face și o captură a ce a construit în modul de editare și poate corecta ce arată greșit. Nu rulează cod direct și nu generează meshuri, iar instrumentele Studio MCP de mai sus știu asta. Caută modele gratuite în Creator Store după cuvintele tale (scripturile din ele sunt eliminate) sau inserează un model, un decal sau un mesh după ID-ul asset-ului și gândește de la zero decorul, clădirile și recuzita pentru fiecare joc. Planul gratuit Starter include 1 credit pe zi. Comparația cu alte instrumente: cele mai bune AI pentru Roblox Studio.
Tocmai am testat jocul și am primit o eroare în RoundManager. Găsește cauza și repar-o.
- Citește Output-ul playtestului tău prin Check Output, inclusiv liniile Server și Client, apoi deschide scriptul în jurul acelei linii prin Read Script
- Repară codul stricat pe loc prin Edit Script, în fereastra Studio conectată
- Verifică scriptul în Studio prin Check Script înainte să termine. Este o verificare de compilare, nu o verificare de tipuri și nici un playtest
- Trimite schimbările în grupuri, iar fiecare grup este un punct de undo în istoricul Studio însuși
RoCode verifică doar ce a decis să verifice, așa că apasă singur Play și joacă o rundă ca să te asiguri de reparație. Cum funcționează pluginul și asocierea. RoCode este un produs independent, fără legătură cu Roblox Corporation și neaprobat de ea.
Întrebări frecvente
Serverul MCP din Roblox Studio e gratuit?
E integrat în Roblox Studio, iar documentația Roblox despre MCP nu menționează nici plată, nici înregistrare. Modelul AI vine prin clientul tău, așa că limitele și costul le stabilește contul sau planul clientului.
Pot folosi ChatGPT cu serverul MCP din Roblox Studio?
Nu ChatGPT pe web, la 11 octombrie 2026: nu poate porni serverul local Studio. Calea OpenAI documentată de Roblox este Codex CLI, în care te poți autentifica cu contul ChatGPT. OpenAI documentează și servere locale în aplicația desktop ChatGPT în modul Codex, pe care Roblox nu o are în listă și pe care noi nu am testat-o. Cealaltă cale este o cheie API OpenAI în Assistant prin Manage API Keys.
Am nevoie de o cheie API ca să conectez Claude la Roblox Studio?
Pentru MCP, nu. În configurarea Roblox nu există un pas cu cheie API, iar clientul folosește autentificarea lui obișnuită: ghidul despre coding harness se autentifică în Claude Code cu contul Anthropic. O cheie API îți trebuie doar pentru cealaltă cale, modelele Claude în Assistant prin Manage API Keys.
Poate AI-ul să-mi testeze jocul prin MCP?
Da. start_stop_play pornește și oprește un playtest, get_console_output citește Output, screen_capture captează viewportul, iar instrumentele de input mută personajul și trimit taste și clicuri. Subagentul playtest poate rula un scenariu de joc și verifica rezultatul. Înainte de publicare, joacă și tu.
Serverul MCP din Studio merge pe Mac?
Da. Roblox documentează o configurație pentru macOS care indică /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, alături de configurația pentru Windows.
Surse și lecturi suplimentare
- Roblox Creator Docs: Connect to the Roblox Studio MCP server (în engleză). pornirea serverului, quick connect, JSON și CLI, lista instrumentelor, mai multe ferestre Studio și rezolvarea problemelor
- Roblox Developer Forum: Studio MCP Server Updates and External LLM Support for Assistant (în engleză). cheie API proprie Anthropic, OpenAI sau Google în Assistant
- Roblox Creator Docs: Build with a coding harness (în engleză). Script Sync, MCP cu Cursor sau Visual Studio Code și Git
- Roblox Creator Docs: Version History (în engleză). salvarea cu note și restaurarea unei versiuni anterioare
- Roblox Creator Docs: Data stores (în engleză). de ce accesul Studio la API services trebuie folosit doar într-o copie de test
- Roblox Engine API: StudioTestService (în engleză)
- OpenAI: Codex CLI (în engleză). autentificarea în Codex CLI, inclusiv Sign in with ChatGPT
- OpenAI: Model Context Protocol (în engleză). servere STDIO locale în aplicația desktop ChatGPT în modul Codex
- Model Context Protocol: Introduction (în engleză). standardul deschis pe care îl implementează serverul Studio