CursorとGitHubの連携完全ガイド【2026年最新】：GitHub MCP・GitHub Actions・ブランチ管理まで徹底解説

CursorとGitHubの連携は、大きく3つの層で考えると整理しやすいです。

CursorでGitHubリポジトリを開く基本設定

リポジトリのクローン方法

ターミナルでのcloneはGitと同じコマンドです。

# HTTPSでクローン
git clone https://github.com/{username}/{repository}.git

# SSHでクローン（SSHキーを設定済みの場合）
git clone git@github.com:{username}/{repository}.git

クローン後はcursor {ディレクトリ名}でCursorを起動するか、Cursorのメニューから「File → Open Folder」でフォルダを開きます。

コードベースインデックスを有効にする

コードベースインデックスの設定手順は以下の通りです。

1. Cursorの設定画面を開く（Cmd+, または Ctrl+,）
2. 「Features」→「Codebase indexing」に進む
3. 「Enable codebase indexing」をオンにする
4. 「Resync Index」ボタンでインデックスを再構築する

GitHubの外部ドキュメントをインデックスに追加する

GitHub MCP Serverで直接GitHub操作を可能にする

GitHub MCP Server のインストール（リモートサーバー方式）

設定は~/.cursor/mcp.json（グローバル）または.cursor/mcp.json（プロジェクト固有）に書きます。

{
  "mcpServers": {
    "github": {
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer YOUR_GITHUB_PAT"
      }
    }
  }
}

YOUR_GITHUB_PATの部分をGitHubのPersonal Access Token（PAT）に置き換えます。

Dockerを使ったローカルサーバー方式

{
  "mcpServers": {
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"
      }
    }
  }
}

動作確認と使い方

使えるようになる操作の代表例をまとめると、こうなります。

ブランチ・コミット・PRをCursorから操作する

AIによるコミットメッセージ生成

Cursorのソースコントロールでコミットメッセージを生成する手順は以下の通りです。

1. ファイルをステージング（「+」ボタン）
2. コミットメッセージ入力欄の「✦」（AI生成）ボタンをクリック
3. 生成されたメッセージを確認して必要に応じて編集
4. 「Commit」ボタンでコミット

PRの説明文をAIに書かせる

CursorのチャットでPR説明を生成する際のプロンプト例です。

現在のブランチの変更内容を確認して、以下の構成でPR説明文を書いてください：
- 変更の概要（1-2文）
- 変更理由
- 主な変更点（箇条書き）
- テスト方法

GitHub MCPを使って、origin/mainに対してPRを作成してください。

ブランチ管理とフォーク

Cursor CLIをGitHub Actionsに組み込む

Cursor CLIをGitHub Actionsに組み込む基本的なワークフロー例です。

name: Cursor AI Review
on:
  pull_request:
    types: [opened, synchronize]

jobs:
  cursor-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Install Cursor CLI
        run: npm install -g @cursor/cli

      - name: Run Cursor Review
        env:
          CURSOR_API_KEY: ${{ secrets.CURSOR_API_KEY }}
        run: |
          cursor agent run \
            "Review the changes in this PR and provide feedback on code quality, potential bugs, and improvement suggestions"

Cloud Agentとの連携

GitHub CopilotとCursorの比較

よくあるエラーと対処法

「GitHub MCP failing to start」エラー

対処手順はこちらです。

1. ~/.cursor/mcp.jsonのJSON形式をバリデーターで確認
2. GitHubのPATが失効していないか確認（有効期限を設定している場合）
3. PATのスコープに必要な権限が含まれているか確認
4. Cursorを完全に再起動（タスクマネージャーからプロセスを終了）

npmパッケージを使っているのに動かない

Cursor CLIでPRレビューの認証エラー

インデックスが更新されない

よくある質問（FAQ）

Q：GitHub Educationのアカウント（EDU）でCursorは無料で使えるの？

Q：GitHub Copilotを使っているが、Cursorに移行する価値はある？

Q：プライベートリポジトリでもコードベースインデックスは使える？

CursorとGitHubを使う際のセキュリティ注意点

CursorとGitHubでのシークレット管理ベストプラクティス

• .envファイルは必ず.gitignoreに追加する
• git diffでコミット前に変更内容を確認する習慣をつける
• GitHub の「Secret scanning」機能を有効にする（パブリックリポジトリはデフォルトON）
• GitGuardianのようなシークレット検出ツールをCI/CDに組み込む
• Cursor Rulesに「シークレットをハードコードしない」「.envは読まない」と明記する

Cursorのコードプライバシー設定

GitHubとCursorを使ったチーム開発のベストプラクティス

Cursor Rulesのチーム共有

# cursor/rules/coding-style.mdc
---
description: コーディングスタイルとセキュリティルール
alwaysApply: true
---

# チームコーディングルール

## セキュリティ
- APIキー・シークレットは絶対にハードコードしない
- 環境変数は必ず .env から読み込む（.env はコミットしない）
- git commit前に必ず git diff で変更内容を確認する

## コーディングスタイル
- TypeScript を使用する（JavaScript は避ける）
- ESLint・Prettier の設定に従う
- 関数のコメントは JSDoc 形式で書く

## PRルール
- PRの説明は必ず「変更理由」「変更内容」「テスト方法」を含める
- 1つのPRは1つの機能変更に絞る

GitHub Issueドリブンの開発フロー

開発フローのステップはこんな感じです。

1. GitHubでIssueを作成（詳細な要件・受け入れ条件を書く）
2. CursorのチャットでGitHub MCPを使い、Issueを読み込む
3. AIにIssueの内容を分析させて、実装方針を確認する
4. feature/issue-{番号}のブランチを作成
5. AIエージェントに実装させて、適宜レビューと修正
6. コミット・プッシュし、GitHub MCP経由でPRを作成
7. PRにIssueへの参照（「Closes #123」）を含める

GitHub ActionsとCursorを組み合わせたCI/CDのポイント

1. CURSOR_API_KEYをGitHub Secretsに登録する: ワークフローファイルに直接書かないこと
2. タイムアウトを設定する: Cursor CLIのタスクは長時間かかる場合があるので、timeout-minutesを設定する
3. コスト管理: Cursor CLIの実行にはトークンが消費されるため、すべてのPRで実行するのではなく、mainブランチへのマージリクエストに限定するなど条件を絞る

Cursor 2.6とGitHub連携の最新アップデート

Cursor CLIの使い方とGitHub連携

CLI経由でGitHub MCPを使うと、スクリプト化が容易になります。

#!/bin/bash
# PR自動レビュースクリプト
PR_NUMBER=$1

cursor agent run \
  "GitHub MCPを使ってPR #${PR_NUMBER}の変更内容を確認して、
   コード品質・潜在的なバグ・改善点についてレビューコメントを書いてください。
   レビューは日本語で書いてください。"

GitHubのドキュメントをCursorに読み込んでコーディング精度を上げる

@Docsへの追加手順は以下の通りです。

1. CursorのチャットかComposerで@Docsと入力する
2. 「Add new doc」を選択する
3. GitHubのREADMEやドキュメントサイトのURLを入力する
4. インデックスが完成するまで待つ（数分〜10分程度）

CursorとClaude Code、GitHubを使った実践的な開発体制

GitHub Forking・ブランチ戦略とCursorの組み合わせ

OSSコントリビューションの基本フロー（CursorとGitHub MCPを使った場合）です。

1. GitHub MCPで対象リポジトリをfork
2. forkしたリポジトリをローカルにclone（git clone git@github.com:{自分のユーザー名}/{リポジトリ}.git）
3. Cursorでリポジトリを開き、コードベースをインデックス化
4. AIにコントリビューションしたいIssueを読ませて、実装方針を確認
5. feature branchを切って実装
6. テスト・コミット・プッシュ
7. GitHub MCPでPRをupstream（本家）に向けて作成
8. PRの説明文をAIに生成させて、コントリビューションガイドラインに沿って修正

GitHub Actionsとのブランチ連携（CI/CD設計）

CIエラーをCursorで修正する典型的なフローです。

1. GitHub ActionsでCIが失敗する
2. CursorのチャットでGitHub MCPを使い、失敗したActionsのログを取得
3. 「このCIエラーの原因を分析して、修正案を出して」と依頼
4. 修正案を確認してコミット
5. 再度CIを実行して通過を確認

まとめ

出典

• GitHub MCP Server公式リポジトリ
• GitHub MCP Server Cursorインストールガイド
• Cursor公式ドキュメント（GitHub Actions）
• Cursor公式ドキュメント（Cloud Agent）