bugherd-mcp — MCP-сервер для Claude Code: что делает и как установить
Подключает BugHerd к ИИ-агенту: проекты, задачи, комментарии и вебхуки через API v2. Пригодится, когда баги живут в BugHerd, а править их надо из редактора.
claude mcp add bugherd-mcp -e BUGHERD_API_KEY=<BUGHERD_API_KEY> -- npx -y bugherd-mcpЧто делает bugherd-mcp
Сервер даёт агенту доступ к BugHerd API v2 через 37 инструментов с префиксом bugherd_: от проектов и задач до комментариев, вложений и вебхуков. Задачи можно фильтровать по статусу, приоритету или тегу. Найти задачу по глобальному ID или по локальному номеру вроде #123 тоже можно.
Записывать тоже можно: создать задачу, перенести её в другой проект, сменить статус, исполнителя или описание, добавить комментарий. Колонки Kanban и участников проекта агент тоже редактирует.
Сервер работает локально, это неофициальная сборка под лицензией MIT. Нужен API-ключ из Settings > General Settings в BugHerd, он передаётся через BUGHERD_API_KEY. bugherd_delete_project удаляет проект насовсем, поэтому подтверждение для этого вызова лучше оставить за собой. BugHerd пропускает в среднем 60 запросов в минуту, всплесками до 10 подряд, а ошибки лимита сервер обрабатывает сам.
Какие задачи решает
- найти все критичные баги проекта, не открывая BugHerd
- создать задачу из описания бага прямо в чате с агентом
- перенести пачку задач из одного проекта в другой
- оставить комментарий к задаче после выкатки фикса
- подписать внешний адрес на события
task_createчерез вебхук
Примеры запросов агенту
- Покажи все критичные баги в проекте 12345 из BugHerd
- Создай в BugHerd задачу в проекте 12345: «Поправить выравнивание кнопки входа»
- Добавь в BugHerd комментарий к задаче 678 в проекте 12345: «Поправили в свежем релизе»
Как установить bugherd-mcp
Командой платформы
claude mcp add bugherd-mcp -e BUGHERD_API_KEY=<BUGHERD_API_KEY> -- npx -y bugherd-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add bugherd-mcp --env BUGHERD_API_KEY=<BUGHERD_API_KEY> -- npx -y bugherd-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"bugherd-mcp": {
"command": "npx",
"args": [
"-y",
"bugherd-mcp"
],
"env": {
"BUGHERD_API_KEY": "<BUGHERD_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"bugherd-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"bugherd-mcp"
],
"env": {
"BUGHERD_API_KEY": "<BUGHERD_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e BUGHERD_API_KEY=<BUGHERD_API_KEY> bugherd-mcp npx -y bugherd-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о bugherd-mcp
Как установить bugherd-mcp в Claude Code?
Выполните claude mcp add bugherd-mcp -e BUGHERD_API_KEY=<BUGHERD_API_KEY> -- npx -y bugherd-mcp, подставив свой API-ключ BugHerd.
Что делает bugherd-mcp?
Это MCP-сервер, который открывает агенту BugHerd API v2: проекты, задачи, колонки, комментарии, вложения и вебхуки. Через него можно читать задачи, создавать их и менять статус.
Чем bugherd-mcp отличается от официального сервера BugHerd?
Это неофициальный open-source вариант под MIT, он запускается у вас локально. Официальный macropodhq/bugherd-mcp закрытый и хостится на стороне BugHerd.
