Honeybadger MCP Server
MCP-сервер Honeybadger: агент читает ошибки и аптайм-проверки, строит запросы Insights и правит дашборды и алармы
- 25 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Токен Honeybadger открывает трассы ошибок, комментарии и переменные окружения событий, в которых бывают данные пользователей
- При `HONEYBADGER_READ_ONLY=false` агент создает и удаляет проекты, дашборды, алармы и проверки
Установка
- Работает в
Ручная установка
claude mcp add --transport http honeybadger https://mcp.honeybadger.io/mcpРазмещенный сервер для региона США, вход через OAuth. Для ЕС адрес `https://eu-mcp.honeybadger.io/mcp`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Токен Honeybadger открывает трассы ошибок, комментарии и переменные окружения событий, в которых бывают данные пользователей
- При `HONEYBADGER_READ_ONLY=false` агент создает и удаляет проекты, дашборды, алармы и проверки
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключает агента к API данных Honeybadger, сервиса мониторинга ошибок и работоспособности. Агент перечисляет проекты и ошибки, читает комментарии к ним, смотрит развертывания и аптайм-проверки. Запросы к Insights он пишет на языке BadgerQL, поэтому сводки по событиям строятся прямо из чата. Отдельные инструменты работают с потоками, дашбордами, алармами и проверками check-in. Разработчик рекомендует размещенный сервер: `https://mcp.honeybadger.io/mcp` для региона США и `https://eu-mcp.honeybadger.io/mcp` для европейского. Вход идет через OAuth, образ Docker и личный токен не нужны. Локальный вариант с Docker или сборкой из исходников на Go остается для клиентов без поддержки удаленных серверов. Инструмент `get_reference` отдает агенту справочные темы по BadgerQL, запросам, графикам, дашбордам, алармам и модели ошибок, а `search_tools` ищет инструмент по описанию. Удаление работает в два вызова: первый ничего не стирает и возвращает предпросмотр с токеном подтверждения, второй с тем же токеном выполняет удаление.
Для кого. Разработчикам и дежурным инженерам, которые следят за ошибками в Honeybadger и хотят разбирать их, строить запросы Insights и настраивать алармы из Claude Code, Cursor или VS Code.
Подходит, если
- После релиза в проекте выросло число ошибок, и агент сравнивает их по развертываниям, читает комментарии и называет подозрительный коммит
- Для сводки по событиям за неделю нужен запрос Insights, а BadgerQL вы пишете редко
- Аларм на частоту ошибок создается или правится из чата вместе с дашбордом, к которому он относится
- Проверки check-in и аптайма разбросаны по проектам, и агент перечисляет те, что сейчас падают
Не подходит, если
- Ошибки собирает другой сервис: сервер говорит только с Honeybadger
- Агенту нельзя трогать записи в проекте: в режиме без `HONEYBADGER_READ_ONLY=true` он создает и удаляет проекты, дашборды и алармы
- Аккаунт Honeybadger находится в другом регионе, чем токен: токены США и ЕС не подходят друг к другу
Пример запроса к агенту
Покажи 10 самых частых ошибок проекта за последние сутки и сравни их с прошлым развертываниемMCP
- Транспорт
- http, stdio
- Авторизация
- OAuth
Переменные окружения
HONEYBADGER_PERSONAL_AUTH_TOKENобязательная, секрет- API Token (`hbu_` или `hba_`) для локального запуска
HONEYBADGER_READ_ONLY- По умолчанию `true`: без инструментов записи. `false` включает создание и удаление
HONEYBADGER_API_URL- Адрес API, для региона ЕС `https://eu-app.honeybadger.io`
Ограничения
- Локальный запуск требует Docker и API Token с префиксом `hbu_` (личный) или `hba_` (аккаунта). Прежний личный токен больше не принимается.
- Для европейского региона нужен токен из европейских настроек и `HONEYBADGER_API_URL=https://eu-app.honeybadger.io`. Токен США там не подойдет, и наоборот.
- Локальный сервер стартует в режиме чтения. Запись включает `HONEYBADGER_READ_ONLY=false`.
- Инструмента `get_project_report` в версии на API v3 нет: те же вопросы решает `query_insights`.
Как отключить. Команда `claude mcp remove honeybadger` убирает сервер из Claude Code, в других клиентах удалите запись `honeybadger` из конфигурации MCP. Личный токен отзывается на вкладке Authentication в настройках пользователя Honeybadger.
Частые вопросы
Как подключить Honeybadger к Claude Code?
Выполните `claude mcp add --transport http honeybadger https://mcp.honeybadger.io/mcp` и войдите через OAuth. Для европейского региона замените адрес на `https://eu-mcp.honeybadger.io/mcp`.
Чем размещенный сервер отличается от локального?
Размещенный входит через OAuth и не требует Docker и токена в конфигурации. Локальный запускается из образа `ghcr.io/honeybadger-io/honeybadger-mcp-server` со своим API Token и нужен клиентам без поддержки удаленных серверов или для разработки.
Может ли агент удалить проект или аларм?
Локальный сервер по умолчанию работает только на чтение. Если включить `HONEYBADGER_READ_ONLY=false`, появляются создание и удаление. Инструменты удаления работают в два вызова, где первый лишь показывает предпросмотр и выдает токен `confirm`.
Какой токен нужен для локального сервера?
API Token, который начинается с `hbu_` (личный, создается на вкладке Authentication в настройках пользователя) или `hba_` (аккаунта). Передается в переменной `HONEYBADGER_PERSONAL_AUTH_TOKEN`, имя переменной сохранилось со старых версий.
Что делать после обновления с прежней версии?
Замените старый личный токен на API Token. Инструмента `get_project_report` больше нет, вместо него используйте `query_insights`: каждое срабатывание ошибки лежит в потоке как событие `notice`, окно времени задает параметр `ts`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыDatadog MCP Server (winor30)
Datadog MCP Server
Независимый MCP-сервер Datadog: агент читает инциденты, мониторы, логи, метрики, трейсы и RUM и планирует простои.
Менеджер MCP-серверов на Node.js: запускает локальные и подключает удаленные серверы и отдает их клиенту одним адресом с REST API для управления
Встроенный MCP OneUptime: агент разбирает инциденты, читает логи и трассы, подтверждает алерты и настраивает мониторы.
Официальный управляемый MCP-сервер Datadog: логи, метрики, трейсы и инциденты прямо в агенте
MCP-сервер мониторинга maintenant: агент читает логи контейнеров, историю проверок и алерты, но не трогает контейнеры
Самостоятельно размещаемый шлюз, который собирает несколько MCP-серверов в один эндпоинт с авторизацией и выбором инструментов
Коротко о README
Страница начинается с рекомендации использовать размещенный сервер и затем описывает локальную установку для Cursor, Windsurf, Claude Desktop, Claude Code, VS Code и Zed. Дальше идут переменные окружения, настройка региона ЕС, ключи командной строки и перечень инструментов по группам с параметрами.