Гайд · ИИ в Roblox Studio

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

В Roblox Studio встроен сервер Model Context Protocol (MCP). Включите его, подключите ИИ-клиент вроде Claude Code, Claude Desktop или Cursor, и этот клиент сможет читать ваш плейс, править скрипты, выполнять Luau и запускать плейтесты в открытом окне Studio. Этот гайд следует собственной документации Roblox по настройке, прямо говорит, где она заканчивается (ChatGPT одно из таких мест), и объясняет, как сохранить плейс в безопасности, пока в нём работает агент.

Обновлено 26 октября 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 под их собственными названиями: DeepSeek V4 Flash на любом плане, 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.