ИИ-ассистент и 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) — впишите новый:
старое имя отвечает постоянным редиректом, а MCP работает поверх POST, и
клиент, следующий за редиректом, может потерять тело запроса.

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

В Настройки → API-токены (/settings#api-tokens)
создайте токен пресетом «Для MCP» — это скоупы read +
incidents:write + hangar:write + import + designer:write +
vault:write + profile:write. Лишнее можно снять: без import не будет
импорта модели по URL, без profile: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_ВАШ_ТОКЕН"
      }
    }
  }
}

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

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

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

Большие вложения (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 — токен просрочен или отозван: создайте новый.

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

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

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

См. также

• Обзор платформы
• Журнал событий
• Ангар: модели и борта