🌴

Claude DesktopにGitHubのMCPサーバーを導入する方法

に公開
AI
GitHub
Model Context Protocol
Claude
MCP サーバー
tech

はじめに

Claude Desktop に GitHub MCP（Model Context Protocol）サーバーを設定することで、Claude から直接 GitHub のプライベートリポジトリにアクセスできるようになります。この機能により、コードの閲覧、編集、プルリクエスト作成まで、GitHub での開発作業を Claude から直接操作連携させることが可能になります。

https://github.com/github/github-mcp-server

必要なもの

  • Claude Desktop
  • GitHub アカウント

ステップ 1: GitHub でtokenを作成

1. GitHub の設定画面へ

  1. GitHub にログイン
  2. 右上のプロフィール画像からSettings を選択
  3. 左サイドバーの Developer settings を選択
  4. Personal access tokens → Tokens (classic) を選択

2. 新しいtokenを作成

  1. 右上のプルダウンのGenerate new token → Generate new token (classic) を選択
  2. Note に Claude Desktop と入力(適宜設定してください)
  3. Expiration は 90 days を選択(適宜設定してください)

3. 権限を選択

以下の4つにチェックを入れます：

✅ repo (Full control of private repositories)
✅ workflow (Update GitHub Action workflows)
✅ read:user (Read ALL user profile data)  
✅ user:email (Access user email addresses)

4. Generate token をクリック

5. 重要: 表示されたtokenをコピーして保存

ステップ 2: GitHub MCP サーバーをインストール

ターミナルで以下のコマンドを実行：

npm install -g @modelcontextprotocol/server-github

ステップ 3: Claude Desktop を設定

https://claude.ai/download

1. 設定ファイルを開く

macOS:

open ~/Library/Application\ Support/Claude/claude_desktop_config.json

Claudeディレクトリを探す

ls ~/Library/Application\ Support/Claude/

Claudeディレクトリの中にjsonファイルを作成する

touch ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. 設定ファイルを編集

ファイルが存在しない場合は新規作成して、以下を記述：

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ここにtokenを添付する"
      }
    }
  }
}

ステップ 4: Claude Desktop を再起動

  1. Claude Desktop を完全に終了
  2. 再度起動

動作確認

Claude Desktop で以下のメッセージを送信：

私のGitHubリポジトリを検索して

リポジトリの一覧が表示されれば成功です！

ISSUEの作成をお願いした例

カードのデザインを変更するISSUEを作って欲しい

簡単にISSUEが作成出来ました。
どのようなプロンプトで指示するかは検討する必要がありますね。

できること

repo 権限で可能になること

  • プライベートリポジトリの閲覧・編集
  • ファイルの作成・変更・削除
  • ブランチの作成・管理
  • プルリクエストの作成・レビュー
  • Issue の作成・管理
  • コミット履歴の確認

workflow 権限で可能になること

  • GitHub Actions ワークフローファイルの編集
  • CI/CD パイプラインの設定・管理
  • 自動テストやデプロイの設定
  • ワークフローの実行状況確認

read:user + user:email 権限で可能になること

  • Claude がGitHubのユーザーを正しく識別
  • コミット時の適切な作者情報設定
  • ユーザープロフィール情報の取得

リポジトリが見つからない場合

  • tokenの repo 権限を確認
  • Claude Desktop を完全に再起動

セキュリティ注意事項

  • tokenは絶対に他人と共有しない
  • 公開リポジトリにtokenをコミットしない
  • 設定したtokenの期限ごとにtokenを更新する

まとめ

AIの発展スピードが速すぎるので全然追いつけていないですが、新しい便利な機能を取り入れていくのは楽しいですね。
とりあえず色々と試して取り入れていきたいと日々模索中です。

Discussion