ClaudeとBitbucketを連携してPRとパイプラインを扱う
Atlassian Rovo MCP ServerがBitbucket Cloudに対応した仕組みと、Claude Codeからのリポジトリ閲覧・PR操作・パイプライン確認までの手順、制約(Bitbucket Cloud限定)を扱います。
Atlassian Rovo MCP ServerがBitbucket Cloudに対応し、Claudeからリポジトリの閲覧・コミット作成・PRの作成やマージ・パイプライン結果の確認までを自然文で扱えるようになりました。これまでJira・Confluence向けだった同じMCP接続に、Bitbucketのツール群が追加された形です。ここではClaude Codeでの繋ぎ方と、制約(Bitbucket Cloud限定・組織に紐づいたワークスペースのみ)を扱います。
Jira・Confluenceと同じ接続にBitbucketが追加された
Atlassian Rovo MCP Serverは、Jira・Confluence・Jira Service Management・Bitbucket・Compass・Loomをまとめて扱う単一のMCPサーバーです。接続先はhttps://mcp.atlassian.com/v2/mcpで、すでにJira・Confluence向けにこのサーバーを繋いでいる場合は、組織側でBitbucket Cloudのツールを有効化するだけで同じ接続からBitbucketも扱えるようになります。新しく別のコネクタを追加する必要はありません。BitbucketのツールはRovo MCP v2でのみ提供されており、v1のままでは見えません。
Bitbucket Cloudで使えるツール
Atlassian Rovo MCP v2では、Bitbucket Cloud向けツールはread_bitbucketとwrite_bitbucketという2つの権限グループにまとまっています。組織管理者はこの権限グループ単位でアクセスを許可・剥奪でき、個々のツールは所属するグループの権限を継承します。
| 権限グループ | 必要スコープ | 代表ツール |
|---|---|---|
read_bitbucket | 必要スコープread:bitbucket:agent-interface | 代表ツールlistBitbucketRepositories / getBitbucketRepoFileContent / listBitbucketRepoPullRequests / getBitbucketRepoPullRequestDiff / listBitbucketRepoPipelines / getBitbucketRepoPipelineStepLog |
write_bitbucket | 必要スコープwrite:bitbucket:agent-interface | 代表ツールcreateBitbucketRepoPullRequest / mergeBitbucketRepoPullRequest / approveBitbucketRepoPullRequest / createBitbucketRepoBranch / createBitbucketRepoCommit / runBitbucketRepoPipeline |
read_bitbucketにはコミットに紐づくコードインサイトレポート(listBitbucketRepoCommitReportsなど、静的解析やテストカバレッジの結果を表すもの)を読むツールも含まれます。ビルドが壊れたときに「そのコミットのコード品質レポートも合わせて見せて」と頼めるのはこのためです。
「platform-coreでレビュー待ちの自分宛てPRを全部見せて」のような聞き方をすると、listBitbucketRepoPullRequestsと関連ツールを組み合わせて実際に使える答えが返ります。ビルドが壊れたときは、listBitbucketRepoPipelineStepsとgetBitbucketRepoPipelineStepLogで失敗しているステップとログを素早く特定させる使い方もできます。
レビューの割り当てそのものも扱えます。getBitbucketRepoDefaultReviewersでリポジトリに設定された既定レビュアーを取得できるため、「このリポジトリでは誰がデフォルトレビュアーになっている?」といった質問にもClaudeが直接答えられます。PRに付けたタスク(チェックリスト項目)の作成・解決・再オープンもwrite_bitbucketのツールに含まれており、レビュー中に見つかった指摘事項をその場でタスク化させる使い方もできます。
Bitbucketのコードを横断検索する
Bitbucket Cloudのツール群とは別に、Atlassian Rovo MCPは接続済みのソースコード管理サービス全体を横断検索するsearch_codeという権限グループも持っています。searchCodeでリポジトリをまたいだコード検索、getCodeSymbolで関数やクラスの定義箇所と参照箇所を一括で洗い出せます。プルリクエストの中身を読むだけでなく、「この関数を呼んでいる場所を全部教えて」のような横断的な質問もBitbucketリポジトリに対して投げられます。この権限グループはOAuth 2.1認証のみで使え、API token認証には対応していません。
制約(Bitbucket Cloud限定・必ず確認する)
2026年4月の対応開始時点では、認証はAPI tokenのみに限定され、Jira・Confluenceで使えるOAuth 2.1はBitbucketには非対応でした。Atlassianはこれをロードマップの筆頭に挙げていましたが、現行のサポートページではread_bitbucket・write_bitbucketともに「OAuth 2.1 and API token authentication」で使えると案内されており、OAuth対応はすでに追いついています。API tokenでの認証を使うには、組織管理者がAdmin Hubの「Rovo > Rovo MCP Server」からAPI token認証を有効化しておく必要があります。OAuthで繋ぐ場合はこの管理者設定は不要です。
Claude Codeへの接続
Atlassian Rovo MCP ServerはClaude Code向けのコマンドが公式に案内されています。
claude mcp add --transport http atlassian https://mcp.atlassian.com/v2/mcp追加後、Claude Codeのセッション内で/mcpを実行して認証フローを開始します。すでにJira・Confluence用にこのMCPサーバーを登録済みなら、この手順は不要です。既存の接続がv2エンドポイントに向いているかだけ確認します。
Atlassianの発表では、v1で登録した既存の接続は2027年3月1日以降に自動的にv2のツール(Bitbucketを含む)を露出し始める予定です。それより前にBitbucketツールを使うには、上記のように接続先をhttps://mcp.atlassian.com/v2/mcpにした新規登録が主な導線になります。なお自動移行後もクライアントによってはキャッシュされたクライアントIDや.well-knownの認証情報が古いままだと認証エラーになることがあります。挙動がおかしい場合は、Claude Code側で一度接続を削除してから登録し直します。
claude.ai・Claude Desktop・Coworkへの接続
claude.aiではhttps://claude.ai/directory/connectors/atlassianから一括インストールできます。手動で追加する場合は、Team・Enterpriseプランなら「Organization settings > Connectors」、Pro・Maxプランなら「Customize > Connectors」からhttps://mcp.atlassian.com/v2/mcpをカスタムコネクタとして登録します。Claude Desktopの場合は「Settings > Extensions > Browse extensions > Plugins」からAtlassianを検索してインストールするか、claude_desktop_config.jsonに直接サーバーURLを書きます。
よくあるつまずき
接続直後にBitbucketのツールが見当たらなくても、故障とは限りません。Atlassian Rovo MCPは接続時にすべてのツール定義を一度に送るのではなく、atlassianUserInfoやdiscoverのような主要ツールだけを最初に見せ、必要に応じて自然言語検索でツールカタログから残りを探させる設計になっています。これはクライアント側のコンテキストを圧迫しないための仕組みで、再接続しなくても新しいツールが使えるようになる利点もあります。全ツールを一度に見たいときはhttps://mcp.atlassian.com/v2/mcp?tools=allのように末尾にクエリを付けたエンドポイントを使います。
そのうえでJira・Confluenceは使えるのにBitbucketだけ本当に見当たらない場合、まず疑うのはワークスペースが組織に紐づいているかどうかです。API token認証を使う設定にしている場合は、組織管理者側でAdmin Hubの認証設定が有効化されているかも確認します。
組織にIPアローリストを設定している場合は、Atlassian Rovo MCP経由のアクセスにも同じ制限がかかります。許可されていないIPから接続すると、OAuthの同意画面自体は表示されてもツール呼び出しはすべて失敗し、「You don't have permission to connect from this IP address.」というエラーになります。社用VPN経由でも、AIツール自身が発信するIPレンジがアローリストに含まれていなければ同じエラーになるため、社内ネットワークだから安全とは限りません。
MCPクライアントはJira・Confluence・Bitbucketを含む接続済みのすべての製品に対して、ユーザーが持つ既存の権限の範囲で操作できます。PRのマージやコミットの作成は実際にリポジトリの状態を変える操作なので、共有リポジトリでは実行前に内容を確認します。
Bitbucket Server・Data Centerを使っている組織は、いくら設定を見直してもBitbucketのツールは有効になりません。対応はBitbucket Cloudに限られているため、オンプレミス版ではこの経路を使えません。
まとめ
Atlassian Rovo MCP ServerはBitbucket Cloudのワークスペース閲覧からPRのライフサイクル、パイプライン確認までを1つの接続でカバーします。認証はOAuth 2.1・API tokenどちらにも対応済みですが、対象は組織にリンクされたBitbucket Cloudワークスペースに限られ、Server・Data Centerは今も対象外です。Jira・Confluence向けの同種MCP接続やGitLab連携を検討している場合は、Claude CodeのGitLab連携ガイドやGitLab CI/CDへの組み込みも参考になります。コネクタが会話で使えるインタラクティブな表示に対応しているかどうかは、Claudeのインタラクティブコネクタで扱っています。