Гайд · ШІ в Roblox Studio

Як підключити Claude, Cursor або ChatGPT до Roblox Studio через MCP

У Roblox Studio вбудований сервер Model Context Protocol (MCP). Увімкніть його, підключіть ШІ-клієнт на кшталт Claude Code, Claude Desktop або Cursor, і цей клієнт зможе читати ваш плейс, редагувати скрипти, виконувати Luau і запускати плейтести у відкритому вікні Studio. Цей гайд іде за власною документацією Roblox щодо налаштування, прямо каже, де вона закінчується (ChatGPT одне з таких місць), і пояснює, як уберегти плейс, поки в ньому працює агент.

Оновлено 20 листопада 2026 р.13 хв читанняАвтор:

Коротко

У 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, вставляти асети й запускати плейтести в будь-якому відкритому плейсі. Спершу збережіть версію і підключайте тільки клієнти, яким довіряєте.
На цій сторінці
  1. Що він робить
  2. 1. Увімкнути сервер
  3. 2. Підключити клієнт
  4. JSON і CLI
  5. 3. Перевірити
  6. ChatGPT
  7. Інструменти
  8. Кілька вікон
  9. Безпека
  10. Script Sync і Git
  11. Розв'язання проблем
  12. Без налаштування
  13. Поширені запитання
  14. Джерела та що почитати

Що робить MCP-сервер Studio

MCP (Model Context Protocol) це відкритий стандарт, який дозволяє ШІ-інструментам спілкуватися з іншими застосунками. Roblox вбудував MCP-сервер у Studio. Коли він увімкнений, ШІ-клієнт на вашому комп'ютері може досліджувати відкритий плейс, читати й писати скрипти, виконувати Luau і тестувати гру в режимі гри, усе через інструменти, які надає сервер.

Сервер працює як локальний процес на вашому комп'ютері й спілкується з клієнтом через stdio (стандартне введення й виведення). Сам по собі він нічого не робить: кожна дія починається з запиту клієнта, і клієнт вирішує, який інструмент викликати. Потрібна остання версія Roblox Studio і потрібний MCP-клієнт, обидва на одному комп'ютері.

Два способи використовувати Claude або GPT зі Studio

Два шляхи, які документує Roblox
MCP-сервер StudioAssistant із власним API-ключем
Де ви пишетеУ ШІ-клієнті, наприклад Claude Desktop, Claude Code або CursorУ панелі Assistant у Studio
Що налаштовуєтеВмикаєте сервер у Studio, потім підключаєте клієнтAssistant > … > Manage API Keys, потім вибираєте модель
МоделіТі, що використовує ваш клієнтAnthropic, OpenAI або Google Gemini
Що потрібноКлієнт і його власний вхідAPI-ключ від цього провайдера
Хто діє в StudioВаш клієнт, через інструменти MCPAssistant, на вибраній моделі

Цей гайд про перший шлях. Якщо вам потрібна тільки модель Claude або OpenAI, що відповідає всередині Studio, другий шлях коротший: отримайте API-ключ у провайдера, відкрийте Assistant, натисніть … > Manage API Keys, виберіть провайдера, вставте ключ і виберіть модель у списку Model.

Крок 1: увімкніть MCP-сервер у Studio

  1. Відкрийте Roblox Studio і відкрийте плейс. Якщо Studio пропонує оновлення, спершу встановіть його: серверу потрібна остання версія.
  2. Натисніть Assistant праворуч угорі в Studio (права частина панелі mezzanine), щоб відкрити вікно Assistant.
  3. Натисніть … і виберіть Manage MCP Servers.
  4. Увімкніть 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. У панелі з кроку 1 (Assistant Settings > MCP Servers) розгорніть список Quick connect. У ньому підтримувані клієнти, встановлені на вашому комп'ютері.
  2. Увімкніть потрібний клієнт.
  3. Якщо клієнта немає в списку, встановіть його й перезапустіть Roblox Studio. Якщо ви встановили його при відкритому Studio, може знадобитися перезапустити Studio, клієнт або обидва.

Налаштування за клієнтами

Що Roblox документує для кожного клієнта, 30 вересня 2026 року
КлієнтШляхПримітки
Claude Desktop (Anthropic)Quick connectДесктопний застосунок. Roblox не описує використання Claude у вебпереглядачі.
Claude Code (Anthropic)Quick connectГайд Roblox щодо coding harness використовує його як розширення Visual Studio Code із входом через акаунт Anthropic.
CursorQuick connectШІ-асистент вбудований. Увійдіть через акаунт Cursor.
Visual Studio CodeQuick connectПотрібне ШІ-розширення, наприклад Claude Code.
Codex CLI (OpenAI)Quick connectКлієнт OpenAI у списку Roblox. Документація Codex від OpenAI пропонує Sign in with ChatGPT під час першого запуску.
Gemini CLI (Google)Quick connect
AntigravityQuick connect
Будь-який інший клієнт із підтримкою stdioJSON-конфігурація або команда 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-сервер, використовуйте їх як є.

JSON-конфігурація · Windows
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "cmd.exe",
      "args": [
        "/c",
        "%LOCALAPPDATA%\\Roblox\\mcp.bat"
      ]
    }
  }
}
JSON-конфігурація · macOS
{
  "mcpServers": {
    "Roblox_Studio": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
    }
  }
}

Де лежить файл конфігурації, залежить від клієнта (у прикладі Roblox він називається mcp.json). Інструкції Roblox кажуть завершити налаштування за документацією клієнта, потім перезапустити клієнт, щоб він підхопив зміни.

Команда CLI

Деякі клієнти приймають команду замість файлу конфігурації. Ось команда, яка запускає сервер; зареєструйте її так, як описує документація вашого клієнта:

Команда CLI · Windows
cmd.exe /c %LOCALAPPDATA%\Roblox\mcp.bat
Команда CLI · macOS
/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

Обидві вказують на файл, який встановлює Studio. У Windows %LOCALAPPDATA% це локальна папка даних застосунків вашого користувача. У macOS шлях іде всередині RobloxStudio.app у /Applications. Якщо файлу немає, клієнт не зможе запустити сервер: див. розв'язання проблем.

Крок 3: перевірте підключення

  1. У Studio відкрийте Assistant і натисніть … > Manage MCP Servers.
  2. Під Enable Studio as MCP server знайдіть зелений індикатор. Він показує кількість підключених клієнтів.
  3. У клієнті почніть із запиту, який тільки читає, щоб неправильне налаштування нічого не змінило. Наприклад: Використовуючи інструменти 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.

Інструменти MCP-сервера Studio, за документацією Roblox
ГрупаІнструментиЩо роблять
Скриптиscript_read, multi_edit, script_search, script_grepЧитають скрипт за шляхом на кшталт game.ServerScriptService.MyScript, повністю або за діапазоном рядків. Застосовують кілька правок за раз і створюють скрипт, якщо шляху немає. Шукають скрипти за назвою (до 10 результатів) або текст в усіх скриптах (до 50 збігів).
Модель данихsearch_game_tree, inspect_instance, subagentОбходять ієрархію об'єктів із фільтрами та обмеженням глибини, читають усі доступні властивості й атрибути одного об'єкта або передають багатокрокову роботу субагенту explore чи playtest.
Виконання Luauexecute_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. Знайди причину й виправ.

RoCode робить
  • Читає 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.

Джерела та що почитати

Спробуйте RoCode у своїй грі.

Безкоштовні кредити щодня, без картки. Встановіть плагін, опишіть функцію та перевірте, що з'явилося в Studio.