メインコンテンツへスキップ
Background Agents と Bugbot がリポジトリをクローンし、変更をプッシュするには、Cursor GitHub アプリが必要だ。

​
インストール

  1. ダッシュボードの Integrations に移動
  2. GitHub の横にある Connect をクリック
  3. リポジトリは All repositories か Selected repositories を選択
GitHub アカウントを切断するには、Integrations ダッシュボードに戻って Disconnect Account をクリック。

​
GitHub で Agent を使う

GitHub 連携を使うと、pull request や issue から直接、バックグラウンドのエージェントワークフローを実行できる。任意の PR や issue に @cursor [prompt] とコメントすると、エージェントがコンテキストを読み取り、修正を実装して、コミットをプッシュする。 Bugbot を有効にしてる場合は、@cursor fix とコメントするだけで、Bugbot の提案修正を読み取り、問題に対応するバックグラウンドエージェントを起動できる。

​
権限

GitHub アプリはバックグラウンドエージェントと連携するために特定の権限が必要だよ:
権限目的
Repository accessコードをクローンして作業用ブランチを作成
Pull requestsエージェントの変更を含む PR を作成してレビュー用に提出
Issuesエージェントが見つけた／修正したバグやタスクを追跡
Checks and statusesコード品質とテスト結果をレポート
Actions and workflowsCI/CD パイプラインとデプロイ状況を監視
すべての権限は、バックグラウンドエージェントの機能に必要な最小権限の原則に従っている。

​
IP許可リストの設定

組織でGitHubのIP許可リスト機能を使ってリポジトリへのアクセスを制限してる場合、チームでIP許可リスト機能を有効にするために、まずサポートに連絡してね。

​
サポートへの連絡

IP許可リストを設定する前に、この機能をチーム向けに有効化してもらうため hi@cursor.com に連絡してね。これは以下のどちらの設定方法でも必須だよ。 Cursor GitHubアプリには、あらかじめIPリストが設定されてる。インストール済みアプリ向けの許可リストを有効化すると、このリストを自動的に継承できる。これは「推奨の方法」で、こっちでリストを更新すると、組織側にも自動で反映されるよ。 有効化する手順:
  1. 組織のSecurity設定へ移動
  2. IP許可リスト設定へ進む
  3. 「Allow access by GitHub Apps」をチェック
詳しい手順は、GitHubのドキュメントを参照してね。

​
許可リストにIPを直接追加する

組織がGitHubでIdP定義の許可リストを使っている、または事前設定済みの許可リストを使えない場合は、IPアドレスを手動で追加できるよ。 
184.73.225.134
3.209.66.12
52.44.113.131
IP アドレス一覧はまれに変更されることがある。IP アローリストを使っているチームには、IP アドレスの追加や削除の前に事前に案内する。

​
トラブルシューティング

  • リポジトリにアクセス権のある GitHub アプリをインストールする
  • プライベートリポジトリの権限を確認する
  • 自分の GitHub アカウントの権限を確認する
  • アプリにプルリクエストへの書き込み権限を付与する
  • ブランチ保護ルールを確認する
  • アプリのインストールが期限切れの場合は再インストールする
  • 組織レベルでインストールされているか確認する
  • github.com/apps/cursor から再インストールする
  • インストールが破損している場合はサポートに連絡する