Инструкция

Запуск аудита MCP-сервера

Запуск аудита MCP-сервера ​

Аудит проверяет сохранённый MCP-сервер готовым набором проверок: протокол, авторизацию, каталог, описания, объём определений и их целостность. Для запуска достаточно сервера в проекте: адрес и доступ уже записаны на нём. Аудит не вызывает существующие инструменты сервера и не меняет его данные.

Роль: участник команды с правом записи в проект.

Предварительные требования ​

  1. Сервер добавлен в проект, его статус Активен. Добавить MCP-сервер
  2. У вида доступа Bearer сохранён токен. У вида доступа OAuth сохранено согласие.
  3. Адрес сервера доступен из интернета. Адреса частных, служебных и локальных сетей аудит отклоняет.

Снимок каталога для аудита не нужен: аудит читает каталог сервера сам.

Порядок ​

  1. Откройте проект. В меню проекта выберите MCP Testing > Аудиты.
  2. Нажмите Запустить аудит. Откроется диалог Запуск аудита.
  3. В поле MCP-сервер выберите сервер. В списке только активные серверы проекта. Если такой сервер один, он уже выбран.
  4. Нажмите Запустить. Откроется карточка нового аудита в статусе Ожидает.
  5. Нажмите Обновить, чтобы увидеть ход. Карточка сама не обновляется.

Когда статус станет Завершён, на карточке появятся вкладка Итог и вкладка каждой утилиты. Чтение результата аудита

Запуск с карточки сервера ​

Откройте 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 аудит не запускает и не читает: аудит доступен только в экранах проекта.

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

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