Как подключить Buildkite к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Buildkite, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Buildkite + Gemini

Проверяйте Buildkite из AI-агента: пайплайны, сборки и джобы, логи джобов, артефакты и аннотации, агенты, кластеры и очереди, а также наборы Test Engine с нестабильными и медленными тестами; после вашего подтверждения запускайте, пересобирайте и повторяйте сборки, снимайте блокировку с шагов и добавляйте аннотации.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

BUILDKITE_API_TOKEN

Шаг 1 — Получите учётные данные

Настройка занимает около 3 минут. Нужен аккаунт Buildkite с доступом к организации.

1. В Buildkite откройте аватар, Personal Settings, API Access Tokens (https://buildkite.com/user/api-access-tokens) и нажмите New API Access Token.
2. Выберите организации и такие scopes: read_builds, read_build_logs, read_pipelines, read_artifacts, read_agents, read_clusters, read_organizations, read_user и для Test Engine read_suites. Для записи добавьте write_builds. Не включайте то, чего ИИ делать не должен.
3. Вставьте токен (обычно начинается с bkua_) в BUILDKITE_API_TOKEN. Он отправляется как Authorization: Bearer <token> только на api.buildkite.com, и ИИ действует от имени владельца токена.
4. Установите коннектор и выполните buildkite_get_access_token: он покажет scopes токена. Затем buildkite_list_organizations выведет слаги организаций.

Слаги и номера: инструменты принимают слаг организации (org) и слаг пайплайна (pipeline), как в buildkite.com/<org>/<pipeline>, и номер сборки (#123), а не её UUID. Джобы, артефакты и агенты используют UUID. buildkite_list_test_runs фильтрует по UUID сборки (её id).

Что он читает:

• Организации и пайплайны: buildkite_get_current_user, buildkite_list_organizations, buildkite_get_organization, buildkite_list_pipelines (фильтр по части имени или URL репозитория) и buildkite_get_pipeline с репозиторием, веткой по умолчанию, фильтрами веток, кластером и шагами в YAML.
• Сборки: buildkite_list_builds по всей организации или buildkite_list_pipeline_builds по одному пайплайну, от новых к старым, с фильтрами по ветке, состоянию (failed, running, blocked и другие), коммиту, автору или датам. По умолчанию джобы в них не входят; buildkite_get_build показывает их с состоянием, кодом выхода, step key и агентом.
• Почему сборка упала: buildkite_list_jobs с state равным failed, затем buildkite_get_job и buildkite_get_job_log, который возвращает конец лога простым текстом, по умолчанию последние 100 000 байт, где обычно и находится ошибка (tail_bytes до 5 000 000). В buildkite_list_annotations часто лежит сводка по тестам или покрытию.
• Артефакты: buildkite_list_build_artifacts, buildkite_list_job_artifacts (фильтр по состоянию или glob пути) и buildkite_get_artifact с размером, MIME-типом, sha1 и URL для скачивания; сам файл открывается в приложении Buildkite.
• Агенты и мощности: buildkite_list_agents (hostname, версия, очередь, теги, состояние подключения, текущий джоб), buildkite_get_agent, buildkite_list_clusters, buildkite_get_cluster и buildkite_list_cluster_queues (приостановлена ли раздача задач).
• Test Engine: buildkite_list_test_suites, buildkite_list_tests с надёжностью, длительностью, числом запусков, метками вроде flaky и владельцами (sort_by=reliability и order=asc для самых ненадёжных), buildkite_get_test с оценками нестабильности, buildkite_list_test_runs, buildkite_get_test_run и buildkite_list_failed_executions с причиной падения и по запросу backtrace.

Что он меняет после вашего подтверждения: buildkite_create_build (пайплайн, коммит, ветка, сообщение, окружение), buildkite_rebuild_build, buildkite_retry_failed_jobs, buildkite_retry_job, buildkite_unblock_job и buildkite_create_annotation. Сборки выполняют настоящие шаги на ваших агентах, включая деплой, и тратят вычислительные ресурсы, поэтому ИИ называет пайплайн, сборку и ветку и ждёт вашего согласия. buildkite_unblock_job одобряет ручной шлюз, часто перед продакшеном: ИИ вызывает его, только если вы прямо об этом скажете.

Отключено при установке: buildkite_cancel_build. Отменённая сборка останавливает запущенные джобы, может оставить деплой незавершённым и не может быть продолжена, только пересобрана, поэтому администратор рабочего пространства включает его, когда это нужно команде.

Форматы данных: состояния пишутся строчными буквами (passed, failed, running, blocked, canceled). Время в ISO 8601 по UTC. web_url открывает сборку или джоб в Buildkite. Строки лога могут содержать цветовые коды ANSI. Длительность тестов в секундах, надёжность это доля (0,95 = 95 %).

Пагинация: инструменты списков принимают page и per_page (по умолчанию 30, до 100). Если результатов больше, в ответе есть _pagination.nextUrl; ИИ запрашивает следующую page (или передаёт after для buildkite_list_jobs), пока _pagination не исчезнет. Очень глубокие списки сборок отвечают 400; тогда ИИ сужает их через branch или created_from.

Ограничения: Buildkite ограничивает REST-вызовы на организацию и на пользователя в минуту и отвечает 429, когда любой из лимитов исчерпан; подождите столько секунд, сколько указано в RateLimit-Reset, и повторите.

Типичные ошибки: 401 означает, что токен неверен, просрочен или отозван. 403 означает, что у токена нет scope для вызова (проверьте через buildkite_get_access_token) или нет доступа к этой организации. 404 означает неверный слаг, номер или id. 422 объясняет, почему сборку или джоб нельзя создать, повторить или разблокировать.

Коннектор не читает переменные окружения джобов (в них секреты), не удаляет логи, артефакты, аннотации и пайплайны, не создаёт и не меняет пайплайны, кластеры, очереди и токены агентов, не останавливает и не приостанавливает агенты и не работает с командами, участниками, событиями аудита, реестрами пакетов и изменением состояния тестов вроде mute и skip.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты Buildkite.

Доступные инструменты

Примеры запросов

• «Почему упала последняя сборка пайплайна api в ветке main? Покажи ошибку из лога упавшего джоба.»
• «Какие сборки сейчас заблокированы и ждут одобрения?»
• «Выведи 10 самых ненадёжных тестов нашего набора Test Engine за последние 7 дней.»
• «Повтори упавшие джобы сборки #4821 в пайплайне web.»
• «Сколько агентов подключено к очереди default и какие из них заняты?»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot