Справочник элементов

Аудит MCP-сервера

Аудит MCP-сервера ​

Аудит MCP-сервера - один запуск полного набора проверок над одним сервером проекта. Аудит хранит итог: какие утилиты прошли, какие проверки выполнены, нарушены или не проверены, и детали каждой проверки. Аудит не меняется после завершения: новый результат - новый аудит.

Связи ​

Связанный элементКак связан
ПроектОбязательный владелец
MCP-серверОбязательный. Аудит проверяет один сервер. Удаление сервера удаляет его аудиты
Утилита аудитаОдна строка на утилиту. Появляются, когда аудит завершён
Проверка аудитаОдна строка на проверку утилиты
АвторУчастник команды, который запустил аудит

Поля ​

НазваниеТехническое имяТипОбязательноеВалидацияПо умолчанию
IDmcp_audit_run_idintegerДа--
MCP Сервер IDmcp_server_idintegerДаАктивный сервер проекта-
Статусmcp_audit_run_statusenumДаСм. перечисленияPENDING
Причинаfailure_reasonstringНетДо 2000 символов. Заполняется у ERROR-
Версия каталога проверокcheck_catalog_versionstringНетmajor.minor.patch. Заполняется у COMPLETED-
Версия runnerrunner_versionstringНетЗаполняется у COMPLETED-
Схема отпечатков инструментовtool_fingerprint_schemeintegerНетЗаполняется, когда аудит записал отпечатки определений-
Авторcreated_by_user_idintegerДа--
Начатоstarted_attimestampНетКогда аудит взят в работу-
Законченоfinished_attimestampНетЗаполняется у COMPLETED-
Созданоcreated_attimestampДа--
Измененоupdated_attimestampДа--

Поля списка аудитов, которые сервер считает при поиске:

НазваниеТехническое имяТипЧто содержит
Проверкиcheck_countsobjecttotal и число проверок по каждому встретившемуся статусу. Без результатов - { total: 0 }
Нарушенияviolation_countintegerСумма нарушений по завершённым утилитам. null - ни одна утилита не завершилась
Замечанияremark_countintegerСумма замечаний по завершённым утилитам
Советыadvice_countintegerСумма советов по завершённым утилитам

Перечисления ​

Статус (mcp_audit_run_status) ​

ЗначениеПодписьСмысл
PENDINGОжидаетСоздан, ждёт свободного исполнителя
IN_PROGRESSИдётИсполнитель взял аудит и обращается к серверу
COMPLETEDЗавершёнРезультат принят и записан
CANCELLEDОтмененоОтменён вручную. Результаты не сохраняются
ERRORОшибкаАудит не завершился. Причина в failure_reason

Правила ​

Переходы статуса ​

Строка - статус до события, столбец - событие.

СтатусВзят в работуРезультат принятОтмена15 минут с запускаОтказ исполненияУдаление
PENDINGIN_PROGRESS-CANCELLEDERRORERRORУдалён
IN_PROGRESSБез изменений: повторная попыткаCOMPLETEDCANCELLEDERRORERRORУдалён, исполнение остановлено
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 перед аудитом не обновляется.

Версия 1.0.0 · Последнее изменение 2026-11-13

Страница не помогла?