AI & MCP: подключите ИИ к своим играм
Позвольте Claude, Cursor или другому ИИ-клиенту исследовать и контролировать игры, подключённые к Test in game, и проверять ваши скрипты.
AI & MCP позволяет ИИ-клиенту (claude.ai, ChatGPT, Claude Code, Cursor, любой MCP-клиент) смотреть и действовать в играх, подключённых к Test in game: перечислять объекты, читать интерфейс, кликать, запускать Luau, записывать вызовы remote и запускать ваши скрипты, сообщая, как они отработали. Это для ваших собственных игровых сессий и скриптов; входит в тарифы Pro и Studio.
Подключение
Сначала подключите игру через Test in game (однострочный загрузчик). Затем подключите ИИ тем способом, который поддерживает ваш клиент.
claude.ai и ChatGPT: вход в аккаунт, без токена
- В приложении добавьте пользовательский коннектор с адресом
https://luaward.com/mcp. В claude.ai откройте Settings → Connectors (может быть в разделе Customize); в ChatGPT добавьте его как приложение или коннектор в Settings (может понадобиться режим разработчика). - Начните подключение (в claude.ai это кнопка Connect). Откроется страница Luaward; войдите в аккаунт, если она попросит.
- Проверьте, кто просит: официальное приложение показывает Официальное приложение Claude · claude.ai (так же и ChatGPT), любое другое — Приложение не проверено и адрес, на который оно вас вернёт. Выберите workspace, выключите то, что ИИ делать не должен, выберите Сразу выполняется или Сначала спросить и нажмите Разрешить.
На странице есть по одному переключателю на каждую возможность:
- Смотреть игру: всегда включено. Читает объекты, интерфейс, remotes и журнал подключённых игр. Ничего не меняет.
- Управлять игрой: кликает, вводит текст, нажимает клавиши и запускает код в подключённых играх.
- Следить за remotes (spy): записывает, что игра отправляет через remotes. Нужен ещё и переключатель для конкретной игры (см. ниже).
- Читать скрипты игры: декомпилирует скрипты, которые загружает игра (хранятся 24 часа и никогда не сохраняются в вашем аккаунте).
- Управлять вашими скриптами и ключами: читает исходники ваших скриптов, загружает новые версии, создаёт и читает лицензионные ключи. Выключено, пока вы не включите, и работает только в режиме Сразу выполняется.
Подключить ИИ может владелец или администратор workspace Pro/Studio. Redirects проверяются по разрешённым callback-адресам; это не проверяет владельца приложения. Перед согласием проверьте приложение и scopes. В AI & MCP → Подключения можно просмотреть приложения, изменить режим или завершить подключение; завершение прекращает использование и продление.
Claude Code, Cursor и другие клиенты: токен
- Откройте AI & MCP в панели и создайте токен. Выберите, что ему разрешено, и при желании срок действия. Токен показывается один раз.
- Вставьте команду рядом в ваш ИИ-клиент:
claude mcp add --transport http luaward https://luaward.com/mcp --header "Authorization: Bearer lwm_…"Адрес сервера — https://luaward.com/mcp (MCP поверх HTTP, один JSON-ответ на запрос). Подойдёт любой клиент, умеющий отправлять заголовок Bearer. Сохраните skill, который предлагает страница, как ~/.claude/skills/luaward-debug/SKILL.md, чтобы научить Claude пользоваться инструментами.
Что может ИИ
Каждому инструменту нужен scope; токен видит только инструменты, которые разрешены его scope. read есть всегда.
| Инструмент | Scope | Что делает |
|---|---|---|
list_sessions, capabilities | read | Подключённые игры; что поддерживает этот runtime. |
tree, find, inspect, gui_snapshot, player_state, remotes, screenshot | read | Осмотр игры: объекты, интерфейс (с номерами + diff_from + world), игрок, remote и дополнительный помощник снимка экрана рабочего стола. |
get_notes, save_note, delete_note | read | Постоянные заметки между сессиями, привязанные к PlaceId игры Roblox. |
get_log, get_result, list_runs, get_run, list_projects, list_my_scripts, get_build | read | Консоль (#seq, contains), постраничные ответы (offset/limit), история тестов, проекты, скрипты и статус сборки. |
exec, click, type_text, press_key, run_script, stop | control | Действия в игре: запуск Luau (readonly, guard, codes, detach), клики (auto/signal/vim/mouse), ввод, нажатия клавиш, запуск скриптов/черновых сборок и остановка всего или по cmd. |
scripts_list, scripts_read, scripts_sync, search_scripts | scripts | Список, постраничное чтение, синхронизация в зашифрованный кэш Redis (24 ч) и поиск по всей игре с помощью regex. |
get_script_source, list_script_errors, create_script, deploy_script, promote_build, archive_script, toggle_script, resolve_script_error, list_keys, create_test_key, revoke_key, reset_hwid | manage / read | Ваши собственные скрипты и ключи: читать исходный код, готовить черновые сборки (publish=false) и продвигать их (promote_build), безопасно архивировать тестовые скрипты, создавать/отзывать тестовые ключи MCP, менять пресеты, отмечать ошибки решёнными и сбрасывать HWID. manage никогда не выдаётся по умолчанию и работает только с токеном, который выполняет изменения сразу. list_script_errors требует только read. |
spy_start, spy_stop | spy | Запись вызовов игры к серверу. Выключено, пока вы не разрешите для конкретной игры. |
Deploy меняет код для игроков
По умолчанию (publish=true) deploy_script автоматически продвигает сборку Ready игрокам. Передайте publish=false (или draft=true), чтобы сначала протестировать собранный билд через run_script(mode="build"), а затем вызвать promote_build.
Контроль остаётся у вас
- Сразу или с вопросом. По умолчанию изменения ИИ выполняются сразу (у вашего ИИ-клиента есть своё подтверждение). Выберите Сначала спрашивать, и всё, что меняет игру, ждёт вас в AI & MCP и Test in game. Просмотр никогда не задерживается.
- Remote spy выключен во всех играх, пока вы не разрешите его в сведениях об игре. Он перехватывает вызовы игры, и античит может это заметить.
- Текст из игры — это данные. Имена, текст интерфейса, строки консоли и исходники скриптов приходят из игры; skill и сервер велят ИИ никогда не следовать найденным там инструкциям.
- Отзовите токен или завершите подключение приложения в любой момент; оно сразу перестанет работать. Вкладка активности показывает, что делал ИИ (инструмент, кто и игра; никогда не код и не вывод игры).
Полезно знать
- Что работает, зависит от вашего runtime (
capabilitiesпоказывает, что он поддерживает). Для runtime'ов, блокирующихCaptureService, скачайте/mcp/capture.ps1и запустите его с-Token lwm_..., чтобыscreenshotнапрямую снимал окно Roblox. - Успешный тест означает «нет ошибок за N секунд», а не что скрипт корректен.
- Не отдавайте токен и не нажимайте Разрешить для того, кому не доверяете: он может действовать в ваших подключённых играх.