Перейти к содержимому

MCP-сервер для баг-репортов, чтобы ваш ИИ-агент сам читал репорт

Обновлено

У Midge есть MCP-сервер для баг-репортов. С ним ИИ-агенты для программирования, например Claude Code и Cursor, читают репорт Midge напрямую: ошибки консоли, сетевые запросы и ответы, клики пользователя и переходы между страницами, данные о браузере. Вместо того чтобы копировать стек-трейс в чат, вы вставляете ссылку на репорт, и агент сам забирает нужные ему части.

Настройка

В Claude Code хватит одной команды:

claude mcp add --transport http midge https://midge.dev/mcp

Когда Claude Code обратится к серверу в первый раз, в браузере откроется midge.dev: войдите, нажмите Allow («Разрешить»), и вы снова в терминале. Cursor и другие клиенты с поддержкой удалённых MCP-серверов подключаются так же, по адресу https://midge.dev/mcp.

Агент, который не может войти через браузер, использует токен: на midge.dev откройте Settings › Account › AI assistants, выберите агента, нажмите Create token и передавайте токен в заголовке Authorization: Bearer <token>.

В обоих случаях агент появится в разделе Connected devices под именем вроде «Claude Code (MCP)». Если выйти из него там, он больше ничего не сможет прочитать. На странице документации есть подробности для каждого клиента.

Инструменты

  • get_recording: с него стоит начинать, когда есть ссылка. Заголовок, описание, страница, устройство и длительность, посещённые страницы, а также первые ошибки консоли и упавшие запросы.
  • get_console: сообщения по порядку, с фильтром по уровню (только ошибки, предупреждения и ошибки или всё подряд), со стек-трейсами и текстовым поиском.
  • get_network: запросы с методом, статусом, типом и таймингами. Можно запросить только упавшие запросы или один эндпоинт, а заголовки и тела — тогда, когда они действительно нужны агенту. Так он читает главное, а не лог на 4 MB.
  • get_user_actions: клики, ввод текста (сам текст никогда), прокрутка и переходы между страницами по порядку — готовая основа для шагов воспроизведения.
  • list_recordings: ваши последние репорты с поиском, на случай если вы не вставили ссылку.

Типичная сессия выглядит так: вы вставляете ссылку на репорт в Claude Code и просите найти причину. Агент читает обзор, запрашивает упавшие запросы вместе с телами, находит 500 от POST /api/orders с ошибкой валидации, читает соответствующую клиентскую ошибку в консоли и открывает обработчик в вашем репозитории.

Что такое MCP

Model Context Protocol — открытый стандарт, который позволяет ИИ-приложениям подключаться к внешним инструментам и данным. Сервер предоставляет набор инструментов, например «получить лог консоли репорта X», а клиент вроде Claude Code или Cursor вызывает их во время работы над задачей. Вы подключаете сервер один раз, а агент сам решает, когда им пользоваться.

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

Доступ и конфиденциальность

Сервер использует те же проверки доступа, что и весь остальной Midge. Агент с вашим токеном может открыть то же, что и вы, и ничего больше: репорт с настройкой «Only me» остаётся только вашим, а репорт рабочего пространства — доступным только его участникам. Чужой репорт, открытый для «Anyone with the link», откроется любому агенту, который вошёл в аккаунт и знает ссылку, — так же, как в браузере. Сервер только читает: он не может ничего изменить, удалить или кому-то отправить.

Репорты очищаются ещё до того, как попадают в Midge. Пароли, номера карт, токены и cookies удаляются на вашем устройстве, прежде чем что-либо его покинет. Агент получает те же очищенные данные, которые увидел бы коллега. Все правила перечислены на странице скрытия данных.

Без MCP

Если ваш агент не умеет работать с MCP, репорт всё равно можно перенести в чат вручную:

  • Скопировать как cURL: откройте упавший запрос в панели сетевых логов и скопируйте его. Заголовок Authorization и cookies придут как [REDACTED] — именно то, что нужно в переписке с чатом.
  • Скачать очищенный HAR: приложите сетевой лог репорта как HAR файл. Агенты хорошо с ним справляются, а если хотите сначала посмотреть сами, откройте его в бесплатном просмотрщике HAR файлов.
  • Вставить консоль: скопируйте ошибку со стек-трейсом и предупреждение прямо перед ней, если оно есть.

Почему MCP

Мы могли бы сделать плагин для одного редактора. Но MCP поддерживают многие агенты и редакторы, так что один сервер работает и с Claude Code, и с Cursor, и с тем, чем ваша команда начнёт пользоваться завтра. К тому же агент сам контролирует, что читать: он запрашивает ровно те запросы, которые ему нужны.

Следующие на очереди — интеграции с Jira, Linear, GitHub Issues и Slack.

Midge бесплатен: записи без ограничений, видео до 15 минут и без водяного знака.

Частые вопросы

MCP-сервер Midge уже доступен?
Да, и он бесплатный. Добавьте https://midge.dev/mcp в своего агента (в Claude Code: claude mcp add --transport http midge https://midge.dev/mcp) и войдите в Midge в браузере, когда он попросит. Агенты, которые не умеют входить через браузер, используют токен из Settings › Account › AI assistants.
С какими агентами он работает?
С любым клиентом, который поддерживает удалённые MCP-серверы через Streamable HTTP с заголовком, включая Claude Code и Cursor.
Что может прочитать агент?
Обзор репорта (заголовок, описание, страница, устройство, посещённые страницы), его сообщения консоли, сетевые запросы с фильтрами и телами и шаги пользователя. Он может только читать, и только те репорты, которые может открыть владелец токена.
Увидит ли агент мои секреты?
Нет. Репорты очищаются до загрузки, в браузере или на вашем Mac, поэтому Midge никогда не хранит исходные значения. MCP-сервер может вернуть только то, что есть у Midge, то есть уже очищенные данные.