bitbucket

エージェントの環境で認証済みの Bitbucket MCP ツールが利用できる場合は、まずそれを使用してください。特定の MCP サーバー名に依存せず、ツールが利用可能かどうかで判断します。その場合も、Cloud と Data Center のどちらかを特定し、対応する詳細なスキルを読み込んでください。トークンと直接 API を使う手順は、Bitbucket MCP ツールが利用できない場合、または生の API や curl によるアクセスが明示的に必要な場合にのみ使用してください。

Bitbucket を使用します。Bitbucket には、動作が異なる 2 つの製品があります。

• Bitbucket Cloud（bitbucket.org）— BITBUCKET_TOKEN 環境変数で認証します。
• Bitbucket Data Center（セルフホスト型の Bitbucket Server）— BITBUCKET_DATA_CENTER_TOKEN 環境変数で認証します。

これらは REST API、リポジトリ識別子、git リモート URL の形式、プルリクエストツールが異なります。そのため、まずどちらを使用しているかを特定し、手順の詳細を確認するために対応するスキルを読み込んでください。

手順 1 — 使用中の Bitbucket を特定する

まず、リポジトリのホストまたは利用可能な Bitbucket MCP ツールのコンテキストから、製品を特定してください。トークンを使う場合は、どのトークン環境変数が存在するかを確認します。環境変数名では大文字と小文字が区別されるため、大文字と小文字を区別せずに検索してください。

env | grep -i 'bitbucket' || echo "no bitbucket token found"

• BITBUCKET_DATA_CENTER_TOKEN 変数が設定されている場合（大文字と小文字のどの表記でも）→ Bitbucket Data Center を使用しています。
• それ以外で、BITBUCKET_TOKEN 変数が設定されている場合 → Bitbucket Cloud を使用しています。
• どちらも設定されていない場合は、続行する前に Bitbucket の認証方法をユーザーに尋ねてください。

後でトークンに言及する際は、環境に実際に存在する変数名を、正確な大文字と小文字の表記で使用してください。

手順 2 — 詳細なスキルを読み込む

環境がわかったら、invoke_skill ツールを使って、API 呼び出し、認証済み git リモート、プルリクエストの作成に関する詳細な手順を確認するため、対応するスキルを読み込んでください。

• Bitbucket Cloud → bitbucket-cloud スキルを呼び出します。
• Bitbucket Data Center → bitbucket-data-center スキルを呼び出します。

クイックリファレンス（フォールバック）

詳細なスキルを読み込めない場合は、以下が基本情報です。必ず Bitbucket API を使用し（Web ブラウザーは使用しないでください）、プルリクエストの作成には必ず指定された PR ツールを使用してください。

	Bitbucket Cloud	Bitbucket Data Center
トークン環境変数	BITBUCKET_TOKEN	BITBUCKET_DATA_CENTER_TOKEN
ホスト	bitbucket.org	セルフホスト型ドメイン
REST API のベース URL	https://api.bitbucket.org/2.0	https://<host>/rest/api/1.0
リポジトリ識別子	workspace/repo_slug	PROJECT/repo_slug（プロジェクトキー）
プルリクエストツール	create_bitbucket_pr	create_bitbucket_data_center_pr