Заявки о сбоях MCP: как AI-агент помогает находить и исправлять ошибки в возможностях BestrankMCP
Если инструмент, ресурс или промпт MCP ведёт себя не так: как оформить заявку из агента или админки, отследить статус и что происходит на стороне команды Bestrank.
Инструмент подключен и настроен, агент старается и делает запросы к MCP, а в результате получаем пустой набор данных там, где в подключенной системе все есть. Или ресурс после одобрения на «Данных портала» наполовину пустой. Раньше это превращалось в «у нас не работает MCP», попытку связаться с разработчиком и оставить заявку. И надеется что ее быстро решат и вам сообщат.
Поверьте, нам это тоже было неудобно.
Мы сделали встроенный трекер заявок о сбоях. Это часть набора инструментов BestrankMCP, которая позволяет оформить прямо из AI-агента сообщение об ошибке или нестандартном поведении запроса. Так же в административном инструменте есть возможность оставить такое сообщение вручную. Про инструменты в целом - Инструменты: чтение и изменение данных; системные возможности - документация «Система».
Что считается «сбоем/ошибкой» и что писать в заявку?
Заявка - это обращение к нашей команде про конкретную возможность MCP:
- инструмент - поиск сделки возвращает не те поля;
- ресурс - справочник пустой после одобрения;
- промпт - сценарий пропускает обязательный шаг.
В заявке автоматически будет указано тип и имя вашего подключения и токена, краткий заголовок и описание: что ожидали, что получили. Если получится, агент подставит и техническую информацию запроса: ID сделки, текст ошибки, шаги воспроизведения.
Чем конкретнее будет составлено сообщение, тем быстрее мы сможем его исправить или просто дать ответ.
Три способа создать заявку
Из AI-агента
На любом продуктовом токене доступен системный инструмент сообщить о проблеме MCP. Агент может вызвать его сам, если пользователь описал сбой, или вы попросите: «оформи заявку на этот инструмент». Иногда, данный инструмент может быть вызван по ходу выполнения какого-то запроса и пользователь даже не узнает, что что-то произошло.
Есть готовый сценарий/промпт разбора ошибки MCP: агент помогает собрать необходимую информацию и отправить заявку без ручного копирования логов.
В административном разделе также можно посмотреть свои заявки по вашему аккаунту, открыть карточку обращения и дописать уточнение
Из интерфейса в административном разделе
На форме токена, когда вы просматриваете инструмент, ресурс или промпт, есть кнопка «Работает неверно». Открывается форма с уже подставленным именем "возможности" и информацией о токене. Просто нужно дописать то, что пошло не так и заявка уйдёт в очередь.
Удобно, когда вы настраиваете токен и сразу видите расхождение между пришедшими данными и данными в вашей системе.
Вручную в разделе «Заявки»
В административном разделе BestrankMCP есть раздел Issues MCP. В нем находится список всех заявок вашего пользователя и форма Создать вручную. Используйте данный инструмент если агент не смог создать заявку или не знаете с какой страницы в интерфейсе это лучше сделать
Статусы: что они значат для вас
Заявка проходит понятную цепочку:
| Статус | Описание |
|---|---|
| Открыта | Принята, ждёт разбора |
| В очереди | Поставлена в план работ |
| В работе | Команда воспроизводит или чинит |
| Ждёт проверки | Исправление готово, нужна проверка |
| Решена | Закрыта успешно |
| Не будет исправлено | Осознанное решение не менять |
| Дубликат | Уже есть другая заявка |
Пользователь не может менять статусы заявок. Смена статуса и заметки доступна только разработчикам команды BestrankMCP.
Когда заявка поменяет статус, например на Решена или Не будет исправлено, то на почту придет уведомление.
Как устроен разбор на нашей стороне
Очень простая последовательность:
- Заявка попадает в очередь с привязкой к провайдеру (Bitrix24, Jira или другая платформа).
- Команда смотрит открытые заявки в Issues MCP или через API или xthtp AI-агенты.
- Воспроизводит по описанию пользователя.
- Если это действительно ошибка, то мы чиним ее и тестируем. Так как API универсальное для всех провайдеров, то значит ошибка существовала у всех, и будет у всех исправлена. На время тестирования заявка переводится в статус Ждёт проверки.
- Если все хорошо и проверка прошла успешно, то статус Ждёт проверки меняется на Решена и пользователю уходит уведомление.
Также у нас есть "антиспам" защита:
- лимит заявок с одного токена в час
- дедупликация похожих заявок за сутки
Это делается для того, чтобы какой-нибудь AI-агент при зацикливании не засыпал команду заявками.
Пример: агент нашёл баг во время пилота
Отдел продаж тестирует токен с CRM. Менеджер просит агента выгрузить историю стадий сделки - инструмент отдаёт пустоту, хотя в карточке история есть.
Пользователь AI говорит агенту: «это похоже на ошибку инструмента, оформи заявку». Агент создаёт заявку с типом "инструмент", именем инструмента и сделанным запросом.
Пользователь через свои заявки видит статус В работе и дописывает: «повторяется на сделках старше года». Разработка анализирует ошибку, находит ошибку в фильтрации объектов по датам и чинит инструмент. Заявка меняет статус на Решена после проверки.
Если бы надо было каждый раз такие заявки писать вручную, то скорее всего данная проблема осталось бы на уровне «ну, иногда глючит» в чате.
Резюме
Трекер заявок превращает «что-то сломалось» в номер, статус и воспроизведение. Агент может оформить заявку сам, пользователь - воспользоваться инструментами интерфейса или вручную. Если инструмент ведёт себя странно, то не мучайте промпты. Оставьте нам заявку. Так будет быстрее для вас лучше для нашего продукта.
Системные инструменты заявок есть на каждом токене. Подключение клиента - Подключение MCP. Описание платформенных возможностей - Система. Спасибо.