Накратко
В Roblox Studio отвори Assistant, натисни … > Manage MCP Servers и включи Enable Studio as MCP server. После свържи клиента. Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI, Visual Studio Code и Antigravity имат в този панел Quick connect с един превключвател. Всеки друг клиент с поддръжка на stdio може да използва JSON конфигурацията или командата, които документира Roblox.
- Зеленият индикатор в същия панел показва колко клиента са свързани. Ако твоят не се е появил, рестартирай и Studio, и клиента.
- ChatGPT го няма в списъка за бързо свързване и Roblox не документира настройка за ChatGPT. Документираните от Roblox пътища за OpenAI са Codex CLI през MCP (OpenAI предлага за него Sign in with ChatGPT) или API ключ на OpenAI в Assistant. OpenAI документира и добавяне на локални сървъри в десктоп приложението ChatGPT в режим Codex, което Roblox не е включил в списъка.
- Свързаният клиент може да редактира скриптове, да изпълнява Luau, да вмъква асети и да пуска плейтестове във всеки отворен плейс. Първо запази версия и свързвай само клиенти, на които вярваш.
На тази страница
Какво прави MCP сървърът на Studio
MCP (Model Context Protocol) е отворен стандарт, който позволява на ИИ инструментите да общуват с други приложения. Roblox е вградил MCP сървър в Studio. Когато е включен, ИИ клиент на твоя компютър може да разглежда отворения плейс, да чете и пише скриптове, да изпълнява Luau и да тества играта в режим на игра, всичко това чрез инструментите, които дава сървърът.
Сървърът работи като локален процес на твоя компютър и общува с клиента през stdio (стандартния вход и изход). Сам по себе си той не прави нищо: всяко действие започва със заявка от клиента и клиентът решава кой инструмент да извика. Трябват ти последната версия на Roblox Studio и подходящ MCP клиент, и двата на един компютър.
Два начина да използваш Claude или GPT със Studio
| MCP сървърът на Studio | Assistant със собствен API ключ | |
|---|---|---|
| Къде пишеш | В ИИ клиент, например Claude Desktop, Claude Code или Cursor | В панела Assistant в Studio |
| Какво настройваш | Включваш сървъра в Studio, после свързваш клиента | Assistant > … > Manage API Keys, после избираш модел |
| Модели | Тези, които използва клиентът ти | Anthropic, OpenAI или Google Gemini |
| Какво ти трябва | Клиентът и неговият собствен вход | API ключ от този доставчик |
| Кой действа в Studio | Твоят клиент, чрез инструментите на MCP | Assistant, с избрания модел |
Това ръководство е за първия път. Ако ти трябва само модел на Claude или OpenAI, който отговаря в Studio, вторият път е по-кратък: вземи API ключ от доставчика, отвори Assistant, натисни … > Manage API Keys, избери доставчика, постави ключа и избери модел в списъка Model.
Стъпка 1: включи MCP сървъра в Studio
- Отвори Roblox Studio и отвори плейс. Ако Studio предлага обновяване, първо го инсталирай: сървърът изисква последната версия.
- Натисни Assistant горе вдясно в Studio (дясната част на лентата mezzanine), за да отвориш прозореца на Assistant.
- Натисни … и избери Manage MCP Servers.
- Включи Enable Studio as MCP server.
Сега панелът показва опцията Quick connect и инструкции за настройка на различни клиенти. Не го затваряй: трябва ти за следващата стъпка и в него се появява индикаторът за връзка.
Ако няма бутон Assistant или прозорецът не се отваря, виж как да отвориш панела на Assistant (на английски).
Стъпка 2: свържи ИИ клиента
Roblox дава три начина за свързване, в този ред: quick connect, ако клиентът ти е в списъка, JSON конфигурация, ако клиентът чете конфигурационни файлове за MCP, и CLI команда за клиентите, на които тя трябва.
Quick connect
Quick connect поддържа седем клиента (по списъка към 30 септември 2026 г.): Antigravity, Codex CLI, Claude Code, Claude Desktop, Cursor, Gemini CLI и Visual Studio Code.
- В панела от стъпка 1 (Assistant Settings > MCP Servers) разгъни списъка Quick connect. В него са поддържаните клиенти, инсталирани на компютъра ти.
- Включи нужния клиент.
- Ако клиентът не е в списъка, инсталирай го и рестартирай Roblox Studio. Ако си го инсталирал при отворено Studio, може да се наложи да рестартираш Studio, клиента или и двете.
Настройка по клиенти
| Клиент | Път | Бележки |
|---|---|---|
| Claude Desktop (Anthropic) | Quick connect | Десктоп приложение. Roblox не описва използване на Claude в уеб браузър. |
| Claude Code (Anthropic) | Quick connect | Ръководството на Roblox за coding harness го използва като разширение за Visual Studio Code с вход чрез акаунт в Anthropic. |
| Cursor | Quick connect | ИИ асистентът е вграден. Влез с акаунт в Cursor. |
| Visual Studio Code | Quick connect | Трябва ИИ разширение, например Claude Code. |
| Codex CLI (OpenAI) | Quick connect | Клиентът на OpenAI в списъка на Roblox. Документацията на Codex от OpenAI предлага Sign in with ChatGPT при първото стартиране. |
| Gemini CLI (Google) | Quick connect | |
| Antigravity | Quick connect | |
| Всеки друг клиент с поддръжка на stdio | JSON конфигурация или CLI команда | Виж следващия раздел. Завърши настройката по документацията на клиента, после го рестартирай. |
| ChatGPT | Не е документирано | Няма го в списъка за quick connect. OpenAI документира път през десктоп приложението ChatGPT в режим Codex; виж може ли ChatGPT да се свърже с Roblox Studio. |
Ръководството на Roblox за coding harness съчетава MCP връзката с редактор: Cursor или Visual Studio Code с разширение като Claude Code. Ако искаш агентът да пише код и във файлове, а не само да управлява Studio, виж раздела Script Sync и Git по-долу.
Други клиенти: JSON конфигурация или CLI команда
Сървърът работи с всеки клиент, който поддържа транспорта stdio. Ако твоят няма quick connect, добави Roblox Studio в неговата MCP конфигурация. По-долу са пълните конфигурации, които документира Roblox. Ако Roblox Studio е единственият ти MCP сървър, използвай ги както са.
{
"mcpServers": {
"Roblox_Studio": {
"command": "cmd.exe",
"args": [
"/c",
"%LOCALAPPDATA%\\Roblox\\mcp.bat"
]
}
}
}
{
"mcpServers": {
"Roblox_Studio": {
"command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
}
}
}
Къде е конфигурационният файл, зависи от клиента (в примера на Roblox той се казва mcp.json). Инструкциите на Roblox казват да завършиш настройката по документацията на клиента, после да рестартираш клиента, за да приеме промените.
CLI команда
Някои клиенти приемат команда вместо конфигурационен файл. Ето командата, която пуска сървъра; регистрирай я така, както описва документацията на клиента ти:
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP
И двете сочат към файл, който инсталира Studio. В Windows %LOCALAPPDATA% е локалната папка с данни на приложенията за твоя потребител. В macOS пътят е вътре в RobloxStudio.app в /Applications. Ако файлът го няма, клиентът няма да може да пусне сървъра: виж решаване на проблеми.
Стъпка 3: провери връзката
- В Studio отвори Assistant и натисни … > Manage MCP Servers.
- Под Enable Studio as MCP server намери зеления индикатор. Той показва броя на свързаните клиенти.
- В клиента започни със заявка, която само чете, за да не промени нищо една грешна настройка. Например: Използвайки инструментите на Roblox Studio MCP, изброй какво има в Workspace. Не променяй нищо.
На нов Baseplate отговорът трябва да изброи стандартните Camera, Terrain, Baseplate и SpawnLocation. Клиентът може да те помоли да одобриш извикването на инструмента или да предложи да добавиш инструмента в списъка с разрешени. За този тест е достатъчно да одобриш веднъж.
Може ли ChatGPT да се свърже с Roblox Studio?
ChatGPT в уеб браузъра не може: MCP сървърът на Studio е локална програма, а OpenAI казва, че ChatGPT в уеб не чете локалните конфигурационни файлове на Codex. Документираният от Roblox път е Codex CLI, в който можеш да влезеш с акаунт в ChatGPT. Към 11 октомври 2026 г. страницата за MCP на Roblox не описва настройка на ChatGPT и ChatGPT го няма в списъка за quick connect. Ето какво покрива всеки път.
- Документирано от Roblox: Codex CLI, конзолният агент на OpenAI за код, е клиент за quick connect. Настрой го като останалите в стъпка 2. Документацията на Codex от OpenAI предлага Sign in with ChatGPT при първото стартиране, затова това е най-близкият документиран начин да вкараш акаунт в ChatGPT в Studio. Страната на Codex, включително настройката на одобренията, при която Codex пита, преди да използва инструментите на Studio, е описана в ръководството как да използваш OpenAI Codex с Roblox Studio (на английски).
- Документирано от Roblox: Assistant приема API ключ на OpenAI. Отвори Assistant, натисни … > Manage API Keys, избери OpenAI, постави ключа и избери модел. Assistant ще използва този модел в Studio.
- Документирано от OpenAI, но не от Roblox: десктоп приложението ChatGPT в режим Codex. Страницата за MCP на OpenAI казва, че десктоп приложението може да добави локален STDIO сървър в Settings > MCP servers > Add server и споделя тази конфигурация с Codex CLI. OpenAI не казва дали обикновените чатове в ChatGPT могат да използват сървъра. Roblox не включва десктоп приложението в quick connect и ние не сме го тествали, затова го приемай за непотвърдено. Нужната команда е описана в раздела CLI команда.
Да копираш код от чат в ChatGPT в Script все още може, но по този път нищо не чете плейса ти и не проверява резултата в Studio. Ръководството за ИИ в Roblox Studio сравнява вариантите един до друг.
Какви инструменти дава сървърът на клиента
Roblox изброява 26 инструмента в осем групи (към 30 септември 2026 г.). Кой да се извика, избира клиентът; ти не ги извикваш ръчно. Всяко извикване носи studio_id, който посочва целевия прозорец на Studio.
| Група | Инструменти | Какво правят |
|---|---|---|
| Скриптове | script_read, multi_edit, script_search, script_grep | Четат скрипт по път като game.ServerScriptService.MyScript, целия или по диапазон от редове. Прилагат няколко редакции наведнъж и създават скрипт, ако пътят не съществува. Търсят скриптове по име (до 10 резултата) или текст във всички скриптове (до 50 съвпадения). |
| Модел на данните | search_game_tree, inspect_instance, subagent | Обхождат йерархията на обектите с филтри и ограничение на дълбочината, четат всички достъпни свойства и атрибути на един обект или предават многостъпкова работа на субагента explore или playtest. |
| Изпълнение на Luau | execute_luau | Изпълнява Luau в Studio в модела на данните Edit, Client или Server и връща резултата или грешката. |
| Плейтестове | get_studio_state, start_stop_play, get_console_output, screen_capture | Проверяват състоянието на играта, пускат или спират плейтест, четат журнала Output и снимат изгледа като изображение. |
| Вход от играча | character_navigation, user_keyboard_input, user_mouse_input | Движат персонажа към позиция или обект и пращат натискания на клавиши, текст, кликове и скролване. |
| Асети и генериране | generate_mesh, generate_material, generate_procedural_model, wait_job_finished, search_asset, insert_asset, upload_image, store_image | Генерират мешове, материали и процедурни модели по текст. Търсят в Creator Store и в инвентарите ти и вмъкват асет по ID. Качват изображения от URL в Roblox или вземат локално изображение като образец. |
| Документация и умения | http_get, skill | Зареждат страници от разрешените сайтове с документация на Roblox и справочни материали за задачи като отстраняване на грешки и симулиране на устройства. |
| Сесии | list_roblox_studios | Изброяват свързаните прозорци на Studio с имената им, ID на инстанциите на Studio и ID на плейсовете. |
Два вида инструменти заслужават внимание. Първият са тези, които променят: multi_edit и execute_luau променят плейса директно, insert_asset внася външно съдържание по ID на асет, а upload_image праща изображения към сървъра за асети на Roblox. Вторият са инструментите за плейтест, с които агентът проверява работата си: справката на Roblox за StudioTestService казва, че start_stop_play пуска една сесия Play Client, а инструментите за вход управляват персонажа, докато тя върви.
Roblox пуска през сървъра и други функции на Studio: данни от Scene Analysis чрез SceneAnalysisService, анализ с MicroProfiler, управление на Device Simulator и ИИ умение, което прехвърля играта на стрийминг.
Работа с няколко прозореца на Studio
Един клиент може да се свърже с няколко отворени прозореца на Studio наведнъж. Тъй като всяко извикване посочва целта чрез studio_id, агентът трябва да знае кой прозорец имаш предвид. Той може да извика list_roblox_studios, за да види името, ID на инстанцията на Studio и ID на плейса на всеки прозорец. Локалните плейсове без ID се изброяват само по име, а когато два прозореца имат едно и също име, ги различава ID на плейса.
На практика: назовавай плейса в промпта и затваряй плейсовете, които не бива да се засягат. Сървърът може да стигне до всеки отворен плейс, а не само до този, който гледаш.
Работи безопасно: резервно копие, одобрения, проверка
Предупреждението на Roblox е кратко: MCP клиентите могат да четат и променят съдържанието на отворените плейсове, затова свързвай само клиенти, на които вярваш. С инструменти, които изпълняват код, вмъкват асети и пускат плейтестове, една погрешно разбрана инструкция може да направи истинска поразия. Тези навици правят всичко възстановимо.
- Запазвай версия преди всяка сесия. File > Save to Roblox with Notes (Ctrl+Alt+S или Cmd+Option+S на Mac) създава контролна точка с име. За да се върнеш, отвори Window > Version History, натисни ⋮ до версията, избери Open Local Copy, после в копието File > Save to Roblox As, за да я възстановиш върху плейса. File > Save to File допълнително запазва копие на компютъра.
- Не разчитай на Ctrl+Z. Страницата за MCP на Roblox не казва дали редакциите на клиента влизат в историята за отмяна на Studio, затова пътят назад е запазената версия.
- Работи в тестово копие, а не в живата игра. С включено Enable Studio Access to API Services (File > Experience Settings > Security) Studio чете и пише в същите хранилища за данни като живата игра и Roblox съветва да го включваш само в отделна тестова версия. Това се отнася и за кода, който изпълнява агентът, и за плейтестовете, които пуска.
- Остави одобренията за инструментите, които променят. Да разрешиш инструменти за четене като
script_readиsearch_game_treeе почти безопасно. Одобрявайmulti_edit,execute_luau,insert_assetиupload_imageизвикване по извикване, докато не започнеш да вярваш на процеса. - Проверявай, преди да запазиш. Прочети променените скриптове, провери Explorer за нови или изчезнали обекти и тествай сам. Плейтестът на агента показва това, което той е решил да провери, а не всичко, което ще направи играчът.
За големи проекти: Script Sync и Git
Ръководството на Roblox за coding harness съчетава MCP връзката с още две части. Script Sync свързва услугите на Studio с папки на диска, за да работят редакторът и агентът с файлове .luau, които се появяват в Studio като скриптове, а Git дава на този код история, която може да се върне назад. Прави commit на чисто състояние, преди да поискаш от агента нещо голямо.
Script Sync покрива скриптовете в свързаните услуги; MCP връзката продължава да покрива това, до което той не стига, например StarterGui, плейтестовете и Output. Настройката стъпка по стъпка, заедно с Rojo като алтернатива, е в ръководството как да използваш Cursor или VS Code с Roblox Studio, а версията за Claude Code е в ръководството как да използваш Claude Code с Roblox Studio (и двете на английски).
Решаване на проблеми: когато клиентът не се свързва
Чеклистът на Roblox има три точки: рестартирай и Studio, и клиента, провери дали пътят до командата или файла е верен и файлът съществува, и провери синтаксиса на JSON. Ето ситуациите зад тях.
Не мога да намеря Manage MCP Servers
Обнови Roblox Studio до последната версия, после отвори Assistant горе вдясно в Studio и натисни …. Manage MCP Servers е в това меню.
Моят клиент го няма в списъка Quick connect
Списъкът показва само поддържаните клиенти, инсталирани на компютъра. Инсталирай клиента, после рестартирай Studio. Ако не е от седемте поддържани, използвай JSON конфигурация или CLI команда.
Клиентът не показва инструменти на Roblox или пише, че сървърът не е стартирал
Провери дали файлът от конфигурацията съществува: %LOCALAPPDATA%\Roblox\mcp.bat в Windows, /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP в macOS. Ако Studio на твоя Mac не е инсталиран в /Applications, поправи пътя. После рестартирай клиента, което според Roblox е нужно, за да се приложат промените в конфигурацията, и рестартирай Studio.
Конфигурационният файл спря да се зарежда след добавянето на Roblox Studio
Пропусната запетая между два записа в mcpServers или излишна скоба правят файла невалиден JSON и не му дават да се зареди. Провери файла с JSON валидатор, поправи посочения ред и рестартирай клиента.
В Studio няма зелен индикатор
Клиентът не се е свързал. Провери дали Enable Studio as MCP server все още е включено и дали си рестартирал клиента след добавянето на сървъра, после рестартирай и Studio, и клиента.
Агентът промени грешния плейс
При няколко отворени прозореца на Studio клиентът избира целта по studio_id. Помоли го да извика list_roblox_studios и назови нужния плейс или затвори другите прозорци. Възстанови променения плейс от Version History.
Клиентът иска разрешение на всяка стъпка
Това е твоят клиент, а не Studio. Roblox отбелязва, че може да се наложи да одобриш команда или да добавиш инструмента на MCP в списъка с разрешени. Разреши инструментите само за четене, ако заявките пречат, и продължавай да одобряваш тези, които променят плейса.
Или пропусни настройката на MCP: RoCode
RoCode (RoCode.app) е друг път и не е MCP продукт. Това е независим ИИ агент за Roblox Studio: описваш промяната в уеб чата на rocode.app, а безплатният плъгин RoCode от Creator Store изпълнява стъпките в отворения плейс. Няма конфигурационен файл, команден ред или MCP сървър за настройване. Разрешаваш на плъгина HTTP и Script Injection в Studio. После плъгинът се свързва сам, ако Studio е влязъл в същия акаунт в Roblox като RoCode; иначе веднъж свързваш чата и плъгина с код от 8 знака от панела на плъгина.
Компромисите казани направо. RoCode не може да свърже абонамент за Claude, Claude Code или ChatGPT. Той пуска външни модели през OpenRouter под собствените им имена: GPT-6 Luna на всеки план, GLM 5.3 Flash и Claude Sonnet 5.5 с Pro, Claude Opus 5.5 със Studio и GPT-6 Astra на Ultra. С плъгин 3.9 или по-нов може да пусне кратък плейтест и да прочете грешките, а с 3.9.11 или по-нов да управлява тестов персонаж. С плъгин 3.9.14 или по-нов освен това снима построеното в режим на редактиране и може да поправи това, което изглежда грешно. Той не изпълнява код директно и не генерира мешове, а инструментите на Studio MCP по-горе могат това. Търси безплатни модели в Creator Store по твоите думи (скриптовете в тях се махат) или вмъква модел, декал или меш по ID на асета и измисля декора, сградите и реквизита наново за всяка игра. Безплатният план Starter включва 1 кредит на ден. Сравнение с други инструменти: най-добрите ИИ за Roblox Studio.
Току-що тествах играта и получих грешка в RoundManager. Намери причината и я поправи.
- Чете Output на плейтеста ти чрез Check Output, включително редовете Server и Client, после отваря скрипта около този ред чрез Read Script
- Поправя счупения код на място чрез Edit Script, в свързания прозорец на Studio
- Проверява скрипта в Studio чрез Check Script, преди да приключи. Това е проверка на компилацията, а не проверка на типовете и не плейтест
- Праща промените на групи и всяка група е точка за отмяна в историята на самото Studio
RoCode проверява само това, което е решил да провери, затова натисни Play сам и изиграй един рунд, за да се увериш в поправката. Как работят плъгинът и сдвояването. RoCode е независим продукт, който не е свързан с Roblox Corporation и не е одобрен от нея.
Често задавани въпроси
Безплатен ли е MCP сървърът на Roblox Studio?
Той е вграден в Roblox Studio и документацията на Roblox за MCP не споменава нито такса, нито регистрация. ИИ моделът идва през клиента ти, затова лимитите и цената се определят от акаунта или плана на клиента.
Може ли да използвам ChatGPT с MCP сървъра на Roblox Studio?
Не ChatGPT в уеб, към 11 октомври 2026 г.: той не може да пусне локалния сървър на Studio. Документираният от Roblox път за OpenAI е Codex CLI, в който можеш да влезеш с акаунт в ChatGPT. OpenAI документира и локални сървъри в десктоп приложението ChatGPT в режим Codex, което Roblox не е включил в списъка и което ние не сме тествали. Другият път е API ключ на OpenAI в Assistant чрез Manage API Keys.
Трябва ли API ключ, за да свържа Claude с Roblox Studio?
За MCP не. В настройката на Roblox няма стъпка с API ключ, а клиентът използва обичайния си вход: ръководството за coding harness влиза в Claude Code с акаунт в Anthropic. API ключ трябва само за другия път, модел на Claude в Assistant чрез Manage API Keys.
Може ли ИИ да тества играта ми през MCP?
Да. start_stop_play пуска и спира плейтест, get_console_output чете Output, screen_capture снима изгледа, а инструментите за вход движат персонажа и пращат клавиши и кликове. Субагентът playtest може да изиграе игрови сценарий и да провери резултата. Преди публикуване изиграй играта и сам.
Работи ли MCP сървърът на Studio на Mac?
Да. Roblox документира конфигурация за macOS, която сочи към /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP, до конфигурацията за Windows.
Източници и какво да прочетеш
- Roblox Creator Docs: Connect to the Roblox Studio MCP server (на английски). включване на сървъра, quick connect, JSON и CLI, списък с инструменти, няколко прозореца на Studio и решаване на проблеми
- Roblox Developer Forum: Studio MCP Server Updates and External LLM Support for Assistant (на английски). собствен API ключ на Anthropic, OpenAI или Google в Assistant
- Roblox Creator Docs: Build with a coding harness (на английски). Script Sync, MCP с Cursor или Visual Studio Code и Git
- Roblox Creator Docs: Version History (на английски). запазване с бележки и възстановяване на предишна версия
- Roblox Creator Docs: Data stores (на английски). защо достъпът на Studio до API services трябва само в тестово копие
- Roblox Engine API: StudioTestService (на английски)
- OpenAI: Codex CLI (на английски). вход в Codex CLI, включително Sign in with ChatGPT
- OpenAI: Model Context Protocol (на английски). локални STDIO сървъри в десктоп приложението ChatGPT в режим Codex
- Model Context Protocol: Introduction (на английски). отвореният стандарт, който реализира сървърът на Studio