Skip to content

Версии документации

Engine Atlas MCP ​

MCP подключает вашего ИИ к этому сайту. Модель читает карточки, изучает код в Ghidra и пишет прямо в режиме редактирования: её правки появляются на карточках и в Моих правках, а ваши изменения сразу видит она. Локально ничего не разворачивается: нужны только сам сервер и Ghidra.

Открыть проект на GitHub

Настоятельно советуем хорошие модели: Sonnet 5.5, GPT-6 Sol и выше. Жёстких требований нет, но от слабой модели чаще получаются пересказы кода вместо объяснений.

Подключение ​

Установка описана в README, настройка для Claude Code, Codex и Antigravity — в инструкции. Ghidra с плагином Ghidra MCP и открытым libasphalt8.so обязательна, см. Как исследовать движок.

Чтобы видеть работу модели, откройте ссылку на правки, которую она даст, или включите Связь с MCP в настройках сайта. Браузер один раз спросит разрешение на доступ к локальной сети: разрешите. Подойдут Chrome, Edge и Firefox.

Как работать ​

Вам не нужно объяснять модели правила: она получает их с сервера. Достаточно коротко сказать, что изучить.

  1. Исследование. «Изучи класс gin::Widget в Engine Atlas.» Лучше брать один класс или небольшую группу связанных классов.
  2. Вопросы. Если модель спрашивает о смысле в игре, отвечайте тем, что знаете. Её предположения не должны становиться фактами.
  3. Проверка критиком. Откройте новую сессию, лучше с другой моделью: «Ты критик. Проверь карточки gin::Widget по роли критика из руководства.»
  4. Исправления. Передайте замечания автору и повторите проверку.
  5. Отправка. Просмотрите Мои правки и нажмите «Отправить» или скажите модели: «Подпиши правки своим именем и отправь их на рассмотрение.»

Кто такой критик ​

Критик — вторая сессия ИИ, которая ищет ошибки в чужих карточках. Новая сессия нужна потому, что автор плохо видит собственные догадки. Критик не верит отчёту автора, сам читает базу и код игры, проверяет каждое утверждение и возвращает карточку с конкретными замечаниями. Он не пишет текст за автора.

Если критик вернул карточку, это обычная работа, а не провал. Если он придумывает придирки или требует фактов, которых нет в коде, это уже ошибка критика, и такое замечание не нужно выполнять. Плохо как раз наоборот: критик, который всё сразу хвалит, скорее всего, не читал код. Попросите проверить заново.

Хороший результат и плохой ​

Откройте карточку в режиме чтения и представьте, что видите класс впервые.

ХорошоПлохо
«Вписывает детей в прямоугольник заданной формы и ставит его по центру»«Класс-контейнер для работы с соотношением сторон»
Объясняет, что значит значение и что изменится в игре«Обновляет состояние», «выполняет логику», перевод имени метода
Аргумент описан с границами и режимами«Значение согласно сигнатуре»
«Неизвестно, кто владеет объектом: создатель не найден»Уверенная фраза о владении без проверки
Условие указано: «только при режиме 1»Вывод одной ветки кода выдан за общее правило
Пример решает задачу и честно сказано, проверялся ли онВыдуманный вызов API или «проверено», хотя не запускалось

Тревожные признаки:

  • В статье встречаются адреса, хеши, пути к файлам или абзац про ход проверки. Этому место в доказательствах, а не в тексте для читателя.
  • Текст выглядит гладко, но после чтения вы не можете сказать, зачем нужен класс.
  • Все свойства подтверждены, а заметок и оснований нет.
  • Описание одного метода скопировано в соседние.
  • Написано «проверено в игре», хотя игру никто не запускал. Чтение кода в Ghidra — это статическая проверка, а не проверка в игре.

Честное «неизвестно» лучше красивой догадки. Такие карточки ценятся: следующий исследователь видит, что осталось выяснить.

Что сохранить ​

Не удаляйте заметки и историю исследования. Они входят в отправку, и именно за них исследования с ИИ ценятся выше ручных: видно, как получен каждый вывод.

Запрещено отправлять чужие ключи, личные данные и файлы игры. Опубликованные карточки меняет только рассмотрение: MCP сам ничего не публикует.