Инструкция
Запуск аудита MCP-сервера
Запуск аудита MCP-сервера
Аудит проверяет сохранённый MCP-сервер готовым набором проверок: протокол, авторизацию, каталог, описания, объём определений и их целостность. Для запуска достаточно сервера в проекте: адрес и доступ уже записаны на нём. Аудит не вызывает существующие инструменты сервера и не меняет его данные.
Роль: участник команды с правом записи в проект.
Предварительные требования
- Сервер добавлен в проект, его статус Активен. Добавить MCP-сервер
- У вида доступа Bearer сохранён токен. У вида доступа OAuth сохранено согласие.
- Адрес сервера доступен из интернета. Адреса частных, служебных и локальных сетей аудит отклоняет.
Снимок каталога для аудита не нужен: аудит читает каталог сервера сам.
Порядок
- Откройте проект. В меню проекта выберите MCP Testing > Аудиты.
- Нажмите Запустить аудит. Откроется диалог Запуск аудита.
- В поле MCP-сервер выберите сервер. В списке только активные серверы проекта. Если такой сервер один, он уже выбран.
- Нажмите Запустить. Откроется карточка нового аудита в статусе Ожидает.
- Нажмите Обновить, чтобы увидеть ход. Карточка сама не обновляется.
Когда статус станет Завершён, на карточке появятся вкладка Итог и вкладка каждой утилиты. Чтение результата аудита
Запуск с карточки сервера
Откройте MCP Testing > MCP-серверы, затем сервер. Нажмите Запустить аудит в шапке карточки. Аудит этого сервера стартует без диалога, открывается его карточка.
Повторный аудит
На карточке аудита в статусе Завершён, Отменено или Ошибка нажмите Запустить снова. Создаётся новый аудит того же сервера, открывается его карточка. Прежний аудит остаётся в списке.
Утилита «Целостность определений» сравнивает определения инструментов с последним завершённым аудитом того же сервера: что добавлено, удалено и изменено. У первого аудита сервера проверки сравнения получают статус Неприменимо с причиной «нет прошлого аудита этого сервера с отпечатками».
Отмена
У аудита в статусе Ожидает или Идёт нажмите Отменить. Статус сразу становится Отменено. Результаты отменённого аудита не сохраняются.
Удаление
Нажмите Удалить на карточке аудита и подтвердите. Аудит удаляется в любом статусе вместе со всеми результатами. Идущий аудит при удалении останавливается.
Несколько аудитов удаляются со списка: отметьте строки и выберите действие на панели. Выбранные строки таблицы
Удаление сервера или проекта удаляет и аудиты этого сервера.
Что аудит отправляет серверу
Запросы идут из сети ComplexQA, из одной точки. Заголовок User-Agent - ComplexQA-MCP-Testing-Runner/ и версия сервиса, имя клиента в протоколе - ComplexQA. Если журнал сервера показывает ошибки на эти запросы, это ожидаемое поведение аудита.
- Обнаружение
server/discover, рукопожатиеinitializeи чтение списков инструментов, ресурсов, шаблонов ресурсов и промптов со всеми страницами. Список инструментов читается дважды подряд: так проверяется стабильность порядка и состава. - Запросы с намеренными нарушениями: несуществующая версия протокола, несуществующий метод, запрос без возможностей клиента, расхождение заголовков и тела, запрос без заголовка версии, недопустимый курсор,
GETиDELETEк конечной точке. - Вызов несуществующего инструмента и запрос несуществующего промпта с именем
complexqa_audit_и 32 случайных шестнадцатеричных символа. Чтение несуществующего ресурсаcomplexqa-audit://nonexistent/с тем же хвостом. - Запрос без токена и запрос с заведомо недействительным токеном. Чтение метаданных защищённого ресурса и метаданных до трёх серверов авторизации по известным адресам.
- Соединение TLS: версия протокола и срок действия сертификата.
Отказ запуска
Диалог ошибки называет причину текстом сервера.
| Текст | Что сделать |
|---|---|
server was not found | Сервер удалён или принадлежит другой команде. Откройте актуальный список серверов |
server is not ACTIVE | Верните серверу статус Активен |
bearer access was not found | Сохраните токен на карточке сервера |
oauth access is not ACTIVE | На карточке сервера нажмите Согласие и подтвердите доступ |
the previous audit of this server is not finished | У сервера уже есть аудит в статусе Ожидает или Идёт. Дождитесь его, отмените или удалите |
Ограничения
- У одного сервера одновременно не больше одного незавершённого аудита.
- Аудит, который не завершился за 15 минут с момента запуска, получает статус Ошибка с причиной
audit did not finish within 900 seconds. - Пределы одного обращения к серверу: соединение 5 секунд, ответ 15 секунд, тело ответа 4 МБ, не больше 3 перенаправлений. Проверка, которой помешал предел, получает статус Не удалось проверить, а не Не выполнено.
- Истёкший токен доступа OAuth аудит не обновляет: проверки получат причину «Авторизация отклонена (401 либо 403)». Перед запуском посмотрите Токен доступа истекает в блоке Согласие на карточке сервера. Если срок вышел, нажмите Согласие ещё раз.
- Утилита «Соответствие протоколу» проверяет современную эпоху протокола: ревизию
2026-07-28и обнаружениеserver/discover. Сервер только прежней эпохи получает по этой утилите статус Неприменимо. - Сервер, который работает только через транспорт HTTP+SSE, проходит одну утилиту «Паспорт сервера». Остальные утилиты получают статус Неприменимо.
- Аудит запускается вручную, расписания у аудита нет. Ключ MCP аудит не запускает и не читает: аудит доступен только в экранах проекта.
Страница не помогла?