LuawardDocs

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: вход в аккаунт, без токена

  1. В приложении добавьте пользовательский коннектор с адресом https://luaward.com/mcp. В claude.ai откройте Settings → Connectors (может быть в разделе Customize); в ChatGPT добавьте его как приложение или коннектор в Settings (может понадобиться режим разработчика).
  2. Начните подключение (в claude.ai это кнопка Connect). Откроется страница Luaward; войдите в аккаунт, если она попросит.
  3. Проверьте, кто просит: официальное приложение показывает Официальное приложение Claude · claude.ai (так же и ChatGPT), любое другое — Приложение не проверено и адрес, на который оно вас вернёт. Выберите workspace, выключите то, что ИИ делать не должен, выберите Сразу выполняется или Сначала спросить и нажмите Разрешить.

На странице есть по одному переключателю на каждую возможность:

  • Смотреть игру: всегда включено. Читает объекты, интерфейс, remotes и журнал подключённых игр. Ничего не меняет.
  • Управлять игрой: кликает, вводит текст, нажимает клавиши и запускает код в подключённых играх.
  • Следить за remotes (spy): записывает, что игра отправляет через remotes. Нужен ещё и переключатель для конкретной игры (см. ниже).
  • Читать скрипты игры: декомпилирует скрипты, которые загружает игра (хранятся 24 часа и никогда не сохраняются в вашем аккаунте).
  • Управлять вашими скриптами и ключами: читает исходники ваших скриптов, загружает новые версии, создаёт и читает лицензионные ключи. Выключено, пока вы не включите, и работает только в режиме Сразу выполняется.

Подключить ИИ может владелец или администратор workspace Pro/Studio. Redirects проверяются по разрешённым callback-адресам; это не проверяет владельца приложения. Перед согласием проверьте приложение и scopes. В AI & MCP → Подключения можно просмотреть приложения, изменить режим или завершить подключение; завершение прекращает использование и продление.

Claude Code, Cursor и другие клиенты: токен

  1. Откройте AI & MCP в панели и создайте токен. Выберите, что ему разрешено, и при желании срок действия. Токен показывается один раз.
  2. Вставьте команду рядом в ваш ИИ-клиент:
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, capabilitiesreadПодключённые игры; что поддерживает этот runtime.
tree, find, inspect, gui_snapshot, player_state, remotes, screenshotreadОсмотр игры: объекты, интерфейс (с номерами + diff_from + world), игрок, remote и дополнительный помощник снимка экрана рабочего стола.
get_notes, save_note, delete_notereadПостоянные заметки между сессиями, привязанные к PlaceId игры Roblox.
get_log, get_result, list_runs, get_run, list_projects, list_my_scripts, get_buildreadКонсоль (#seq, contains), постраничные ответы (offset/limit), история тестов, проекты, скрипты и статус сборки.
exec, click, type_text, press_key, run_script, stopcontrolДействия в игре: запуск Luau (readonly, guard, codes, detach), клики (auto/signal/vim/mouse), ввод, нажатия клавиш, запуск скриптов/черновых сборок и остановка всего или по cmd.
scripts_list, scripts_read, scripts_sync, search_scriptsscriptsСписок, постраничное чтение, синхронизация в зашифрованный кэш 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_hwidmanage / readВаши собственные скрипты и ключи: читать исходный код, готовить черновые сборки (publish=false) и продвигать их (promote_build), безопасно архивировать тестовые скрипты, создавать/отзывать тестовые ключи MCP, менять пресеты, отмечать ошибки решёнными и сбрасывать HWID. manage никогда не выдаётся по умолчанию и работает только с токеном, который выполняет изменения сразу. list_script_errors требует только read.
spy_start, spy_stopspyЗапись вызовов игры к серверу. Выключено, пока вы не разрешите для конкретной игры.

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 секунд», а не что скрипт корректен.
  • Не отдавайте токен и не нажимайте Разрешить для того, кому не доверяете: он может действовать в ваших подключённых играх.