インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Buildkite をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
AI エージェントから Buildkite を確認：パイプライン、ビルドとジョブ、ジョブログ、アーティファクトとアノテーション、エージェント、クラスターとキュー、不安定なテストや遅いテストを含む Test Engine のスイートを参照し、確認のうえでビルドの開始、再ビルド、リトライ、ステップのブロック解除、アノテーションの追加ができます。
こう聞いてみよう
Buildkite のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Buildkite をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Buildkite
AI エージェントから Buildkite を確認：パイプライン、ビルドとジョブ、ジョブログ、アーティファクトとアノテーション、エージェント、クラスターとキュー、不安定なテストや遅いテストを含む Test Engine のスイートを参照し、確認のうえでビルドの開始、再ビルド、リトライ、ステップのブロック解除、アノテーションの追加ができます。
セットアップ
設定は約 3 分です。組織にアクセスできる Buildkite アカウントが必要です。
- Buildkite でアバター、Personal Settings、API Access Tokens（https://buildkite.com/user/api-access-tokens）を開き、**New API Access Token** をクリックします。
- 組織と次のスコープを選びます:
read_builds、read_build_logs、read_pipelines、read_artifacts、read_agents、read_clusters、read_organizations、read_user、Test Engine 用にread_suites。書き込みにはwrite_buildsを追加します。AI にさせたくない操作のスコープは外してください。 - トークン（通常
bkua_で始まります）をBUILDKITE_API_TOKENに貼り付けます。Authorization: Bearer <token>として api.buildkite.com にだけ送信され、AI はトークンの所有ユーザーとして動作します。 - コネクタをインストールし、
buildkite_get_access_tokenを実行するとトークンのスコープが表示されます。続いてbuildkite_list_organizationsで組織のスラッグを一覧できます。
スラッグと番号: ツールは buildkite.com/<org>/<pipeline> と同じ組織スラッグ（org）とパイプラインスラッグ（pipeline）、そしてビルドの UUID ではなくビルド 番号（#123）を受け取ります。ジョブ、アーティファクト、エージェントは UUID を使います。buildkite_list_test_runs はビルドの UUID（ビルドの id）で絞り込みます。
読み取れるもの:
- 組織とパイプライン:
buildkite_get_current_user、buildkite_list_organizations、buildkite_get_organization、buildkite_list_pipelines（名前やリポジトリ URL の一部で絞り込み）、リポジトリ、デフォルトブランチ、ブランチフィルター、クラスター、YAML のステップを含むbuildkite_get_pipeline。 - ビルド: 組織全体は
buildkite_list_builds、1 つのパイプラインはbuildkite_list_pipeline_buildsで、新しい順に、ブランチ、状態（failed、running、blockedなど）、コミット、作成者、日付で絞り込めます。既定ではジョブを含みません。buildkite_get_buildなら状態、終了コード、ステップキー、エージェント付きでジョブが見られます。 - ビルドが失敗した理由:
stateを failed にしたbuildkite_list_jobs、続いて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 で絞り込み）、サイズ、MIME タイプ、sha1、ダウンロード URL を返すbuildkite_get_artifact。ファイル自体は Buildkite のアプリで開きます。 - エージェントとキャパシティ:
buildkite_list_agents（ホスト名、バージョン、キュー、タグ、接続状態、実行中のジョブ）、buildkite_get_agent、buildkite_list_clusters、buildkite_get_cluster、buildkite_list_cluster_queues（ディスパッチが一時停止中かどうか）。 - Test Engine:
buildkite_list_test_suites、信頼性、所要時間、実行回数、flaky などのラベル、オーナーを返すbuildkite_list_tests（最も不安定なものはsort_by=reliabilityとorder=asc）、不安定さのスコア付きのbuildkite_get_test、buildkite_list_test_runs、buildkite_get_test_run、失敗理由と、指定すればバックトレースも返すbuildkite_list_failed_executions。
確認のうえで変更できるもの: buildkite_create_build（パイプライン、コミット、ブランチ、メッセージ、環境変数）、buildkite_rebuild_build、buildkite_retry_failed_jobs、buildkite_retry_job、buildkite_unblock_job、buildkite_create_annotation。ビルドはデプロイを含む実際のステップをあなたのエージェント上で実行し、計算資源を使うため、AI はパイプライン、ビルド、ブランチを示してあなたの了承を待ちます。buildkite_unblock_job は手動の承認ゲート（多くは本番前のもの）を通すため、AI はあなたがはっきり指示したときだけ呼び出します。
インストール時に無効: buildkite_cancel_build。キャンセルされたビルドは実行中のジョブを止め、デプロイを途中で放置することがあり、再開はできず再ビルドしかできません。そのため、チームが必要なときにワークスペースの管理者が有効にします。
データ形式: 状態は小文字です（passed、failed、running、blocked、canceled）。時刻は UTC の ISO 8601 です。web_url でビルドやジョブを Buildkite で開けます。ログの行には ANSI カラーコードが含まれることがあります。テストの所要時間は秒、信頼性は割合（0.95 = 95%）です。
ページング: 一覧ツールは page と per_page（既定 30、最大 100）を受け取ります。続きがあると応答に _pagination.nextUrl が含まれ、AI は _pagination がなくなるまで次の page（buildkite_list_jobs では after）を取得します。非常に深いビルド一覧は 400 を返すため、その場合 AI は branch や created_from で範囲を絞ります。
制限: Buildkite は REST 呼び出しを組織ごと、ユーザーごとに 1 分単位で制限し、どちらかを使い切ると 429 を返します。RateLimit-Reset の秒数だけ待ってから再試行してください。
よくあるエラー: 401 はトークンの誤り、期限切れ、失効を意味します。403 はトークンにその呼び出しのスコープがない（buildkite_get_access_token で確認）か、その組織へのアクセス権がないことを意味します。404 はスラッグ、番号、ID の誤りです。422 には、ビルドやジョブを作成、リトライ、ブロック解除できない理由が示されます。
このコネクタはジョブの環境変数（シークレットを含みます）を読まず、ログ、アーティファクト、アノテーション、パイプラインを削除せず、パイプライン、クラスター、キュー、エージェントトークンの作成や変更も、エージェントの停止や一時停止も行いません。チーム、メンバー、監査イベント、パッケージレジストリ、ミュートやスキップなどのテスト状態の変更にも対応していません。
前提条件: BUILDKITE_API_TOKEN
ローカルでコネクタをインストール
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
http://localhost:3000/connectors/store を開き、 Buildkite を選択し、前提条件に記載された環境変数を入力します。
利用可能なツール
| Tool | What it does |
|---|---|
buildkite_get_access_token | Read the API access token in use: its scopes, description, expiry and owner |
buildkite_get_current_user | Read the Buildkite user the token belongs to: id, name, email and avatar |
buildkite_list_organizations | List the organizations the token can reach, with their slug, name and web URL |
buildkite_get_organization | Read one organization: name, slug, web URL and links to its pipelines and agents |
buildkite_list_pipelines | List the pipelines of an organization: slug, name, repository, default branch, cluster and running and scheduled build counts |
buildkite_get_pipeline | Read one pipeline: repository, default branch, branch filters, cluster, provider settings and its YAML steps configuration |
buildkite_list_builds | List the builds of a whole organization, newest first: number, state, branch, commit, message, creator, pipeline and times |
buildkite_list_pipeline_builds | List the builds of one pipeline, newest first, with the same filters as buildkite_list_builds |
buildkite_get_build | Read one build by its number: state, branch, commit, message, creator, times, job_state_counts and its jobs with state, exit status, step… |
buildkite_list_jobs | List the jobs of a build, optionally only some states or one step or group key: id, name, step key, state, exit status, agent and times |
buildkite_get_job | Read one job by id: name, command, state, exit status, signal, agent, retry information, times and web URL |
buildkite_get_job_log | Read the end of a job's log as plain text, by default the last 100,000 bytes, where the error usually is |
buildkite_list_build_artifacts | List the artifacts uploaded by all jobs of a build: id, job id, path, file size, mime type, state and sha1 |
buildkite_list_job_artifacts | List the artifacts of one job, with the same fields and filters as buildkite_list_build_artifacts |
buildkite_get_artifact | Read one artifact's metadata: path, size, mime type, state, sha1 and its download URL (the file itself opens in the Buildkite app) |
buildkite_list_annotations | List the annotations of a build: context, style (success, info, warning, error), priority and the rendered HTML body, often a test or… |
buildkite_list_agents | List the connected agents of an organization: id, name, hostname, version, queue, tags (meta_data), connection state and the job they run |
buildkite_get_agent | Read one agent by id, also a disconnected one: connection state, hostname, version, queue, tags, current job and times |
buildkite_list_clusters | List the clusters of an organization: id, name, description, default queue and maintainers |
buildkite_get_cluster | Read one cluster: name, description, default queue and maintainers |
buildkite_list_cluster_queues | List the queues of a cluster: id, key, description, hosted agent settings and whether dispatch is paused |
buildkite_list_test_suites | List the Test Engine suites of an organization: slug, name, default branch and web URL |
buildkite_list_tests | List the tests of a Test Engine suite with metrics over a time window: reliability, average and total duration, execution counts, labels… |
buildkite_get_test | Read one test of a suite with its duration, reliability and execution metrics and its flakiness scores over a time window |
buildkite_list_test_runs | List the test runs of a suite, newest first: id, branch, commit, result, execution counts by result and the build they belong to |
buildkite_get_test_run | Read one test run: state, result, branch, commit, execution counts and times |
buildkite_list_failed_executions | List the failed test executions of a run: test name and location, failure reason and, with include_failure_expanded, the expanded failure… |
buildkite_create_build | Start a new build of a pipeline for a commit and branch |
buildkite_rebuild_build | Run a finished build again as a new build with the same commit, branch and settings, including any deploy steps |
buildkite_retry_failed_jobs | Retry the failed jobs of a build in place, optionally only some failure kinds |
buildkite_retry_job | Retry one failed, timed out or canceled job; the retry runs as a new job in the same build |
buildkite_unblock_job | Unblock a block step (a manual approval, often before a deploy) so the build continues, optionally with values for the step's fields |
buildkite_create_annotation | Add an annotation (a Markdown or HTML note shown on the build page) to a build, or append to the one with the same context |
buildkite_cancel_build | Cancel a scheduled, running or failing build; its running jobs stop and the rest never run, which can leave a deployment half done |
プロンプトの例
- 「main ブランチの api パイプラインの最新ビルドはなぜ失敗したのですか？ 失敗したジョブのログからエラーを見せてください。」
- 「今、承認待ちでブロックされているビルドはどれですか？」
- 「直近 7 日間で、Test Engine スイートの中で最も信頼性の低いテストを 10 件挙げてください。」
- 「web パイプラインのビルド #4821 で失敗したジョブをリトライしてください。」
- 「default キューに接続しているエージェントは何台で、そのうちどれがビジーですか？」
次のステップ
このガイドは役に立ちましたか?