MCP 経由で Bitbucket を Gemini に接続する方法

💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Bitbucket をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も git clone もローカルサーバーも不要。

Bitbucket + Gemini

AI に Bitbucket Cloud で作業させます。リポジトリ、ブランチ、コミット、ファイルの閲覧、差分とコメントを含むプルリクエストのレビュー、あなたの確認後の承認、コメント、マージ、そして Bitbucket Pipelines の実行、ステップのログ、デプロイの確認ができます。

前提条件

完全なセットアップ手順はコネクタ自体に組み込まれています (ストアでコネクタを選択すると表示)。必要な環境変数:

BITBUCKET_API_TOKEN

ステップ 1 — 認証情報を取得

1. https://id.atlassian.com/manage-profile/security/api-tokens（Atlassian アカウントの Security → API tokens）にサインインし、Create API token with scopes をクリックします。
2. トークンに名前（たとえば AnythingMCP）を付け、有効期限を選び、アプリとして Bitbucket を選択します。
3. 読み取りスコープ read:user:bitbucket、read:workspace:bitbucket、read:repository:bitbucket、read:pullrequest:bitbucket、read:pipeline:bitbucket にチェックを入れます。プルリクエストの作成、コメント、承認、マージには write:pullrequest:bitbucket を、パイプラインの起動には write:pipeline:bitbucket を追加します。
4. トークン（ATATT で始まります）をコピーし、Bearer という語を付けずに BITBUCKET_API_TOKEN に貼り付けて、コネクタをインストールします。コネクタは Bearer トークンとして送信するため、Atlassian のメールアドレスは不要です。
5. bitbucket_get_current_user、続いて bitbucket_list_workspaces で設定を確認します。

アプリパスワードはもう使えません: Bitbucket は 2025 年 9 月 9 日にアプリパスワードの新規作成を停止し、残っていたものを 2026 年 7 月 28 日に無効にしました。上記のとおりスコープ付きの API トークンを使ってください。リポジトリ、プロジェクト、ワークスペースのアクセストークン（Repository settings → Access tokens。プロジェクトとワークスペースのトークンには Premium プランが必要です）も同じ欄で使えますが、そのリポジトリ、プロジェクト、ワークスペースに限定されたボットとして動作します。そのため bitbucket_get_current_user と bitbucket_list_workspaces が拒否されることがあり、範囲外のものには 403 または 404 が返ります。

誰が何を見られるか: AI はトークンの持ち主のユーザーとして動作し、そのユーザーとチェックしたスコープが許す範囲だけを閲覧、変更します。2 つの書き込みスコープを付けなければ、トークンは読み取り専用のままです。

実際のブランチを変更しチームにも届くため、AI は先に確認します: bitbucket_create_pull_request はあなたの名前でプルリクエストを作成します（ソースブランチはプッシュ済みである必要があります）。bitbucket_add_pull_request_comment は通常のコメント、返信、または行に対するコードコメントを投稿し、プルリクエストの参加者全員に表示され、通知が届くこともあります。bitbucket_approve_pull_request はあなたの承認を追加し、これはマージチェックに数えられます。bitbucket_merge_pull_request は全員にとってのマージ先ブランチを変更し、デプロイ用パイプラインを起動することがあり、close_source_branch を指定するとソースブランチを削除します。AI はその前に bitbucket_get_pull_request で状態と承認を確認します。bitbucket_run_pipeline はビルド時間を消費し、デプロイのステップも含めてパイプラインの処理をすべて実行します。AI はそれぞれの前に、リポジトリ、ブランチ、プルリクエスト、マージ方法またはパイプラインを示し、あなたの承認を待ちます。インストール時に無効になっているツールはありません。また、close_source_branch を指定したマージでのソースブランチを除き、リポジトリ、ブランチ、コメントを削除するツールはありません。

作業の進め方: bitbucket_list_workspaces でワークスペースのスラッグ、bitbucket_list_repositories でリポジトリのスラッグがわかります。どちらもアドレス bitbucket.org/<workspace>/<repo> に含まれています。コード: bitbucket_get_repository（メインブランチ）、bitbucket_list_branches、bitbucket_list_commits、bitbucket_get_commit、bitbucket_get_file（ファイルのテキストまたはフォルダの一覧）。レビュー: bitbucket_list_pull_requests、bitbucket_get_pull_request、変更の規模を見る bitbucket_get_pull_request_diffstat、続いて bitbucket_get_pull_request_diff、bitbucket_list_pull_request_commits、bitbucket_list_pull_request_comments。デプロイ: bitbucket_list_environments と bitbucket_list_deployments。

パイプライン: bitbucket_list_pipelines の後、失敗したステップについて bitbucket_get_pipeline、bitbucket_list_pipeline_steps、bitbucket_get_pipeline_step_log を使います。パイプラインとステップの uuid には波かっこが含まれます。AI は返された値をそのまま渡します。200 KB を超えるステップのログは先頭を残して切り詰められますが、エラーはたいてい末尾にあります。そのため長いログでは、AI は bytes=-150000（最後の 150 KB）のような範囲を指定して末尾を読みます。差分とファイルも 200 KB で切り詰められます。

一覧とフィルター: 次のページがある場合、一覧の応答には next が含まれます。AI は page（ほとんどの一覧では数値、コミットでは不透明なトークン）を付けて再度呼び出し、pagelen でページサイズを指定します。q には Bitbucket のクエリ言語を使えます。たとえば name ~ "api" や destination.branch.name = "main" です。

課題と Wiki はありません: Bitbucket は 2026 年 8 月 20 日に組み込みの課題トラッカーと Wiki を廃止しました（API は 410 を返します）。そのため、このコネクタにはそれらのツールがありません。課題管理には Jira コネクタを追加してください。

よくあるエラー: 401: トークンが間違っている、期限切れ、または取り消されている、あるいは古いアプリパスワードです。スコープ付きの API トークンを作成してください。403: スコープが不足している（メッセージにスコープ名が表示されます）か、ユーザーに権限がありません。404: ワークスペース、リポジトリ、または項目が存在しないか、トークンから見えません。429: 1 時間あたりのレート制限に達しました。少し待ってから再試行してください。

このコネクタは、リポジトリとブランチの作成や削除、ファイルの編集やコミットのプッシュ、プルリクエストの却下、パイプラインの停止、リポジトリの変数と設定、管理操作には対応していません。

ステップ 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 は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

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

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう。Gemini CLI が Bitbucket のツールを呼び出せるようになりました。

利用可能なツール

プロンプトの例

• 「acme/web-app でまだオープンになっているプルリクエストはどれですか？作成者と、まだ承認がないものを教えてください。」
• 「web-app のプルリクエスト #42 をレビューしてください。変更されたファイルを要約し、リスクのある変更を指摘し、未解決のレビューコメントを一覧にしてください。」
• 「main の最新のパイプラインはなぜ失敗したのですか？失敗したステップのログを読んで、エラーを見せてください。」
• 「プルリクエスト #42 に承認が 2 件付いたら、squash で main にマージしてください。先にブランチとマージ方法を見せて、マージする前に私に確認してください。」
• 「Production に最後にデプロイされたのはいつ、誰によってで、どのコミットがリリースされましたか？」

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

次のステップ

• コネクタのランディング
• Claude に接続
• ChatGPT に接続