GitHub
Cursor GitHub app をリポジトリに接続すると、Cloud Agents や Bugbot などの機能を使用できます。
セットアップ
Cursor と GitHub 組織の管理者権限が必要です。
- ダッシュボードの連携に移動します
- GitHub の横にある 接続 をクリックします (すでに接続済みの場合は 接続を管理)
- すべてのリポジトリ または 選択したリポジトリ を選択します
- ダッシュボードに戻り、リポジトリの機能を設定します
GitHub アカウントを切断するには、連携ダッシュボードに戻り、アカウントを切断 をクリックします。
IP 許可リストの設定
組織で GitHub の IP 許可リスト機能を使用してリポジトリへのアクセスを制限している場合、Cursor では限られた IP アドレスのみを使用するホスト型エグレスプロキシを設定できます。
推奨される GitHub Apps の設定は GitHub で行います。これを有効にするために Cursor は必要ありません。代わりに git エグレスプロキシ IP をご自身で追加する場合は、チームで git エグレスプロキシを有効にできるよう、hi@cursor.com に連絡してください。そうしない場合、git トラフィックがそれらのアドレスから送信されない可能性があります。
インストール済み GitHub Apps の IP 許可リストの設定を有効にする (推奨)
Cursor GitHub app には、IP リストがすでに事前に設定されています。インストール済みアプリの許可リストを有効にすると、このリストを自動的に引き継げます。これが推奨される方法です。これにより、当社でリストを更新でき、組織にも自動的に反映されます。
これは Cursor GitHub App に登録されている IP リストを引き継ぎます。これらのアドレスを使用するすべてのクライアントを許可するものではありません。
有効にするには:
- 組織のセキュリティ設定に移動します
- IP 許可リスト設定に移動します
- **「インストール済み GitHub Apps の IP 許可リストの設定を有効にする」**をオンにします
詳しい手順については、GitHub のドキュメントを参照してください。
許可リストに IP を直接追加する
組織で GitHub の IdP によって定義された許可リストを使用している場合、または事前設定済みの許可リストを使用できない場合は、Git egress proxy と IP 許可リスト に記載されているプロキシ IP を追加してください。
高度なネットワーク設定
セルフホスト型インスタンスでは、IP ホワイトリスト登録以外にも複数の接続方法を利用できます。セットアップの詳細とサポート対象のプライベートネットワークオプションについては、プライベート接続を参照してください。
Enterprise プランのお客様にご利用いただけます。GitHub Enterprise Server が AWS 上で稼働している場合、または AWS Network Load Balancer の背後に配置できる場合は、AWS PrivateLink を使用します。PrivateLink を使用すると、Cursor から GHES へアクセスでき、必要に応じてパブリックインターネット経由のアウトバウンド通信なしで GHES から Cursor へ Webhook を送信することもできます。
最適な用途: AWS でホストされている GHES インスタンス、プライベート VPC エンドポイント接続を必要とするチーム
セキュリティ: HTTPS 暗号化、AWS PrivateLink、VPC エンドポイントポリシー、サービスアカウントアクセストークン
デメリット: Cursor との調整および AWS エンドポイントサービスのセットアップが必要です。
Enterprise プランのお客様にご利用いただけます。AWS PrivateLink が現実的でない場合や、アウトバウンド通信のみのデプロイモデルが必要な場合は、Cloudflare Tunnel を使用します。ネットワーク内で cloudflared を実行し、Cursor がトンネルのホスト名とトークンを提供します。
最適な用途: インバウンドネットワークアクセスがない環境
セキュリティ: HTTPS 暗号化、Cloudflare Tunnel、サービスアカウントアクセストークン
デメリット: 自分の環境で cloudflared を実行・保守する必要があります。
権限
GitHub App は、Cursor の機能をサポートするために、次の権限を要求します。
| 権限 | 用途 |
|---|---|
| リポジトリへのアクセス | コードをクローンし、作業用ブランチを作成する |
| プルリクエスト | PR を作成し、確認コメントを残す |
| Issues | 確認中に見つかったバグやタスクを追跡する |
| チェックとステータス | コード品質とテスト結果を報告する |
| Actions とワークフロー | CI/CD パイプラインを監視し、プルリクエストから CI を再実行する |
| 管理 | PR をマージできるか判断するために、ブランチ保護ルールと必須チェックルールを読み取る |
| カスタムリポジトリロール | 適切なマージおよび確認オプションを表示するため、ユーザーのアクセスレベルを判断する |
| Organization のカスタムプロパティ | 組織で定義されたリポジトリメタデータをフィルタリングに表示する |
すべての権限は、最小権限の原則に従います。
Protected Git Scopes
GitHub組織をCursor組織に紐付け、Cloud Agents、自動化、Bugbotでそのリポジトリを使用できるのをチームのみに制限します。スコープを保護するには、GitHub組織のオーナーまたは管理者権限が必要です。Protected Git Scopesを参照してください。
トラブルシューティング
- リポジトリへのアクセス権限を付与して GitHub App をインストールする
- プライベートリポジトリの権限を確認する
- GitHub アカウントの権限を確認する
- App にプルリクエストへの書き込み権限を付与する
- ブランチ保護ルールを確認する
- App のインストールの有効期限が切れている場合は再インストールする
- 組織レベルでインストールされているか確認する
- github.com/apps/cursor から再インストールする
- インストールに問題がある場合はサポートに問い合わせる
次のステップ
GitHub 連携を接続したら、それを使用する機能を設定します。
- Bugbot — バグやセキュリティ上の問題を検出する自動 PR 確認
- Cloud Agents — リポジトリ上でクラウド実行される AI エージェント