GitHub
Cursor GitHub app をリポジトリに接続すると、Cloud Agents や Bugbot などの機能を使用できます。
セットアップ
Cursor の管理者アクセス権と GitHub Organization の管理者アクセス権が必要です。
- ダッシュボードの連携に移動します
- GitHub の横にある Connect をクリックします (すでに接続済みの場合は Manage Connections)
- All repositories または Selected repositories を選択します
- ダッシュボードに戻り、リポジトリの機能を設定します
GitHub アカウントを切断するには、連携ダッシュボードに戻って Disconnect Account をクリックします。
IP 許可リストの設定
組織で GitHub の IP 許可リスト機能を使用してリポジトリへのアクセスを制限している場合、Cursor は限られた IP アドレスを使用するホスト型のエグレスプロキシを使用するように設定できます。
IP 許可リストを設定する前に、hi@cursor.com までご連絡いただき、チームでこの機能を有効にしてください。以下のどちらの設定方法でも必要です。
インストール済み GitHub Apps の IP 許可リスト設定を有効にする (推奨)
Cursor GitHub app には、IP リストがあらかじめ設定されています。インストール済みのアプリで許可リストを有効にすると、このリストが自動的に継承されます。リストの更新が当社側で可能になり、その更新が組織に自動的に反映されるため、この方法を推奨します。
有効にするには:
- 組織の Security 設定に移動します
- IP 許可リストの設定に移動します
- **「GitHub Apps によるアクセスを許可」**をオンにします
詳しい手順については、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 へのウェブフック送信も、パブリックインターネットへのアウトバウンド通信なしで行えます。
最適な用途: 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 アプリをインストール
- プライベートリポジトリの権限を確認
- GitHub アカウントの権限を確認
- アプリにプルリクエストへの書き込み権限を付与
- ブランチ保護ルールを確認
- アプリのインストールの有効期限が切れている場合は再インストール
- 組織レベルでインストールされているか確認
- github.com/apps/cursor から再インストール
- インストールが破損している場合はサポートに問い合わせ
次のステップ
GitHub 連携を接続したら、それを使用する機能を設定します。
- Bugbot — バグやセキュリティ上の問題を検出する自動 PR 確認
- Cloud Agents — クラウドでリポジトリ上の作業を実行する AI エージェント