Пусть ваш ИИ-агент читает баг-репорты

MCP

Вот процесс, который ещё недавно считался нормальным.

Приходит баг-репорт. Вы открываете веб-интерфейс, читаете отчёт, находите ошибку в консоли, копируете её. Переключаетесь в редактор, вставляете в Claude Code, добавляете контекст. Агент спрашивает, что вернул запрос. Назад в веб-интерфейс, найти сетевой лог, скопировать ответ, вставить. И так далее.

Вы работаете буфером обмена. Агент рассуждает, а вы перевозите данные между двумя системами, которые могли бы общаться напрямую.

Так что я их соединил.

MCP-сервер

У BugDump есть сервер Model Context Protocol. Подключите его к Claude Code, и агент будет читать ваши баг-репорты напрямую. Инструментов семь:

Инструмент

Что возвращает

get_current_project

Проект, к которому привязан ключ

list_tasks

Задачи, чтобы найти нужную

get_task

Одну задачу по публичному ID или ID задачи

get_task_activity

Историю задачи

list_reports_for_task

Отчёты, привязанные к задаче

get_report

Один отчёт: консоль, сеть, скриншоты

get_report_telemetry

Всю телеметрию, постранично

Весь процесс сжимается до одной фразы:

Посмотри задачу #42 в BugDump и исправь её.

Агент читает задачу, достаёт привязанные отчёты, сопоставляет ошибку в консоли с упавшим запросом, находит нужный код в вашем репозитории и предлагает исправление. Веб-интерфейс вы так и не открываете.

Почему это лучше, чем копировать и вставлять

Очевидная польза — вы перестаёте быть буфером обмена. Есть ещё две, менее очевидные.

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

Агент сравнивает отчёты между собой. Спросите, какие браузеры затронуты в задаче #17, и агент прочитает все привязанные отчёты и ответит. Это по-настоящему нудная работа — та, которую при ручном разборе пропускают и которая за десять секунд, а не за полдня показывает, что баг проявляется только в одном браузере.

Два решения, на которых всё держится

Работу сервера определили два решения.

Ключ навсегда привязан к одному проекту. Ни у одного инструмента нет параметра проекта. Область действия MCP-ключа задаётся при создании, и расширить её потом нельзя. Когда вы отдаёте ключ автономному агенту, «этот ключ никогда не увидит больше одного проекта» — гарантия куда сильнее, чем «агенту сказали смотреть только в один проект».

Ещё MCP-ключи только читают и отделены от ключей виджета. Ключ из вашего фронтенда не может читать отчёты, а ключ, который их читает, никогда не попадает в браузер.

По умолчанию сводка, полная телеметрия — по запросу. get_report возвращает последние 50 записей консоли и сетевые запросы без тел. В отчёте могут быть тысячи записей, и если при каждом обращении вываливать их все в контекстное окно, получится агент, который всё прочитал и ничего не понял.

Но обрезка, которая себя скрывает, хуже, чем никакой. Поэтому сводка сообщает, что из неё вырезано, а get_report_telemetry постранично отдаёт всю историю — консоль, сеть с телами, действия — порциями в хронологическом порядке, пока данные не кончатся.

Главное правило: если в сводке ничего нет, это не доказательство, что ничего нет.

Промпты, которые работают

Посмотри задачу #42 в BugDump и исправь её.

Что общего у открытых задач в BugDump?

Прочитай отчёты по #17 и скажи, какие браузеры затронуты.

Проверь задачу #8 — это тот же баг, что и #3?

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

Полный отчёт годится и для человека, и для агента

Сначала я сделал слой сбора данных, потому что проблемой были неполные баг-репорты. MCP-сервер в планах не значился: что он нужен, стало очевидно потом.

Полный отчёт — консоль, сеть, действия, воспроизведение, окружение — оказался хорошо оформленными входными данными для агента. А агент не может задать уточняющий вопрос. Он не напишет пользователю, чтобы спросить, каким браузером тот пользовался. У него одна попытка разобраться в уликах.

Значит, то, что делает отчёт хорошим для человека, делает его пригодным и для машины: собирать всё в тот момент, когда это происходит, ни о чём не спрашивая.

Сделав это как следует, я получил пользу, на которую не рассчитывал.

Обновление, октябрь 2026: доступ к MCP теперь есть на всех тарифах, включая бесплатный, а Claude, ChatGPT и VS Code подключаются через вход в аккаунт — см. Как подключить Claude, ChatGPT или VS Code к BugDump.

Читайте также