Bitbucket MCP

概要

Bitbucket MCP は、Bitbucket Cloud および Bitbucket Server/Data Center API と統合するためのオープンソースの Model Context Protocol (MCP) サーバーです。これにより、AI アシスタント（Cursor など）が自然言語のプロンプトを通じて、Bitbucket のリポジトリ、プルリクエスト、パイプライン、その他のリソースと安全にやり取りできるようになります。

このサーバーは MCP 標準を実装しており、npm に bitbucket-mcp として公開されています。

機能

• リポジトリ操作: リポジトリの一覧表示と詳細の取得
• プルリクエストのライフサイクル: 一覧表示、取得、作成、更新、マージ、承認、却下、コメントの追加/表示、差分、タスク
• パイプライン操作: 実行の一覧表示、パイプラインの起動/停止、ステップとログの表示
• ページネーション対応 (pagelen、page、all、limit)
• 安全優先設計: BITBUCKET_ENABLE_DANGEROUS=true が明示的に設定されていない限り、DELETE 操作は無効

サポートされている操作

このサーバーは、リポジトリブラウジング、PR 管理、コードレビューの自動化、パイプライン監視など、一般的な Bitbucket ワークフロー用のツールを提供します。ツール一覧と API マッピングの詳細はソースコードで定義されています。

セキュリティとベストプラクティス

• 最小権限（リポジトリ: 読み取り、プルリクエスト: 読み取り/書き込み、パイプライン: 読み取り）の Bitbucket アプリパスワード（またはアクセストークン）が必要
• デフォルトでは DELETE 操作は無効
• ログ出力の設定が可能（ファイルベースまたは無効化）
• 設定可能な BITBUCKET_URL により、Bitbucket Cloud (https://api.bitbucket.org/2.0) およびセルフホストの Bitbucket Server の両方をサポート

互換性

MCP 互換の任意の AI ランタイムで動作します。主な統合例は Cursor に焦点を当てていますが、Bitbucket Cloud および Server をサポートします。

リンク

• GitHub リポジトリ
• npm パッケージ
• Bitbucket REST API リファレンス

MCP セットアップ

前提条件

• Node.js が必要（npx/npm 利用時）
• アプリパスワードまたはアクセストークンを持つ Bitbucket アカウント

アクセス要件

• Bitbucket アプリパスワード（リポジトリ: 読み取り、プルリクエスト: 読み取り/書き込み、パイプライン: 読み取り）またはアクセストークンが必要。環境変数で指定します。

クライアントセットアップ

Cursor

{
  "mcpServers": {
    "bitbucket": {
      "command": "npx",
      "env": {
        "BITBUCKET_URL": "https://api.bitbucket.org/2.0",
        "BITBUCKET_WORKSPACE": "あなたのワークスペース",
        "BITBUCKET_USERNAME": "あなたのユーザー名",
        "BITBUCKET_PASSWORD": "あなたのアプリパスワード"
      },
      "args": ["-y", "bitbucket-mcp@latest"]
    }
  }
}

• プロジェクトのルートに .cursor/mcp.json を作成または編集します。
• 上記の設定ブロックを貼り付け、プレースホルダー（your-workspace、your-username、your-app-password）を実際の値に置き換えてください。

認証:

• 認証情報はMCP設定の環境変数を介して渡されます。ブラウザでのサインインや追加の認証手順は必要ありません。

レガシーURL形式（https://bitbucket.org/your-workspace ）もワークスペースの自動検出でサポートされています。

Claude Code

未記載

Claude Desktop

未記載

VS Code

未記載

Codex

未記載

Windsurf

未記載

Lovable

未記載

Other

必要な環境変数（envVarsを参照）を指定して npx -y bitbucket-mcp@latest で実行します。stdio/commandトランスポートを使用してMCPクライアントで設定してください。

環境変数

• BITBUCKET_URL（デフォルトは https://api.bitbucket.org/2.0 ）
• BITBUCKET_WORKSPACE（オプション、レガシーモードではURLから自動検出）
• BITBUCKET_USERNAME（あなたのBitbucketメールアドレス/ユーザー名）
• BITBUCKET_PASSWORD（アプリパスワードまたはAPIトークン）
• BITBUCKET_TOKEN（ユーザー名/パスワードの代替）

セットアップドキュメント: https://github.com/MatanYemini/bitbucket-mcp