室谷代表取締役
テキトー教師.AI認定講師「リポジトリをクローンするだけじゃないの?」っていう認識の人も結構いますよ。
室谷代表取締役
テキトー教師.AI認定講師この記事でその全体像を整理していきましょう。
CursorとGitHubの連携は、大きく3つの層で考えると整理しやすいです。
| 層 | 機能 | 必要なもの |
|---|---|---|
| 基本連携 | リポジトリのクローン・コードベースインデックス | CursorとGitHubアカウント |
| MCP連携 | Issue/PR/ブランチをCursorから直接操作 | GitHub MCP Server + Personal Access Token |
| CI/CD連携 | GitHub ActionsからCursor CLIを呼び出す | Cursor CLIとGitHub Actions |
室谷代表取締役
テキトー教師.AI認定講師CursorでGitHubリポジトリを開く基本設定
室谷代表取締役これは2通りあって、ブラウザのGitHubからワンクリックでCursorに飛ぶ方法と、ターミナルでcloneしてから開く方法があります。
テキトー教師.AI認定講師github.comをcursor.comに書き換えるだけでCursorが起動してcloneまで自動でやってくれます。講座で紹介すると「え、そんな方法あるの!」って毎回なります(笑)
室谷代表取締役ただ、日常的に使うプロジェクトはやっぱりcloneしてローカルに置いておく方が安定してますね。
リポジトリのクローン方法
ターミナルでの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」でフォルダを開きます。
テキトー教師.AI認定講師コードベースインデックスを有効にする
室谷代表取締役
テキトー教師.AI認定講師コードベースインデックスの設定手順は以下の通りです。
- Cursorの設定画面を開く(
Cmd+,またはCtrl+,) - 「Features」→「Codebase indexing」に進む
- 「Enable codebase indexing」をオンにする
- 「Resync Index」ボタンでインデックスを再構築する
室谷代表取締役
テキトー教師.AI認定講師GitHubの外部ドキュメントをインデックスに追加する
室谷代表取締役
テキトー教師.AI認定講師「@Docs → Add new doc」でGitHubのREADMEやドキュメントサイトを登録できます。
GitHub MCP Serverで直接GitHub操作を可能にする
室谷代表取締役
テキトー教師.AI認定講師
室谷代表取締役
GitHub MCP Server のインストール(リモートサーバー方式)
テキトー教師.AI認定講師
室谷代表取締役設定は~/.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)に置き換えます。
テキトー教師.AI認定講師必要なスコープは操作したい内容によって変わります。
| 操作 | 必要なスコープ |
|---|---|
| リポジトリ読み取り | repo:read |
| Issue・PRの作成 | issues:write, pull_requests:write |
| コードの書き込み | repo:write |
| Actions操作 | actions:write |
室谷代表取締役Dockerを使ったローカルサーバー方式
テキトー教師.AI認定講師@modelcontextprotocol/server-github)を使ってる人は、必ず移行してください。{
"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"
}
}
}
}
室谷代表取締役動作確認と使い方
テキトー教師.AI認定講師
室谷代表取締役使えるようになる操作の代表例をまとめると、こうなります。
| 操作例 | チャットに送るメッセージ |
|---|---|
| リポジトリ一覧 | 「GitHubのリポジトリを一覧表示して」 |
| Issue一覧 | 「{repo}のオープンIssueを確認して」 |
| Issue作成 | 「このバグを{repo}にIssueとして作成して」 |
| PR一覧 | 「{repo}のオープンPRを一覧表示して」 |
| PR作成 | 「現在の変更でPRを作成して。タイトルは〇〇で」 |
| ブランチ作成 | 「feature/〇〇というブランチを作成して」 |
テキトー教師.AI認定講師
室谷代表取締役ブランチ・コミット・PRをCursorから操作する
室谷代表取締役
テキトー教師.AI認定講師AIによるコミットメッセージ生成
室谷代表取締役
テキトー教師.AI認定講師Cursorのソースコントロールでコミットメッセージを生成する手順は以下の通りです。
- ファイルをステージング(「+」ボタン)
- コミットメッセージ入力欄の「✦」(AI生成)ボタンをクリック
- 生成されたメッセージを確認して必要に応じて編集
- 「Commit」ボタンでコミット
室谷代表取締役PRの説明文をAIに書かせる
テキトー教師.AI認定講師
室谷代表取締役CursorのチャットでPR説明を生成する際のプロンプト例です。
現在のブランチの変更内容を確認して、以下の構成でPR説明文を書いてください:
- 変更の概要(1-2文)
- 変更理由
- 主な変更点(箇条書き)
- テスト方法
GitHub MCPを使って、origin/mainに対してPRを作成してください。
テキトー教師.AI認定講師ブランチ管理とフォーク
室谷代表取締役
テキトー教師.AI認定講師Gitのコマンドが苦手な人にとっては、これだけでも価値がある。
Cursor CLIをGitHub Actionsに組み込む
室谷代表取締役
テキトー教師.AI認定講師コミュニティのメンバーさんからも「会社でやりたいが設定方法がわからない」という質問が増えてます。
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"
室谷代表取締役
テキトー教師.AI認定講師cursor.com/docs/cli/github-actionsにドキュメントがありますが、複雑な設定はコミュニティフォーラムで事例を探した方が確実ですね。Cloud Agentとの連携
室谷代表取締役ローカルで指示した作業をクラウドで実行させて、完了を待つという使い方ができます。
テキトー教師.AI認定講師
室谷代表取締役1人で10個のIssueを並列処理できる世界ですよね・・・
GitHub CopilotとCursorの比較
テキトー教師.AI認定講師
室谷代表取締役| 項目 | Cursor | GitHub Copilot |
|---|---|---|
| 形態 | AIネイティブなスタンドアロンエディタ(VS Codeフォーク) | VS Code / JetBrains等のプラグイン |
| コンテキスト理解 | コードベース全体をインデックス | プロジェクト内のファイルを参照 |
| GitHub連携 | MCP経由でIssue/PR操作、CI/CD組み込み | Issue・PR・ブランチ操作を直接サポート |
| AIエージェント | Agent mode、Cloud Agent、Background Agent | CopilotがIssueを自律的に実装 |
| モデル | Claude、GPT-4系、Gemini等を選択可 | Claude、GPT-4系 |
| 料金 | Hobby(無料)〜Ultra($500/月) | Individual($10/月)〜Enterprise |
テキトー教師.AI認定講師
室谷代表取締役
テキトー教師.AI認定講師よくあるエラーと対処法
室谷代表取締役
テキトー教師.AI認定講師「GitHub MCP failing to start」エラー
室谷代表取締役対処手順はこちらです。
~/.cursor/mcp.jsonのJSON形式をバリデーターで確認- GitHubのPATが失効していないか確認(有効期限を設定している場合)
- PATのスコープに必要な権限が含まれているか確認
- Cursorを完全に再起動(タスクマネージャーからプロセスを終了)
テキトー教師.AI認定講師\(バックスラッシュ)を使うWindowsユーザーの方は、エスケープが必要です。\\にするか、/(スラッシュ)に統一することで解決することが多いですよ。npmパッケージを使っているのに動かない
テキトー教師.AI認定講師
室谷代表取締役@modelcontextprotocol/server-githubは2025年4月に廃止されています。~/.cursor/mcp.jsonに残っている場合は、前述のDockerかリモートサーバー方式に置き換えてください。Cursor CLIでPRレビューの認証エラー
テキトー教師.AI認定講師
室谷代表取締役インデックスが更新されない
テキトー教師.AI認定講師
室谷代表取締役よくある質問(FAQ)
テキトー教師.AI認定講師Q:GitHub Educationのアカウント(EDU)でCursorは無料で使えるの?
室谷代表取締役Cursor学生プランの記事で詳しく解説していますが、GitHub Educationのバッジがあれば申請できます。
Q:GitHub Copilotを使っているが、Cursorに移行する価値はある?
テキトー教師.AI認定講師ただ、コードベース全体を理解した上でのエージェント型の作業(リファクタリング・機能実装・テスト生成)をするなら、Cursorの方が現時点では体験が上です。
室谷代表取締役Q:プライベートリポジトリでもコードベースインデックスは使える?
テキトー教師.AI認定講師クローンしたプライベートリポジトリをローカルで開いていれば、そのコードがCursorのサーバーに送られる心配はありません。
室谷代表取締役CursorとGitHubを使う際のセキュリティ注意点
室谷代表取締役前年比34%増で、AI コーディングツールの普及がその一因として挙げられています。
テキトー教師.AI認定講師「AIが書いたコードをそのままコミットするとき、.envの内容が混入していないか確認しましたか?」って。
室谷代表取締役CursorとGitHubでのシークレット管理ベストプラクティス
テキトー教師.AI認定講師.envファイルは必ず.gitignoreに追加するgit diffでコミット前に変更内容を確認する習慣をつける- GitHub の「Secret scanning」機能を有効にする(パブリックリポジトリはデフォルトON)
- GitGuardianのようなシークレット検出ツールをCI/CDに組み込む
- Cursor Rulesに「シークレットをハードコードしない」「.envは読まない」と明記する
室谷代表取締役CLAUDE.mdや.cursor/rules/に「APIキーやシークレットは絶対にコードに直接書かない。必ず環境変数から読み込む」と書いておくと、AIがコードを書く際に従ってくれます。
テキトー教師.AI認定講師Personal Access Tokenの管理ですね。GitHub MCP Serverに使うPATは、Fine-grained tokenを使って必要なリポジトリ・スコープだけに絞ること。特に
GITHUB_TOKENや全リポジトリアクセスのClassic Tokenは使わないのがおすすめです。Cursorのコードプライバシー設定
室谷代表取締役
テキトー教師.AI認定講師機密性の高いコードを扱う場合はこちらが安心ですよ。
GitHubとCursorを使ったチーム開発のベストプラクティス
室谷代表取締役
テキトー教師.AI認定講師Cursor Rulesのチーム共有
室谷代表取締役.cursor/rules/ディレクトリを作って、チーム共通のルールをGitHubで管理することです。これをリポジトリにコミットすれば、チーム全員が同じCursorルールで作業できます。
テキトー教師.AI認定講師# 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つの機能変更に絞る
室谷代表取締役
テキトー教師.AI認定講師GitHub Issueドリブンの開発フロー
室谷代表取締役開発フローのステップはこんな感じです。
- GitHubでIssueを作成(詳細な要件・受け入れ条件を書く)
- CursorのチャットでGitHub MCPを使い、Issueを読み込む
- AIにIssueの内容を分析させて、実装方針を確認する
- feature/issue-{番号}のブランチを作成
- AIエージェントに実装させて、適宜レビューと修正
- コミット・プッシュし、GitHub MCP経由でPRを作成
- PRにIssueへの参照(「Closes #123」)を含める
テキトー教師.AI認定講師「AIに丸投げ」じゃなくて「AIと一緒に仕様を確認してから作業する」という感覚が大事ですよ。
室谷代表取締役GitHub ActionsとCursorを組み合わせたCI/CDのポイント
テキトー教師.AI認定講師- CURSOR_API_KEYをGitHub Secretsに登録する: ワークフローファイルに直接書かないこと
- タイムアウトを設定する: Cursor CLIのタスクは長時間かかる場合があるので、
timeout-minutesを設定する - コスト管理: Cursor CLIの実行にはトークンが消費されるため、すべてのPRで実行するのではなく、mainブランチへのマージリクエストに限定するなど条件を絞る
室谷代表取締役フィルターをかけて「大きなdiffがあるPRだけ実行」「draft PRは除外」などの設定が必要です。
Cursor 2.6とGitHub連携の最新アップデート
室谷代表取締役
テキトー教師.AI認定講師
室谷代表取締役
テキトー教師.AI認定講師.cursorrulesの書き方も変わってきています。エージェントが自律的に動くことを前提にした「境界設定」の書き方が重要で、「〇〇はしない」「〇〇が起きたら必ず確認する」という制約の書き方がベストプラクティスとして広まっています。
室谷代表取締役Cursor CLIの使い方とGitHub連携
テキトー教師.AI認定講師特にCLI経由でのGitHub連携は、スクリプトやCI/CDに組み込みやすくなっています。
室谷代表取締役cursor agent run "..." というコマンドでエージェントを起動できます。これをシェルスクリプトやMakefileに書いておくと、make review-prみたいな独自コマンドでCursorのAIレビューを呼べるようになりますね。CLI経由でGitHub MCPを使うと、スクリプト化が容易になります。
#!/bin/bash
# PR自動レビュースクリプト
PR_NUMBER=$1
cursor agent run \
"GitHub MCPを使ってPR #${PR_NUMBER}の変更内容を確認して、
コード品質・潜在的なバグ・改善点についてレビューコメントを書いてください。
レビューは日本語で書いてください。"
テキトー教師.AI認定講師./review-pr.sh 123と実行するだけでAIレビューが走る、という仕組みが作れます。
室谷代表取締役GitHubのドキュメントをCursorに読み込んでコーディング精度を上げる
テキトー教師.AI認定講師
室谷代表取締役@Docsへの追加手順は以下の通りです。
- CursorのチャットかComposerで
@Docsと入力する - 「Add new doc」を選択する
- GitHubのREADMEやドキュメントサイトのURLを入力する
- インデックスが完成するまで待つ(数分〜10分程度)
テキトー教師.AI認定講師@ドキュメント名と入力することで参照できます。「@supabase-docを参考に、usersテーブルのCRUD処理を書いて」という形で使えます。コミュニティのメンバーさんに教えると「こんな便利な機能があったのか!」という反応が多いです。
室谷代表取締役CursorとClaude Code、GitHubを使った実践的な開発体制
室谷代表取締役
テキトー教師.AI認定講師
室谷代表取締役
テキトー教師.AI認定講師
室谷代表取締役
テキトー教師.AI認定講師| 用途 | 推奨ツール | 理由 |
|---|---|---|
| UI・フロントエンドの実装 | Cursor(IDE内で確認しながら) | ビジュアルフィードバックが取りやすい |
| バックエンド・大規模リファクタリング | Claude Code(ターミナル) | メモリ効率が高い・並列処理しやすい |
| CI/CDとGitHub連携 | Cursor CLI | GitHub Actions連携のドキュメントが充実 |
| コードレビュー・PR作成 | GitHub MCP(いずれのツールからも) | GitHub MCPはCursorからもClaude Codeからも使える |
室谷代表取締役
テキトー教師.AI認定講師
室谷代表取締役
テキトー教師.AI認定講師
室谷代表取締役GitHub Forking・ブランチ戦略とCursorの組み合わせ
テキトー教師.AI認定講師
室谷代表取締役その後ローカルにcloneして作業する、という流れです。
テキトー教師.AI認定講師OSSコントリビューションの基本フロー(CursorとGitHub MCPを使った場合)です。
- GitHub MCPで対象リポジトリをfork
- forkしたリポジトリをローカルにclone(
git clone git@github.com:{自分のユーザー名}/{リポジトリ}.git) - Cursorでリポジトリを開き、コードベースをインデックス化
- AIにコントリビューションしたいIssueを読ませて、実装方針を確認
- feature branchを切って実装
- テスト・コミット・プッシュ
- GitHub MCPでPRをupstream(本家)に向けて作成
- PRの説明文をAIに生成させて、コントリビューションガイドラインに沿って修正
室谷代表取締役CONTRIBUTING.mdのURLを登録しておくと、AIがガイドラインを参照しながらPR説明を書いてくれます。
テキトー教師.AI認定講師cursor agent run "テストを実行してエラーがあれば修正して"という指示が一番楽ですね。GitHub Actionsとのブランチ連携(CI/CD設計)
室谷代表取締役
テキトー教師.AI認定講師
室谷代表取締役CIエラーをCursorで修正する典型的なフローです。
- GitHub ActionsでCIが失敗する
- CursorのチャットでGitHub MCPを使い、失敗したActionsのログを取得
- 「このCIエラーの原因を分析して、修正案を出して」と依頼
- 修正案を確認してコミット
- 再度CIを実行して通過を確認
テキトー教師.AI認定講師
室谷代表取締役これが本当の「10x productivity」ですよね。
テキトー教師.AI認定講師
室谷代表取締役CONTRIBUTING.mdや.github/ディレクトリの整備をCursorのAIに手伝わせることもできます。「GitHubのベストプラクティスに沿ったワークフローテンプレートを作って」という依頼ですね。まとめ
室谷代表取締役
テキトー教師.AI認定講師この2ステップだけで、日常の開発効率は確実に上がります。
室谷代表取締役
テキトー教師.AI認定講師出典
- GitHub MCP Server公式リポジトリ
- GitHub MCP Server Cursorインストールガイド
- Cursor公式ドキュメント(GitHub Actions)
- Cursor公式ドキュメント(Cloud Agent)
