Справочник элементов
Утилита аудита
Утилита аудита
Утилита аудита - тематический блок проверок внутри аудита: например, «Соответствие протоколу» или «Авторизация». На карточке аудита у каждой утилиты своя вкладка. Строка утилиты хранит её статус и счётчики находок.
Связи
| Связанный элемент | Как связан |
|---|---|
| Аудит MCP-сервера | Обязательный владелец. Одна строка на утилиту, состав задаёт сервис аудита |
| Проверка аудита | Одна строка на проверку. У утилиты ERROR и NOT_APPLICABLE проверок нет |
Поля
| Название | Техническое имя | Тип | Обязательное | Валидация | По умолчанию |
|---|---|---|---|---|---|
| ID | mcp_audit_run_utility_id | integer | Да | - | - |
| Аудит ID | mcp_audit_run_id | integer | Да | - | - |
| Утилита | audit_utility_key | string | Да | См. перечисления | - |
| Статус утилиты | audit_utility_status | enum | Да | См. перечисления | - |
| Причина | failure_reason | string | Нет | Заполняется у ERROR | - |
| Нарушения | violation_count | integer | Нет | Заполняется у COMPLETED | - |
| Замечания | remark_count | integer | Нет | Заполняется у COMPLETED | - |
| Советы | advice_count | integer | Нет | Заполняется у COMPLETED | - |
| Создано | created_at | timestamp | Да | - | - |
| Изменено | updated_at | timestamp | Да | - | - |
Перечисления
Утилита (audit_utility_key)
Порядок строк - порядок аудита и вкладок на карточке.
| Значение | Подпись | Что проверяет | Проверок |
|---|---|---|---|
SERVER_PASSPORT | Паспорт сервера | Эпоха и ревизии протокола, транспорт, имя и версия, возможности, размер каталога, время ответа, защита соединения | 10 |
PROTOCOL_CONFORMANCE | Соответствие протоколу | Поведение по спецификации MCP современной эпохи: обнаружение, версии, заголовки, ошибки, списки, кэш, пагинация | 34 |
AUTHORIZATION | Авторизация | Ответ без токена и с недействительным токеном, метаданные защищённого ресурса и серверов авторизации, PKCE, области доступа | 16 |
CATALOG_CORRECTNESS | Корректность каталога | Имена, схемы JSON Schema, ресурсы, шаблоны ресурсов, промпты, совместимость имён с провайдерами моделей | 22 |
DESCRIPTION_COMPLETENESS | Полнота и единообразие описаний | Описания инструментов и параметров, типы параметров, стиль имён, письменность описаний | 9 |
CONTEXT_VOLUME | Объём | Размер определений в символах, байтах и токенах, доля окна контекста, глубина схем, размер ответов списков, кэширование | 8 |
DEFINITION_INTEGRITY | Целостность определений | Невидимые символы, секреты, адреса в описаниях, отпечатки определений, изменения с прошлого аудита | 7 |
Число проверок по уровням нормы:
| Утилита | Требование | Рекомендация | Согласованность | Практика | Сведение | Всего |
|---|---|---|---|---|---|---|
| Паспорт сервера | 0 | 1 | 0 | 1 | 8 | 10 |
| Соответствие протоколу | 20 | 10 | 4 | 0 | 0 | 34 |
| Авторизация | 9 | 4 | 1 | 0 | 2 | 16 |
| Корректность каталога | 7 | 4 | 4 | 4 | 3 | 22 |
| Полнота и единообразие описаний | 0 | 0 | 4 | 5 | 0 | 9 |
| Объём | 0 | 0 | 0 | 0 | 8 | 8 |
| Целостность определений | 0 | 0 | 0 | 3 | 4 | 7 |
| Всего | 36 | 19 | 13 | 13 | 25 | 106 |
Каталог проверок - версия 1.7.0. Версия каталога, по которому прошёл аудит, записана в аудите.
Статус утилиты (audit_utility_status)
| Значение | Подпись | Смысл |
|---|---|---|
COMPLETED | Завершена | Все проверки утилиты получили статус. Среди них могут быть Не удалось проверить |
NOT_APPLICABLE | Неприменимо | Утилита к этому серверу не относится. Проверок нет |
ERROR | Ошибка | Утилита прервалась. Проверок нет, причина в failure_reason. Остальные утилиты аудита продолжаются |
PENDING | Ожидает | В текущей версии не используется: строка утилиты появляется сразу с итоговым статусом |
Правила
- Утилита
NOT_APPLICABLE, когда сервер работает только через транспорт HTTP+SSE: так для всех утилит, кроме «Паспорт сервера». - «Соответствие протоколу» ещё
NOT_APPLICABLE, когда сервер поддерживает только прежнюю эпоху протокола (без обнаруженияserver/discoverи ревизии2026-07-28). - «Паспорт сервера» выполняется всегда.
- Если сервер не ответил ни одним известным способом MCP, утилита завершается, а все её проверки получают Не удалось проверить с причиной.
- Счётчики: нарушения - проверки
FAILEDуровняREQUIREMENT; замечания -FAILEDуровнейRECOMMENDATIONиCONSISTENCY; советы -FAILEDуровняPRACTICE.
Ограничения
- Состав утилит в аудите выбрать нельзя: аудит исполняет все утилиты каталога.
- Проверка соответствия протоколу для прежней эпохи (ревизии
2025-11-25и старше) в каталог не входит.
Страница не помогла?