Работа MCP-инструмента

Проверка следит за тем, что MCP-сервер, из которого ваш агент берёт инструменты, отвечает и нужный инструмент на месте. Сервер при этом обычно жив: чаще меняется его начинка — инструмент переименовали или убрали из выдачи. Обычная HTTP-проверка увидит работающий адрес и ничего из этого не заметит.

Что именно проверять

Выбирается одна ступень, а не набор отметок: они вложены — «инструмент есть» без «сервер отвечает» не бывает. Первые две ступени ничего на сервере не выполняют и стоят одинаково, поэтому начинать стоит со второй: она и есть то, ради чего проверка заводится.

Ступень Что проверяется Цена
Сервер отвечает Сервер принял запрос и ответ разобран. Ловит недоступный сервер, неверный адрес и отвергнутый токен, а при явно выбранной версии протокола — и переезд сервера на другую. Бесплатно
Инструмент есть у сервера В списке инструментов сервера есть указанный вами. Ловит переименованный, убранный из выдачи или скрытый правами инструмент — то, что случается заметно чаще, чем падение самого сервера. Бесплатно
Инструмент выполняется Инструмент вызывается с заданными вами аргументами и отвечает без ошибки. Ловит то, чего список не видит: инструмент на месте, но сломано то, за чем он ходит, — база, внешний API, права. Настоящий вызов при каждой проверке
Третья ступень вызывает инструмент по-настоящему. Вызов инструмента — это действие. Мониторинг, который каждые пять минут отправляет письмо или создаёт тикет, устроит тихую катастрофу, причём сам при этом будет «работать». Поэтому ступень выключена по умолчанию, и выбирать для неё стоит только читающий инструмент — поиск, чтение, справку. Отличить читающий инструмент от меняющего по его описанию мы не можем, так что выбор остаётся за вами.
Версия протокола — автоматически или ваша. По умолчанию версию мы определяем сами на каждой проверке: годится любая, которую держит сервер. Этого достаточно, если вам важно, чтобы инструмент отвечал. Но автоопределение молча следует за сервером: тот переехал на новую ревизию, проверка подстроилась и показывает «работает» — а ваше приложение, рассчитанное на прежнюю версию, в этот момент уже сломано. Если ваш код привязан к конкретной версии, выберите её: тогда переезд сервера станет отказом, о котором вы узнаете. Не поддержав выбранную версию, сервер назовёт свои, и мы покажем их в причине проверки.
Следим только за HTTP. MCP-серверы бывают локальными — те, что редактор или агент запускает у вас на машине и разговаривает с ними через стандартный ввод-вывод. До такого сервера снаружи не дотянуться никому, в том числе нам. Следить можно за сервером, доступным по адресу из интернета.
Устаревший транспорт не поддерживается. Самая первая редакция протокола, 2024-11-05, работала иначе: сервер держал отдельный поток событий и отдельный адрес для сообщений. Её объявили устаревшей ещё весной 2025 года, и в списке версий её нет. Если ваш адрес отвечает по ней, проверка скажет об этом прямо — адрес не принимает обычные запросы MCP.

Поля формы

Поле Что означает Что указать Пример
Название Имя проверки. Укажите, какой сервер и для чего вам важен. MCP поиска по базе
Группа Позволяет отнести задачу к проекту или разделу. Выберите группу, если хотите держать задачи по проекту вместе. Основной проект
Адрес сервера Адрес MCP-эндпоинта — того самого, который вы прописываете в настройках агента. Впишите адрес целиком, вместе с путём. Обычно путь заканчивается на /mcp, но он может быть любым. https://example.com/mcp
Версия протокола Редакция MCP, на которую рассчитан ваш код, либо «Автоматически» — любая, которую держит сервер. Оставьте «Автоматически», если важно лишь, чтобы инструмент отвечал. Выберите ту же версию, что объявляет ваш клиент, если хотите узнать о переезде сервера на другую. Автоматически
Токен Bearer-токен, если сервер закрыт авторизацией. Оставьте пустым, если сервер открыт. При изменении задачи пустое поле означает «оставить прежний токен»; при переезде на другой хост прежний токен не переносится — новому адресату мы его не отправим. Токен из настроек сервера
Что проверять Ступень проверки из описанных выше. Берите вторую: она ничего не выполняет на сервере, как и первая, и отвечает на вопрос, ради которого проверка заводится. Третью — только для читающего инструмента. Инструмент есть у сервера
Инструмент Имя инструмента, за которым следим. Спрашивается со второй ступени. Укажите его ровно так, как сервер отдаёт его в списке инструментов: сверка строгая. Это то же имя, которым инструмент вызывают, а не его описание. search_documents
Аргументы С чем вызывать инструмент. Спрашиваются только на третьей ступени. Объект JSON в том виде, в каком инструмент ждёт аргументы. Подберите безобидный запрос, на который инструмент гарантированно ответит. Пустое поле — вызов без аргументов. {"query": "test"}
Время ожидания Сколько отведено на проверку целиком, на любой ступени. Проверка дольше указанного времени считается отказом: сервер, который отвечает, но медленно, тоже неисправен. Ориентируйтесь на то, сколько сервер обычно отвечает у вас, с запасом. 30 секунд
Интервал Как часто выполнять проверку. На первых двух ступенях — как вам удобно, разумная частота — пять минут. На третьей — от 15 минут: каждая проверка вызывает инструмент. 5 минут
Каналы уведомлений Куда отправлять сообщения о проблеме и восстановлении. Отметьте каналы, в которых вы реально читаете уведомления. Telegram и email
Отчёты Периодические сводки по задаче. Включите, если хотите получать обзор без ручного входа в панель. Еженедельный отчёт

Когда придёт тревога

Тревога придёт, если выбранная проверка не прошла:

  • сервер недоступен, ответил ошибкой или отверг токен;
  • сервер не поддерживает выбранную версию протокола — в причине будут перечислены те, что он поддерживает;
  • по адресу отвечает не MCP-сервер либо сервер на устаревшем транспорте;
  • указанного инструмента нет в списке — на второй и третьей ступенях;
  • инструмент выполнился с ошибкой или вместо результата попросил ввода — на третьей ступени;
  • проверка целиком заняла дольше времени ожидания — на любой ступени.

Когда проверка пропускается

Если сервер попросил обращаться реже, задача не падает и не поднимается — проверка пропускается, а статус остаётся прежним. Это единственный такой случай: ограничение частоты говорит о нашей собственной назойливости, а не о вашем сервере. Всё остальное — молчащая сеть, ошибка сервера, отвергнутый токен — для этой задачи и означает, что инструментом сейчас не воспользоваться.

Одна задача — один инструмент

Следить за тремя инструментами одного сервера — это три задачи. Так у каждой свой аптайм и своя история: смешав несколько вопросов в одной задаче, вы получите аптайм, про который непонятно, чей он. Если инструменты важны одинаково, соберите задачи в группу.

Настройка уведомлений

Для каждого канала уведомлений в задаче можно задать дополнительные параметры. Они действуют только для DOWN-событий.

Параметр Что делает
Включён Разрешает или запрещает отправку уведомлений по этому каналу для данной задачи.
Отложить на PRO Задерживает первое уведомление о DOWN на выбранное время (до 12 часов). Удобно, чтобы не получать оповещения о кратковременных сбоях.
Повторять через PRO Периодически повторяет уведомление, пока задача остаётся в статусе DOWN (до 1 часа между повторами). Подходит, когда важно не пропустить затяжной сбой.
Параметры «Отложить» и «Повторять» не влияют на UP-события и уведомления о восстановлении.
К списку типов задач