Roblox Studio MCP: встроенный сервер Studio и WEPPY для Claude и Codex

Roblox/roblox-studio-agent-plugin· Проверено 12.11.2026· 34на GitHub

Подключает агента к открытому месту в Roblox Studio: читать и править скрипты на Luau, добавлять объекты и ассеты, запускать плейтест и читать консоль.

2 реализации:

Встроенный MCP-сервер самой Studio; репозиторий — плагин для Claude и Codex с настройками и навыками, своего кода в нём нет.

Как подключить

Что сделать до подключения

Roblox Studio на macOS или Windows: войти в аккаунт и открыть место

В Studio: Assistant → … → Settings → MCP Servers и включить Enable Studio as MCP server

Для ChatGPT и Codex там же в Quick Connect включить ChatGPT (codex)

На Windows вместо StudioMCP команда cmd.exe с аргументами /c и cd /d %LOCALAPPDATA%\Roblox && .\mcp.bat

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio roblox \
  -- /Applications/RobloxStudio.app/Contents/MacOS/StudioMCP

Проверка: claude mcp list показывает статус рядом с каждым сервером: ✔ Connected, ! Needs authentication или ✘ Failed to connect. Внутри сессии то же видно по команде /mcp.

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.roblox]
command = "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"
args = []

Проверка: В интерфейсе codex введите /mcp: появится список активных серверов. Из терминала то же покажет codex mcp list.

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "roblox": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP",
      "args": []
    }
  }
}

Проверка: Откройте Customize в боковой панели: там список серверов с переключателями. Ошибки подключения смотрите в панели Output (Cmd+Shift+U), пункт MCP Logs в выпадающем списке.

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "roblox": {
      "type": "stdio",
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP",
      "args": []
    }
  }
}

Проверка: Попросите Copilot выполнить безобидную задачу через сервер и раскройте вызов инструмента в чате. Одна запись в конфиге подключение не подтверждает.

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "roblox": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP",
      "args": []
    }
  }
}

Проверка: Запустите qwen и введите /mcp: откроется окно управления серверами. Из терминала статус покажет qwen mcp list.

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "roblox": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP",
      "args": []
    }
  }
}

Проверка: gemini mcp list показывает каждый сервер, его настройки и статус Connected или Disconnected. В сессии /mcp выводит CONNECTED, CONNECTING или DISCONNECTED и список инструментов.

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "roblox": {
        "type": "local",
        "command": ["/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP"]
      }
    }
  }
}

Проверка: opencode mcp list показывает состояние каждого сервера, подключённый выглядит как ✓ context7 connected. Внутри OpenCode то же видно в /mcps.

Настройки → Разработчик → Изменить конфиг: файл claude_desktop_config.json. После правки перезапустите приложение. Подробно о Claude Desktop

{
  "mcpServers": {
    "roblox": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP",
      "args": []
    }
  }
}

Проверка: Нажмите «Add files, connectors, and more /» в левом нижнем углу поля ввода, наведите на Connectors и откройте Manage connectors. Выберите сервер, чтобы увидеть его инструменты.

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "roblox": {
      "command": "/Applications/RobloxStudio.app/Contents/MacOS/StudioMCP",
      "args": []
    }
  }
}

Проверка: Попросите модель в чате выполнить задачу через инструмент сервера. Через API сервер из mcp.json вызывают по id в integrations, например mcp/playwright.

Инструменты сервера

list_roblox_studiosпоказывает открытые окна Studio

get_studio_stateчитает состояние Studio

get_console_outputчитает консоль

script_readчитает скрипт

script_grepищет по тексту скриптов

search_game_treeищет объекты в дереве игры

inspect_instanceчитает свойства объекта

screen_captureснимает экран Studio

search_assetищет ассеты в Creator Store

execute_luauвыполняет код на Luau

multi_editправит несколько мест разом

insert_assetвставляет ассет в место

generate_meshгенерирует модель

generate_textureгенерирует текстуру

generate_sceneгенерирует сцену

generate_avatarгенерирует аватар

start_stop_playзапускает и останавливает плейтест

character_navigationведёт персонажа в плейтесте

upload_imageзагружает картинку в Roblox

open_cloud_invokeвызывает Open Cloud API

Показано 20 из 36.

Свой плагин Studio и сервер на Node.js: до пяти окон Studio сразу, синхронизация проекта с локальными файлами, веб-панель на localhost:3002; часть функций платная.

Как подключить

Что сделать до подключения

Node.js 22 или новее, Roblox Studio на Windows 10+ или macOS 12+

Поставить плагин WEPPY для Studio скриптом install.sh (macOS, Linux) или install.ps1 (Windows) со страницы установки, затем перезапустить AI-приложение и Roblox Studio

Плагин и сервер должны быть из одного релиза: обновлять оба вместе

Конфиг для вашего клиента

Команда в терминале, в папке проекта. Флаг --scope user подключит сервер для всех проектов. Подробно о Claude Code

claude mcp add --transport stdio weppy-roblox-mcp \
  -- npx -y @weppy/roblox-mcp@latest

Файл ~/.codex/config.toml или .codex/config.toml в доверенном проекте. Можно и командой codex mcp add. Подробно о Codex

[mcp_servers.weppy-roblox-mcp]
command = "npx"
args = ["-y", "@weppy/roblox-mcp@latest"]

Файл ~/.cursor/mcp.json для всех проектов или .cursor/mcp.json в папке проекта. Подробно о Cursor

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp@latest"]
    }
  }
}

Файл .mcp.json в корне проекта или ~/.copilot/mcp-config.json для всех проектов. Подробно о VS Code

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp@latest"]
    }
  }
}

Файл ~/.qwen/settings.json или .qwen/settings.json в проекте. Подробно о Qwen Code

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp@latest"]
    }
  }
}

Файл ~/.gemini/settings.json или .gemini/settings.json в проекте. Подробно о Gemini CLI

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp@latest"]
    }
  }
}

Файл opencode.json в папке проекта или ~/.config/opencode/opencode.json. Подробно о OpenCode

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "servers": {
      "weppy-roblox-mcp": {
        "type": "local",
        "command": ["npx", "-y", "@weppy/roblox-mcp@latest"]
      }
    }
  }
}

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp@latest"]
    }
  }
}

Вкладка Program → Install → Edit mcp.json. Подробно о LM Studio

{
  "mcpServers": {
    "weppy-roblox-mcp": {
      "command": "npx",
      "args": ["-y", "@weppy/roblox-mcp@latest"]
    }
  }
}

Инструменты сервера

query_instancesищет и читает объекты

mutate_instancesсоздаёт, копирует и удаляет объекты

manage_propertiesчитает и меняет свойства и теги

manage_scriptsчитает, пишет и проверяет скрипты

manage_uiсобирает и проверяет игровой UI

manage_lightingнастраивает свет и небо

manage_cameraдвигает камеру и снимает вид

manage_terrainлепит и красит ландшафт

spatial_queryищет ровные места и точки спавна

manage_assetsвставляет модели из Creator Store

manage_open_cloud_assetsзагружает ассеты через Open Cloud

manage_syncуправляет синхронизацией проекта

manage_logsчитает логи и ошибки

manage_studioуправляет плейтестом

system_infoпроверяет связь и тариф

batch_executeвыполняет пачку команд

execute_luauвыполняет код на Luau

Показано 17 из 25.

Что попросить агента

«Посмотри мою игру и объясни, как работает система раундов»Агент найдёт скрипты через search_game_tree и script_grep, прочитает их через script_read и опишет логику

«Монетка не прибавляется в таблице лидеров. Запусти плейтест, найди баг и исправь»Агент запустит игру через start_stop_play, прочитает get_console_output, найдёт ошибку и поправит скрипт через multi_edit

«Добавь лобби с четырьмя точками спавна и табличкой с числом игроков, потом проверь плейтестом»Агент создаст объекты и скрипт через execute_luau и multi_edit и проверит результат через start_stop_play

«Найди в Creator Store модель меча и положи её в StarterPack»WEPPY найдёт модель через manage_assets и вставит её; встроенный сервер — через search_asset и insert_asset

«Сгенерируй ландшафт с горами и реками и поставь точки спавна на ровных местах»WEPPY построит рельеф через manage_terrain и найдёт ровные площадки через spatial_query (Pro)

Для каких задач

Разобрать чужую игру: найти, как устроен раунд или магазин

Найти и исправить баг через плейтест и консоль

Собрать лобби, арену или ландшафт из пары фраз

Найти модель в Creator Store и вставить её в игру

Переименовать модуль и поправить все зависимые скрипты

Сгенерировать модель, текстуру, аватар или анимацию

Ограничения

Агент меняет место напрямую, и не каждую правку можно отменить в Studio: перед крупными изменениями сохраните или опубликуйте версию

Работает только с Roblox Studio на macOS и Windows; claude.ai и ChatGPT в браузере или на телефоне подключиться к Studio не могут

У WEPPY бесплатен Basic: несколько мест, двусторонняя синхронизация, UI Studio, ландшафт, звук и анимация только в Pro

WEPPY отправляет телеметрию в Google Analytics 4; выключается переменной ENABLE_TELEMETRY=false

Если не работает

Инструменты Studio есть, но list_roblox_studios пустой или «Unable to reach Roblox Studio»

Studio не запущена, не открыто место или выключена настройка MCP: откройте Studio и место и включите Enable Studio as MCP server.

macOS: «Roblox Studio MCP was not found»

Studio лежит не в /Applications и не в ~/Applications: поставьте Studio заново или перенесите RobloxStudio.app в одну из этих папок.

Связь падает сразу после включения настройки

Порт 13469 занят другим приложением: закройте его и перезапустите Studio.

Настройка MCP была включена, а теперь выключена

Настройка хранится для каждого аккаунта Roblox отдельно: после смены аккаунта включите её снова.

Инструменты Studio видны в клиенте дважды

Сервер Studio прописан два раза, например плагином и вручную как Roblox_Studio. В Claude Code удалите ручную запись: claude mcp remove Roblox_Studio, и начните новую сессию.

Какую реализацию выбрать

Реализация	Кто делает	Звёзды	Запуск	Ключ	Инструменты	Обновлён
Roblox Studio MCPразработчик сервиса	Roblox	34	локально	не нужен	36	10 ноября 2026
WEPPY Roblox MCP	WEPPY (hope1026)	76	локально	не нужен	25	6 ноября 2026

Частые вопросы

Есть ли MCP-сервер у самой Roblox?

Есть: он входит в Roblox Studio и запускается из неё. Репозиторий Roblox — плагин для Claude Code, Cowork, ChatGPT и Codex: в нём только настройки и навыки, своего кода нет.

Чем WEPPY отличается от встроенного сервера?

WEPPY ставит свой плагин в Studio и запускается через npx. Он держит до пяти окон Studio на одном сервере, синхронизирует проект с локальными файлами и показывает историю правок в веб-панели. Многое из этого входит только в платный Pro.

Как проверить, что Studio подключилась?

Спросите агента «list my open Roblox Studio windows»: он должен назвать открытое место. В Claude Code команда /mcp покажет plugin:roblox-studio:macos и plugin:roblox-studio:windows, подключается только запись вашей системы. В Codex проверьте codex mcp list: там должен быть Roblox_Studio.

Может ли агент сломать игру?

Встроенный сервер правит скрипты, добавляет и удаляет объекты и выполняет Luau, отменить можно не всё. Сохраните версию места перед крупной задачей. WEPPY слушает только 127.0.0.1:3002, закрывает CoreGui и CorePackages и ограничивает 450 запросов в минуту с таймаутом 30 секунд.

Как включить MCP-сервер в Roblox Studio?

Откройте место, затем Assistant → … → Settings → MCP Servers (в старых версиях Manage MCP Servers) и включите Enable Studio as MCP server. Для ChatGPT и Codex там же в Quick Connect включите ChatGPT (codex).

Как подключить Roblox Studio MCP к Codex?

Выполните codex plugin marketplace add Roblox/roblox-studio-agent-plugin, откройте /plugins, поставьте Roblox Studio и начните новый тред командой /new. Затем попросите агента «Get me set up with Roblox Studio».

Что такое WEPPY Roblox MCP?

Сторонний набор из MCP-сервера @weppy/roblox-mcp и плагина для Studio. Ставится скриптом со страницы установки, подключается к Claude Code, Claude Desktop, Cursor, Codex и Gemini CLI.

Что даёт Pro в WEPPY Roblox MCP?

Basic бесплатен: инструменты и синхронизация из Studio в локальные файлы. Pro добавляет работу с пятью местами, библиотеку ассетов с загрузкой в Roblox, двустороннюю синхронизацию, UI Studio, массовые операции, ландшафт, звук и анимацию.

Работает ли сервер из России?

Сервер Studio работает на вашем компьютере, а поиск в Creator Store, генерация, загрузка картинок и запросы Open Cloud идут в Roblox под вашим аккаунтом Studio.

Roblox Studio MCP: встроенный сервер Studio и WEPPY для Claude и Codex

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Как подключить

Что сделать до подключения

Конфиг для вашего клиента

Инструменты сервера

Что попросить агента

Для каких задач

Ограничения

Если не работает

Какую реализацию выбрать

Частые вопросы

Похожие серверы