Коротко
У 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 дає цьому коду історію, яку можна відкотити. Фіксуйте чистий стан, перш ніж просити агента про щось велике.
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