ИИ-ассистент и MCP

Skyforge дружит с ИИ в обе стороны: платформой можно управлять прямо из Claude (через MCP-сервер платформы), а внутри самой платформы ИИ снимает рутину — импортирует модели по ссылке и делает сводный разбор событий.

Управление платформой из Claude (MCP)

Skyforge предоставляет remote MCP-сервер: Claude (Desktop, Code, claude.ai) напрямую работает с вашим журналом событий, Ангаром и складом. Одна фраза в чате — и событие записано, борт заведён, модель импортирована, позиция на складе добавлена.

«Добавь на склад 4 мотора T-Motor 2207, лежат в коробке №3»

Claude найдёт (или заведёт) тип в справочнике и место хранения (inventory_add) — руками через форму заполнять не придётся.

«Занеси событие: сегодня на посадке отломилась стойка шасси у Борта-1, без последствий»

Claude сам найдёт борт (list_my_aircraft) и создаст запись в журнале (create_event) с категорией, фазой полёта и серьёзностью.

«Приложи этот лог ArduPilot к событию с Бортом-1 и напиши комментарий с разбором причины»

Claude найдёт событие (list_events/get_event), приложит файл (upload_event_attachment) и оставит комментарий с находками (add_event_comment) — без ручного похода в интерфейс. Для больших логов (десятки МБ) и видео — см. «Большие вложения» ниже.

Ничего устанавливать локально не нужно: сервер уже запущен, требуются только URL и персональный токен. Все операции выполняются от вашего имени и ограничены правами токена.

• Эндпоинт: https://skyforgeapp.com/mcp
• Транспорт: Streamable HTTP (JSON-RPC поверх POST)
• Аутентификация: заголовок Authorization: Bearer skyf_...

Адрес сменился (платформа переехала на собственный домен). Если у вас в настройках клиента прописан старый (skyforge.cloud16.ru) — впишите новый: старое имя (cloud16.ru) больше не обслуживается: домен отключён.

Шаг 1. Создайте API-токен

В Настройки → API-токены (/settings/tokens) создайте токен пресетом «Для MCP» — это скоупы read + incidents:write + hangar:write + import + designer:write + vault:write + profile:write + wind_tunnel:write. Лишнее можно снять: без import не будет импорта модели по URL, без profile:write ассистент не сможет запомнить валюту, в которой считает ваши траты, без wind_tunnel:write — ставить вашу модель на расчёт обтекания, перезапускать и удалять расчёты; для read-only ассистента достаточно read.

Токен показывается один раз — сохраните его и храните как пароль.

Шаг 2. Подключите Skyforge к Claude

Claude Code — одна команда:

claude mcp add skyforge --transport http https://skyforgeapp.com/mcp \
  --header "Authorization: Bearer skyf_ВАШ_ТОКЕН"

Проверка: claude mcp list → сервер skyforge со статусом connected.

Claude Desktop / claude.ai (custom connector):

1. Settings → Connectors → Add custom connector.
2. URL: https://skyforgeapp.com/mcp.
3. В расширенных настройках добавьте заголовок Authorization: Bearer skyf_ВАШ_ТОКЕН (если поле для заголовков недоступно в вашем плане — используйте Claude Code или любой MCP-клиент с поддержкой кастомных заголовков).

Любой другой MCP-клиент — конфиг вида:

{
  "mcpServers": {
    "skyforge": {
      "type": "http",
      "url": "https://skyforgeapp.com/mcp",
      "headers": {
        "Authorization": "Bearer skyf_ВАШ_ТОКЕН"
      }
    }
  }
}

Что умеет ассистент

Полный перечень инструментов сервера — ниже, по разделам. Один инструмент — одна строка: что делает и какой скоуп токена нужен. Таблицы сверяются с реальным набором инструментов сервера автоматически, поэтому устаревшей строки или пропущенного инструмента здесь быть не должно.

Инструменты нескольких разделов работают, только если раздел включён вам лично (иначе инструмент отвечает отказом, а не пустым списком): Хранилище (vault_*), v2-дизайнер, Аэродинамическая труба, INAV (пресеты и сетапы), витрина моделей (list_gallery_releases, get_gallery_release, list_my_gallery_downloads), проверка связки (check_powertrain_linkage) и подбор винтов (plan_powertrain_by_intent).

Ангар: борта и модели

События полёта

Склад комплектующих

Аккумуляторы, полётные контроллеры, регуляторы

Траты, обслуживание, профиль

INAV, калькулятор винта и подбор винтомоторной группы

Логи

Хранилище

v2-дизайнер (по флагу designer_v2.editor)

Аэродинамическая труба (по флагу wind_tunnel)

Витрина моделей

Администратору платформы

Отдельный набор инструментов есть у администратора платформы: они требуют токена со скоупом admin, обычному токену отвечают отказом missing_scope.

Сохранение нового пресета/сетапа, переименование, смена зоны и удаление пока доступны только через веб-интерфейс (раздел INAV, вкладка «Импорт диффа» / «Библиотека») — ИИ-ассистент может их только просматривать.

Хранилище сегодня видно только администраторам платформы (переключатель функции vault) — инструменты vault_* работают, только если раздел включён вам лично. У ассистента нет безвозвратного удаления файла (удалённое уходит в корзину на 30 дней и до очистки корзины продолжает занимать место; очищает корзину человек на её странице), удаления карточки и правки её заголовка. Файл больше ~8 МБ агент не загрузит и не вложит в ответ — для крупных файлов веб-форма карточки и прямая ссылка на скачивание.

Логи аппаратуры ассистент показывает и подписывает, но не грузит и не строит по ним графики: сам CSV идёт через веб-форму (файл бывает в сотни мегабайт), а значения сигналов — это десятки тысяч чисел на график, то есть материал для экрана, а не для ответа в чате.

Витрина моделей — каталог моделей SkyForge: издания на ней размещает только администратор платформы. Смотреть витрину может токен со скоупом read, но только если раздел витрины открыт вашей учётной записи (иначе — отказ).

Большие вложения (blackbox-логи, видео)

upload_event_attachment передаёт файл через тот же чат-канал, что и весь остальной диалог с Claude — поэтому у него небольшой потолок (по умолчанию ~8 МБ). Фото и короткие логи укладываются легко; длинный blackbox-лог (20–50+ МБ) или видео — нет. Для них Claude (если у него есть доступ к терминалу, как в Claude Code) может вызвать напрямую:

curl -sX POST https://skyforgeapp.com/api/incidents/СОБЫТИЕ_ID/attachments \
  -H "Authorization: Bearer skyf_ВАШ_ТОКЕН" \
  -F "file=@/путь/к/логу.bin"

Тем же токеном, что и у MCP — заводить отдельный ключ не нужно. Если инструмент отказал файл со ссылкой на «потолок инлайн-передачи через MCP», это ожидаемо — переходите на команду выше.

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

• Ошибка missing_scope: ... — токену не хватает права: добавьте скоуп в Настройки → API-токены.
• 401 — токен просрочен или отозван: создайте новый.

Подсказки «ИИ» и страница «Автоматизация с ИИ»

На экранах, рутину которых умеет ассистент (Ангар и карточка борта, Модели, Склад, События полёта, Хранилище, Аэродинамическая труба, просмотр логов), в углу панели стоит маленький значок ИИ — он ведёт на страницу Автоматизация с ИИ со списком того, что ассистент делает за вас на этом экране. Значок скрывается крестиком; вернуть скрытые подсказки можно кнопкой на той же странице.

Примеры просьб

• «Импортируй модель по ссылке … и заведи её в каталог.»
• «Заведи борт „Ворон-2“ на модели Raven 1.6 в моём Ангаре.»
• «Заведи событие: полная потеря на посадке, обрыв тяги.»
• «Добавь на склад 4 мотора T-Motor 2207, лежат в коробке №3.»
• «Сколько у меня моторов 2207 и где они лежат?»
• «Покажи мои сохранённые INAV-пресеты для зоны OSD.»

Выдавайте токену ровно те права, что нужны для ваших просьб: для «покажи» достаточно read.

ИИ внутри платформы

Кроме MCP, ИИ работает и внутри самих разделов:

• Импорт модели по ссылке — в разделе Модели вставьте URL страницы производителя: ИИ сам заполнит карточку — название, характеристики, фотографии. Останется проверить и сохранить.
• Сводный разбор событий (ИИ) — на странице События полёта ИИ анализирует весь ваш журнал сразу: повторяющиеся причины, паттерны, практические выводы.
• Разбор ИИ отдельного события — в карточке события ассистент предложит вероятные причины и меры по описанию случая.