Работа MCP-инструмента
Проверка следит за тем, что MCP-сервер, из которого ваш агент берёт инструменты, отвечает и нужный инструмент на месте. Сервер при этом обычно жив: чаще меняется его начинка — инструмент переименовали или убрали из выдачи. Обычная HTTP-проверка увидит работающий адрес и ничего из этого не заметит.
Что именно проверять
Выбирается одна ступень, а не набор отметок: они вложены — «инструмент есть» без «сервер отвечает» не бывает. Первые две ступени ничего на сервере не выполняют и стоят одинаково, поэтому начинать стоит со второй: она и есть то, ради чего проверка заводится.
| Ступень | Что проверяется | Цена |
|---|---|---|
| Сервер отвечает | Сервер принял запрос и ответ разобран. Ловит недоступный сервер, неверный адрес и отвергнутый токен, а при явно выбранной версии протокола — и переезд сервера на другую. | Бесплатно |
| Инструмент есть у сервера | В списке инструментов сервера есть указанный вами. Ловит переименованный, убранный из выдачи или скрытый правами инструмент — то, что случается заметно чаще, чем падение самого сервера. | Бесплатно |
| Инструмент выполняется | Инструмент вызывается с заданными вами аргументами и отвечает без ошибки. Ловит то, чего список не видит: инструмент на месте, но сломано то, за чем он ходит, — база, внешний API, права. | Настоящий вызов при каждой проверке |
Поля формы
| Поле | Что означает | Что указать | Пример |
|---|---|---|---|
| Название | Имя проверки. | Укажите, какой сервер и для чего вам важен. | 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 часа между повторами). Подходит, когда важно не пропустить затяжной сбой. |