Справочник элементов
Аудит MCP-сервера
Аудит MCP-сервера
Аудит MCP-сервера - один запуск полного набора проверок над одним сервером проекта. Аудит хранит итог: какие утилиты прошли, какие проверки выполнены, нарушены или не проверены, и детали каждой проверки. Аудит не меняется после завершения: новый результат - новый аудит.
Связи
| Связанный элемент | Как связан |
|---|---|
| Проект | Обязательный владелец |
| MCP-сервер | Обязательный. Аудит проверяет один сервер. Удаление сервера удаляет его аудиты |
| Утилита аудита | Одна строка на утилиту. Появляются, когда аудит завершён |
| Проверка аудита | Одна строка на проверку утилиты |
| Автор | Участник команды, который запустил аудит |
Поля
| Название | Техническое имя | Тип | Обязательное | Валидация | По умолчанию |
|---|---|---|---|---|---|
| ID | mcp_audit_run_id | integer | Да | - | - |
| MCP Сервер ID | mcp_server_id | integer | Да | Активный сервер проекта | - |
| Статус | mcp_audit_run_status | enum | Да | См. перечисления | PENDING |
| Причина | failure_reason | string | Нет | До 2000 символов. Заполняется у ERROR | - |
| Версия каталога проверок | check_catalog_version | string | Нет | major.minor.patch. Заполняется у COMPLETED | - |
| Версия runner | runner_version | string | Нет | Заполняется у COMPLETED | - |
| Схема отпечатков инструментов | tool_fingerprint_scheme | integer | Нет | Заполняется, когда аудит записал отпечатки определений | - |
| Автор | created_by_user_id | integer | Да | - | - |
| Начато | started_at | timestamp | Нет | Когда аудит взят в работу | - |
| Закончено | finished_at | timestamp | Нет | Заполняется у COMPLETED | - |
| Создано | created_at | timestamp | Да | - | - |
| Изменено | updated_at | timestamp | Да | - | - |
Поля списка аудитов, которые сервер считает при поиске:
| Название | Техническое имя | Тип | Что содержит |
|---|---|---|---|
| Проверки | check_counts | object | total и число проверок по каждому встретившемуся статусу. Без результатов - { total: 0 } |
| Нарушения | violation_count | integer | Сумма нарушений по завершённым утилитам. null - ни одна утилита не завершилась |
| Замечания | remark_count | integer | Сумма замечаний по завершённым утилитам |
| Советы | advice_count | integer | Сумма советов по завершённым утилитам |
Перечисления
Статус (mcp_audit_run_status)
| Значение | Подпись | Смысл |
|---|---|---|
PENDING | Ожидает | Создан, ждёт свободного исполнителя |
IN_PROGRESS | Идёт | Исполнитель взял аудит и обращается к серверу |
COMPLETED | Завершён | Результат принят и записан |
CANCELLED | Отменено | Отменён вручную. Результаты не сохраняются |
ERROR | Ошибка | Аудит не завершился. Причина в failure_reason |
Правила
Переходы статуса
Строка - статус до события, столбец - событие.
| Статус | Взят в работу | Результат принят | Отмена | 15 минут с запуска | Отказ исполнения | Удаление |
|---|---|---|---|---|---|---|
PENDING | IN_PROGRESS | - | CANCELLED | ERROR | ERROR | Удалён |
IN_PROGRESS | Без изменений: повторная попытка | COMPLETED | CANCELLED | ERROR | ERROR | Удалён, исполнение остановлено |
COMPLETED | - | Без изменений | Без изменений | - | - | Удалён |
CANCELLED | - | Без изменений, строки не пишутся | Без изменений | - | - | Удалён |
ERROR | - | Без изменений, строки не пишутся | Без изменений | - | - | Удалён |
Прочерк - событие в этом статусе не происходит. Конечные статусы COMPLETED, CANCELLED, ERROR не меняются.
Если исполнитель пропал во время аудита, аудит отдаётся другому исполнителю ещё один раз. Всего попыток две.
Причины ошибки
Начало failure_reason | Когда |
|---|---|
audit did not finish within 900 seconds | Аудит не завершился за 15 минут с момента запуска |
CREDENTIAL_UNAVAILABLE: | Исполнитель не получил доступ к серверу |
JOB_INPUT_REJECTED: | К моменту исполнения сервер удалён или отключён, адрес не https://, нет токена Bearer, согласие OAuth не активно или без токена |
RESULT_REJECTED: | Результат не прошёл проверку перед записью |
LEASE_EXPIRED: | Исполнитель дважды пропал, попытки кончились |
Запуск
- Аудит запускает участник команды с правом записи. Сервер должен быть
ACTIVE, у вида доступа Bearer - сохранённый токен, у OAuth - активное согласие. - У сервера не больше одного аудита в статусе
PENDINGилиIN_PROGRESS. Незавершённый аудит старше 15 минут получаетERRORперед новым запуском. - Аудит исполняет все утилиты каталога за один заход. Состав утилит задаёт сервис аудита.
Счётчики
- Нарушения - проверки
FAILEDуровняREQUIREMENT. - Замечания - проверки
FAILEDуровнейRECOMMENDATIONиCONSISTENCY. - Советы - проверки
FAILEDуровняPRACTICE. - Счётчики аудита - сумма по утилитам
COMPLETED.
Сравнение с прошлым аудитом
Аудит записывает отпечатки определений инструментов. Следующий аудит того же сервера в этой команде сравнивает с ними текущие определения. База сравнения - последний аудит COMPLETED, который записал отпечатки. Аудит без отпечатков, CANCELLED и ERROR базой не становятся.
Удаление
Аудит удаляется в любом статусе вместе с утилитами, проверками, деталями и отпечатками. Удаление сервера или проекта удаляет аудиты сервера.
Ограничения
- Аудит не правится: у него нет редактируемых полей и клонирования.
- Карточка не обновляется сама: свежее состояние - по кнопке Обновить.
- Ключ MCP к аудиту доступа не даёт.
- Истёкший токен OAuth перед аудитом не обновляется.
Страница не помогла?