buildkite-mcp-server — MCP-сервер для Claude Code: обзор и запуск
Подключает данные CI/CD Buildkite к вашему ассистенту. Помогает находить сбои в пайплайнах, изучать хвосты логов, сравнивать прогоны с базовой веткой и перезапускать задачи.
claude mcp add --env BUILDKITE_API_TOKEN=<BUILDKITE_API_TOKEN> --transport stdio buildkite-mcp-server -- docker run -i --rm -e BUILDKITE_API_TOKEN ghcr.io/buildkite/buildkite-mcp-server:0.7.0Что делает buildkite-mcp-server
Сервер связывает ИИ-ассистента с API Buildkite через протокол MCP. Это избавляет от ручного копирования простыней логов из веб-интерфейса в окно чата. Ассистент сам проверяет статус пайплайнов и вытягивает последние строки консольного вывода проблемных джобов.
Внутри выделены отдельные наборы инструментов. Группа retries даёт возможность изучать ошибки и перезапускать упавшие из-за инфраструктуры шаги, не выдавая ассистенту опасных прав на запись в пайплайн. Для этого достаточно скоупа retry_builds вместо широкого write_builds. Перед повтором можно включить режим dry_run, чтобы сначала увидеть список задач без их фактического запуска.
Инструмент compare_builds сопоставляет текущую сборку с последней успешной на той же ветке и отбирает до 100 изменившихся шагов. Он сразу отсекает рутину и подгружает фрагменты логов для первых трёх блокирующих сбоев. Для работы сервера обязательно наличие Docker и токена BUILDKITE_API_TOKEN.
Какие задачи решает
- выяснить причину падения билда по свежим логам шагов
- сравнить сломанную сборку с последним успешным прогоном на ветке
- перезапустить сбойные джобы инфраструктуры с предварительной проверкой
- проверить конфигурацию мониторов и фильтров в тестовых сьютах
Примеры запросов агенту
- Проверь билд 89 пайплайна web-app и покажи логи упавших шагов.
- Сравни сборку 142 с последним успешным билдом на ветке main в пайплайне api.
- Запусти dry_run для повтора сбойных задач инфраструктуры в билде 210.
Как установить buildkite-mcp-server
Командой платформы
claude mcp add --env BUILDKITE_API_TOKEN=<BUILDKITE_API_TOKEN> --transport stdio buildkite-mcp-server -- docker run -i --rm -e BUILDKITE_API_TOKEN ghcr.io/buildkite/buildkite-mcp-server:0.7.0Вместо <…> подставьте свои значения
Командой платформы
codex mcp add buildkite-mcp-server --env BUILDKITE_API_TOKEN=<BUILDKITE_API_TOKEN> -- docker run -i --rm -e BUILDKITE_API_TOKEN ghcr.io/buildkite/buildkite-mcp-server:0.7.0Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"buildkite-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BUILDKITE_API_TOKEN",
"ghcr.io/buildkite/buildkite-mcp-server:0.7.0"
],
"env": {
"BUILDKITE_API_TOKEN": "<BUILDKITE_API_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"buildkite-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"BUILDKITE_API_TOKEN",
"ghcr.io/buildkite/buildkite-mcp-server:0.7.0"
],
"env": {
"BUILDKITE_API_TOKEN": "<BUILDKITE_API_TOKEN>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e BUILDKITE_API_TOKEN=<BUILDKITE_API_TOKEN> buildkite-mcp-server docker run -i --rm -e BUILDKITE_API_TOKEN ghcr.io/buildkite/buildkite-mcp-server:0.7.0Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о buildkite-mcp-server
Как установить buildkite-mcp-server в Claude Code?
Выполните команду `claude mcp add --env BUILDKITE_API_TOKEN=<BUILDKITE_API_TOKEN> --transport stdio buildkite-mcp-server -- docker run -i --rm -e BUILDKITE_API_TOKEN ghcr.io/buildkite/buildkite-mcp-server:0.7.0. Подставьте свой токен вместо <BUILDKITE_API_TOKEN>`.
Что делает buildkite-mcp-server?
Сервер даёт ИИ-ассистенту доступ к данным Buildkite: пайплайнам, сборкам, шагам и логам. Модель может самостоятельно диагностировать поломки сборки и предлагать точечные перезапуски.
Нужен ли токену полный доступ на запись для перезапуска шагов?
Нет, набор инструментов retries работает с ограниченными правами. Достаточно скоупов read_builds, read_build_logs и retry_builds, поэтому общий write_builds выдавать не требуется.
