ИИ и MCP — документация

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

Как устроена интеграция

AI / MCP — встроенный модуль редактора Reckfell. Он открывает инструменты проекта для встроенного ассистента и внешних MCP-клиентов. Модель получает каталог действий и может вызывать операции редактора: читать и изменять сцены, работать с ресурсами, C# и запущенной игрой.

Модель и MCP выполняют разные роли. Модель обрабатывает запрос и выбирает действия. MCP передаёт эти действия в редактор и возвращает результат. Поэтому выбор провайдера не меняет устройство проекта и доступные в вашей сборке инструменты.

Требования к редактору

Откройте проект в сборке Reckfell с модулем MCP. В рабочем пространстве должна быть панель AI / MCP. Модуль включён в поставку редактора. Перед работой с моделью настройте подключение в панели AI / MCP.

Итоговый набор действий зависит от модулей вашей сборки. Каталог редактора — источник актуальных возможностей: наличие общего вызова метода не означает, что любой сценарий уже проверен на практике.

Подключите модель

Во встроенном ассистенте задайте три параметра:

Параметр	Что указать
Endpoint	Полный адрес API с окончанием `/responses` или `/chat/completions`
Model	Точный идентификатор модели у провайдера
API key	Ключ доступа, если он требуется вашим сервером

Внешний провайдер. Используйте совместимый API своего провайдера. Модель должна поддерживать вызов инструментов. Движок не подменяет выбранную модель и не переключает провайдера автоматически.

Локальная модель. Укажите адрес API на своём компьютере или сервере. Например, стандартное локальное подключение Ollama использует такой endpoint:

http://localhost:11434/v1/chat/completions

Имя модели берите из вашей локальной конфигурации. Возможность работать с инструментами и качество выполнения задач зависят от выбранной модели.

Провайдер Reckfell. Используйте выданные вам endpoint, идентификатор модели и ключ. Отдельный публичный адрес сервиса или тариф здесь не задаётся: параметры берутся из вашего доступа.

Endpoint и модель сохраняются в локальных настройках проекта. Ключи на Windows хранятся в Credential Manager и не записываются в историю переписки.

Разрешите работу с проектом

В панели AI / MCP включите Allow AI to edit this project, если ассистент должен изменять проект. Без этого разрешения доступны операции чтения, а запросы на изменение возвращают project_not_trusted.

Сформулируйте задачу с ожидаемым результатом. Например: «Добавь камеру от третьего лица к Player, используй существующий InputMap, собери C#-проект и сообщи об ошибках». Встроенный ассистент и внешний клиент используют один диспетчер инструментов.

Подключите внешний MCP-клиент

Откройте проект и панель AI / MCP.
Запустите сервер кнопкой Start server.
Нажмите Copy connection и перенесите endpoint и заголовок Authorization в настройки клиента.
Начните с reckfell_catalog, чтобы найти нужные инструменты.

Сервер работает на локальном интерфейсе. Параметры соединения также доступны в .reckfell/editor/mcp-<pid>.json. Этот файл относится к текущему процессу редактора и не должен попадать в репозиторий проекта.

Для stdio-подключения используйте исполняемый файл редактора напрямую, а не консольную оболочку. Подставьте порт из панели и передайте скопированный токен через переменную окружения RECKFELL_MCP_TOKEN вашего MCP-клиента:

PowerShell
& ".\reckfell.windows.editor.x86_64.mono.exe" --mcp-stdio --mcp-port PORT

Найдите нужное действие

Передайте следующие параметры в вызов tools/call вашего MCP-клиента:

JSON
{
  "name": "reckfell_catalog",
  "arguments": {
    "action": "search",
    "query": "scene"
  }
}

После поиска изучите доступные действия. Например, чтение иерархии открытого документа:

JSON
{
  "name": "reckfell_scene",
  "arguments": {
    "action": "tree"
  }
}

Каталог содержит группы для редактора, сцен, объектов, ресурсов, файлов, настроек проекта, C#, запущенной игры, пространственных операций, пакетных сценариев, вокселей, внешних соединений и сборки. Используйте reckfell_catalog с действием class, чтобы получить свойства, методы и сигналы конкретного класса вашей сборки.

Передавайте типизированные значения

Значения движка передаются с явным типом. Для вектора положения используйте:

JSON
{ "$type": "Vector3", "value": [0, 2, 0] }

Для пути к Entity или ссылки на ресурс:

JSON
{
  "target": { "$entity": "Player" },
  "path": { "$type": "EntityPath", "value": "Player/Camera3D" },
  "material": { "$resource": "asset://Materials/Stone.rdata" }
}

Это примеры представления значений. Конкретные поля операции уточняйте в каталоге: не каждый инструмент принимает поля target, path и material одновременно.

Проверяйте изменения и результат

Операции со сценой используют историю Undo / Redo. Поле undo_steps сообщает число шагов для отмены. Изменения ресурсов могут использовать снимки, а запись существующего файла требует актуальный expected_hash. Контрольные точки файлов действуют в пределах сессии редактора.

Запуск игры, сборка и другие длительные операции возвращают job_id. Получение идентификатора означает принятие задачи. Проверяйте её через reckfell_jobs с действием get: дождитесь completed или failed и изучите result.ok и диагностику. Снимок экрана запущенной игры требует редактор с рендерингом.

Внешние инструменты

Группа reckfell_connections позволяет настраивать внешние MCP-сервисы, просматривать инструменты и вызывать их из редактора. Предусмотрены профили GitHub, Context7, Playwright и Blender. При запуске внешних процессов и вызове внешних инструментов редактор запрашивает подтверждение конкретной операции.

Для Playwright нужна установленная среда Node/npm, для Blender — настроенный мост в самом приложении. Для собственного MCP-сервера Reckfell эти внешние зависимости не требуются.