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

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

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

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

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

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

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

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

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

В Настройки → API-токены (/settings#api-tokens)
создайте токен пресетом «Для MCP» — это скоупы read +
incidents:write + hangar:write + import. Если импорт по URL не нужен,
снимите import; для read-only ассистента достаточно read.

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

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

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

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

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

Claude Desktop / claude.ai (custom connector):

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

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

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

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

Действие	Инструмент	Скоуп
Показать ваши борта	`list_my_aircraft`	`read`
Найти модель в каталоге	`list_models`	`read`
Занести инцидент в журнал	`create_incident`	`incidents:write`
Завести борт	`create_aircraft`	`hangar:write`
Создать свою модель	`create_model`	`hangar:write`
Импортировать модель по URL	`import_model_by_url`	`import`

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

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

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

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

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