Bitbucket
Bitbucket CloudのリポジトリをCloud AgentsおよびBugbotに接続できます。Bitbucket Data CenterのリポジトリをBugbotに接続できます。
セットアップ
Bitbucket Cloud 連携はパブリックベータ版です。bitbucket.org 上のリポジトリに対応しています。
Bitbucket Cloud のセットアップは2つの部分に分かれており、それぞれ異なるロールが必要です。
- 各開発者は自身の Bitbucket アカウントを接続し、Cursor がそのユーザーとしてリポジトリをクローンし、ブランチをプッシュし、プルリクエストを作成できるようにします。
- Bitbucket Workspace 管理者は Cursor アプリをインストールし、Bugbot のコメントや Cloud Agent のステータスコメントを Cursor として表示できるようにします。インストール済みのアプリを Cursor チームにリンクするには、Bitbucket workspace にアクセスできる Cursor チーム管理者が必要です。
Bitbucket アカウントを接続する
使用する Bitbucket workspace 内のリポジトリへのアクセスが必要です。
- ダッシュボードの連携に移動します
- Bitbucket の横にある 接続 をクリックします
- Bitbucket で Cursor を認可します
- ダッシュボードに戻り、連携が 接続済み と表示されていることを確認します
Cloud Agent を開始する、または Cursor からプルリクエストを作成するユーザーは、それぞれ自身の Bitbucket アカウントを接続する必要があります。
Bitbucket に Cursor アプリをインストールする
Bitbucket Workspace 管理者が、workspace に Cursor アプリをインストールする必要があります。これにより、リポジトリイベント、Bugbot のレビューコメント、インラインコメント、ステータス更新に使用する安定したアプリ ID が Cursor に付与されます。
手順1～4には Bitbucket Workspace 管理者が必要です。手順5～6には、Bitbucket workspace にアクセスできる Cursor チーム管理者が必要です。1人でセットアップ全体を行う場合は、両方のロールが必要です。
- ダッシュボードの連携に移動します
- Bitbucket を見つけて管理メニューを開きます
- Cursor アプリをインストールをクリックします
- Bitbucket workspace にアプリをインストールします
- Bitbucket workspace の設定で、Forge Apps の下にある Cursor を選択します
- Cursor に接続をクリックし、リンクする Cursor チームを選択します
workspace をリンクすると、ダッシュボードにその Bitbucket workspace 用の Cursor アプリがインストール済みと表示されます。
アプリのインストール後、Bitbucket から Cursor への通知に数分かかる場合があります。Cursor がすぐに workspace を見つけられない場合は、しばらく待ってからリンク手順をもう一度試してください。
Cursor による Bitbucket Cloud ID の使い分け
Cursor はアクションごとに異なる Bitbucket ID を使用します。
| アクション | Bitbucket ID |
|---|---|
| Bugbot の要約コメント、インラインコメント、ビルドステータス | Cursor アプリ |
| プルリクエスト上の Cloud Agent の進行状況コメント | Cursor アプリ |
| Git クローン、ブランチのプッシュ、コミット、プルリクエストの作成 | 接続された Bitbucket ユーザー |
Cloud Agent が作成したプルリクエストは、エージェントを開始したユーザーに紐づきます。workspace アプリがインストールされている場合、Bugbot の出力は Cursor から表示されます。
権限
Bitbucket Cloud 連携では、Cloud Agent と Bugbot をサポートするために必要な権限を要求します。
| 権限 | 目的 |
|---|---|
| アカウント | 接続された Bitbucket ユーザーを識別する |
| リポジトリ | リポジトリの一覧表示、クローン、コンテンツの読み取り |
| プルリクエスト | プルリクエストの diff とメタデータを読み取る |
| プルリクエストの書き込み | プルリクエストの作成とコメントの投稿 |
| Webhook | リポジトリおよびプルリクエストのイベントを受信する |
Bitbucket Cloud の接続を解除する
Bitbucket Cloud の接続を解除すると、次の2つの影響があります。
- アカウントを切断すると、Cursor から個人の Bitbucket OAuth 接続が削除されます。
- Cursor アプリを切断すると、Bitbucket workspace と Cursor チームのリンクが解除されます。Workspace 管理者が Bitbucket 側で削除するまで、アプリは Bitbucket にインストールされたままにできます。
workspace からのアプリイベントを完全に停止するには、Bitbucket workspace の設定から Cursor アプリをアンインストールしてください。
高度なネットワーク設定
Bitbucket Data Center は、パブリックインターネットからのトラフィックを受け付けられないインスタンス向けに、プライベート接続方式をサポートしています。
Enterprise プランのお客様にご利用いただけます。プライベートネットワーク接続を介して Cursor からインスタンスにアクセスできるようにします。セットアップについては、プライベート接続を参照するか、Cursor 担当者にお問い合わせください。
最適な用途: ファイアウォールの背後にあるインスタンス (AWS でホストされるインスタンスや、cloudflared を実行できる環境を含む)
セキュリティ: HTTPS 暗号化、AWS PrivateLink、Cloudflare Tunnel、VPC 許可リスト、サービスアカウントアクセストークン
欠点: Cursor との調整が必要です。Google Private Service Connect は現在サポートされていません。
Enterprise プランのお客様にご利用いただけます。オンプレミスで、Cursor へのアウトバウンド接続を確立するリバースプロキシトンネルを実行します。ネットワーク要求はトンネル経由で転送されるため、Bitbucket インスタンスにパブリックなインバウンドアクセスは必要ありません。セットアップについては、Cursor 担当者にお問い合わせください。
最適な用途: インバウンドネットワークアクセスがない環境
セキュリティ: HTTPS 暗号化、サービスアカウントアクセストークン
欠点: より直接的な接続方式と比べて、複雑さやメンテナンスの負担が増え、セキュリティ面での考慮事項も生じます
トラブルシューティング
Bitbucket アプリのインストールイベントの同期には数分かかる場合があります。しばらく待ってから、Bitbucket workspace の設定で Connect to Cursor の手順を再試行してください。
- Cursor チーム管理者であることを確認してください。アプリのインストールには Bitbucket workspace 管理者権限が必要ですが、workspace を Cursor チームにリンクするには Cursor チーム管理者権限が必要です。
- リンクする workspace へのアクセス権が Bitbucket ユーザーにあることを確認してください。
Bitbucket workspace に Cursor アプリをインストールし、Cursor チームにリンクしてください。Cursor アプリとしてコメントを投稿するには、個人の Bitbucket 接続だけでは不十分です。
- 連携ダッシュボードから個人の Bitbucket アカウントを接続してください。
- Bitbucket ユーザーにリポジトリへの読み取り・書き込み権限があることを確認してください。
- リポジトリが
bitbucket.org上の Bitbucket Cloud にあることを確認してください。
- サービスアカウントトークンが有効であることを確認してください。
- サービスアカウントがリポジトリにアクセスできることを確認してください。
- Cursor が HTTPS 経由でインスタンスのホスト名または設定済みの外部ホストに到達できることを確認してください。
- Cursor チーム管理者であることを確認してください。
- 登録済みのインスタンスにサービスアカウントトークンが設定されていることを確認してください。
- サービスアカウントにリポジトリの管理者権限があることを確認してください。
次のステップ
Bitbucket を接続したら、Bitbucket を使用する機能を設定します。
- Bugbot - バグやセキュリティ上の問題を検出する自動 PR 確認
- Cloud Agents - Bitbucket Cloud リポジトリ向けの AI エージェント