DebugBundle — MCP-сервер для Claude Code: что делает и как установить
Передаёт агенту отчёты об ошибках выполнения и авариях в продакшене. Пригодится для разбора инцидентов и проверки доступности эндпоинтов.
claude mcp add --env DEBUGBUNDLE_MEMBER_TOKEN=<DEBUGBUNDLE_MEMBER_TOKEN> --env DEBUGBUNDLE_API_URL=<DEBUGBUNDLE_API_URL> --transport stdio mcp -- npx -y @debugbundle/mcpЧто делает DebugBundle
Сервер запускается локально через stdio и открывает ИИ-агенту доступ к авариям и проверкам работоспособности эндпоинтов. Через команды list_analytics_flows и get_analytics_flow_report агент может изучать отчёты по воронкам активации или управлять ими при наличии прав администратора. Также доступны настройки проектных уведомлений и расписание ежедневных сводок по часовым поясам IANA.
Сервер требует Node.js версий от 22.x до 26.x. Для авторизации в автоматических пайплайнах нужен DEBUGBUNDLE_MEMBER_TOKEN. Использовать проектный токен нельзя, потому что он рассчитан только на приём телеметрии в SDK и заблокирует вызовы MCP-инструментов. Для локальной работы достаточно сессии после debugbundle login.
Какие задачи решает
- разобрать инциденты и повторить сбои по готовым бандлам
- проверить доступность эндпоинтов через запуск проб
- выгрузить отчёты по воронкам активации пользователей
- настроить расписание ежедневных сводок с учётом часового пояса
Примеры запросов агенту
- Покажи последние критические инциденты и связанные с ними пробы
- Выгрузи отчёт по воронке активации через get_analytics_flow_report
- Приостанови отправку алертов для канала уведомлений проекта
Как установить DebugBundle
Командой платформы
claude mcp add --env DEBUGBUNDLE_MEMBER_TOKEN=<DEBUGBUNDLE_MEMBER_TOKEN> --env DEBUGBUNDLE_API_URL=<DEBUGBUNDLE_API_URL> --transport stdio mcp -- npx -y @debugbundle/mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add mcp --env DEBUGBUNDLE_MEMBER_TOKEN=<DEBUGBUNDLE_MEMBER_TOKEN> --env DEBUGBUNDLE_API_URL=<DEBUGBUNDLE_API_URL> -- npx -y @debugbundle/mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@debugbundle/mcp"
],
"env": {
"DEBUGBUNDLE_MEMBER_TOKEN": "<DEBUGBUNDLE_MEMBER_TOKEN>",
"DEBUGBUNDLE_API_URL": "<DEBUGBUNDLE_API_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@debugbundle/mcp"
],
"env": {
"DEBUGBUNDLE_MEMBER_TOKEN": "<DEBUGBUNDLE_MEMBER_TOKEN>",
"DEBUGBUNDLE_API_URL": "<DEBUGBUNDLE_API_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e DEBUGBUNDLE_MEMBER_TOKEN=<DEBUGBUNDLE_MEMBER_TOKEN> -e DEBUGBUNDLE_API_URL=<DEBUGBUNDLE_API_URL> mcp npx -y @debugbundle/mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о DebugBundle
Как установить DebugBundle в Claude Code?
Выполните команду claude mcp add mcp -e DEBUGBUNDLE_MEMBER_TOKEN=<DEBUGBUNDLE_MEMBER_TOKEN> -- npx -y @debugbundle/mcp. Вместо плейсхолдера укажите ваш токен участника.
Что делает DebugBundle?
Сервер связывает агента с инфраструктурой отладки, позволяя изучать аварии, проверять эндпоинты, настраивать уведомления и просматривать продуктовую аналитику.
Какой токен нужен для работы с MCP?
Требуется токен участника DEBUGBUNDLE_MEMBER_TOKEN или авторизация через debugbundle login. Токены проекта использовать нельзя, так как они предназначены только для отправки событий из клиентских библиотек.
