# Bitbucket MCP

Bitbucket CloudおよびServer向けのModel Context Protocol (MCP)サーバーで、CursorなどのAIアシスタントが自然言語を使用してリポジトリ、プルリクエスト、パイプラインなどを管理できるようにします。

Canonical URL: https://a2a-mcp.org/entry/bitbucket-mcp-ja

Language: ja

Category: MCP Servers

Updated: 2026-05-13

## 概要
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 リポジトリ](https://github.com/MatanYemini/bitbucket-mcp)
- [npm パッケージ](https://www.npmjs.com/package/bitbucket-mcp)
- [Bitbucket REST API リファレンス](https://developer.atlassian.com/cloud/bitbucket/rest/intro/)

## MCP セットアップ

### 前提条件

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

### アクセス要件

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

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

#### Cursor

```json
{
  "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

## Tags

- mcp-server
- bitbucket
- nodejs
- プルリクエスト
- パイプライン
- リポジトリ
- AI統合

## Sources

- [Project website](https://github.com/MatanYemini/bitbucket-mcp)