Claude Code特集2026年5月更新

GitHub MCP Server(github-mcp-server)使い方ガイド【2026年5月最新】|Claude CodeにGitHub直接アクセスを与える完全解説

公開日: 2026/04/24
更新日: 2026/05/26
GitHub MCP Server(github-mcp-server)使い方ガイド【2026年5月最新】|Claude CodeにGitHub直接アクセスを与える完全解説

この記事のポイント

GitHub公式MCPサーバー「github-mcp-server」の使い方を徹底解説。Claude CodeへのリモートHTTP接続・Docker設定・PAT設計・セキュリティ対策・toolset最適化まで、2026年5月最新(v1.0.5)情報を網羅。

github-mcp-server は GitHub が公式に提供する Model Context Protocol(MCP)サーバーで、Claude Code などのAIクライアントから Issue・Pull Request・リポジトリ・Actions・コードセキュリティを自然言語で直接操作できるようにするオープンソースツールです。 最新バージョンは v1.0.5(2026年5月18日リリース)。旧 npm パッケージ @modelcontextprotocol/server-github は2025年4月に廃止されているため、現行の正しい手順は github/github-mcp-server のリモートHTTPサーバーまたは Docker イメージを使う構成です。

この記事でわかること:

  • github-mcp-server が何者で、Claude Code とどう繋がるか
  • リモート / ローカル Docker の接続方式の違いと選び方
  • Claude Code・Claude Desktop それぞれの現行セットアップ手順(コマンド付き)
  • 17+ toolsets を最小構成から安全に広げる順序
  • Fine-grained PAT 設計・Read-only / Lockdown モード・プロンプトインジェクション対策
  • コンテキスト消費42,000〜55,000トークン問題と、4つの最適化方法

想定読者は、Claude Code(または Claude Desktop / Cursor)から GitHub を直接操作したい開発者・チームリード・DevOps 担当です。

github-mcp-server とは何か

GitHub公式 MCPサーバー github-mcp-server リポジトリのソーシャルプレビュー

出典: github/github-mcp-server 公式リポジトリ

github-mcp-server は、GitHub プラットフォームと AI クライアント(Claude Code、Claude Desktop、Cursor、VS Code Copilot など)を Model Context Protocol でつなぐ GitHub 公式の MCPサーバーです。リポジトリ github/github-mcp-server で MIT ライセンス公開されており、Go 製、Docker イメージは ghcr.io/github/github-mcp-server から配布されています。

もともと Anthropic が MCP の参考実装として開発し、MCPエコシステム内で最も人気のあるサーバーの一つに成長。2025年4月から GitHub が所有権を取得し、Anthropicと共同で Go に書き直して公式として継続開発しています。

Model Context Protocol(MCP)とは、AI アシスタントに外部ツール・データソースへのアクセスを標準化して与えるためのプロトコルです。github-mcp-server はその MCP 仕様に沿って、GitHub の REST / GraphQL API を AI から呼べる「ツール」として公開します。Claude Code に接続すると、「このリポジトリの最新 Issue をラベル別に整理して」「この PR の差分をレビューして問題点をコメント下書きで作って」といった自然言語指示が、そのまま GitHub 操作として実行できるようになります。

提供形態は大きく2系統です。

  • リモートMCPサーバー(GitHubホスト): https://api.githubcopilot.com/mcp/ にHTTPで接続する方式。インフラ管理・トークン自動更新・パッチ適用が不要。OAuth 2.1 + PKCE に対応。2025年9月4日に一般提供(GA)開始。
  • ローカルMCPサーバー: ghcr.io/github/github-mcp-server の Docker イメージ、またはビルド済みバイナリをローカルで起動する方式。Personal Access Token(PAT)を環境変数で渡して認証する。

⚠️ 古い情報に注意: 旧 npm パッケージ @modelcontextprotocol/server-github2025年4月に廃止(deprecated)されています。日本語ブログにはまだ npx @modelcontextprotocol/server-github を使う手順が残っていますが、現行の正解は github/github-mcp-server のリモートサーバーまたは Docker イメージです。

料金とプラン要件

github-mcp-server 自体は無料(OSS / MIT)で、リモートサーバーの利用も追加料金は発生しません。 ただし MCP 経由で呼び出される GitHub 側の機能には、それぞれのプラン要件がそのまま適用されます。

項目

料金・要件

github-mcp-server 本体(ローカル / リモート)

無料

リポジトリ閲覧・Issue / PR 操作

GitHub 無料アカウントで利用可

Code Scanning / Secret Scanning(プライベートリポ)

GitHub Advanced Security(GHAS)契約が必要

Copilot Coding Agent 連携

GitHub Copilot(Business / Enterprise 等)の契約

GitHub Enterprise Server / Enterprise Cloud

GITHUB_HOST 環境変数で接続先指定

組織統制(MCP servers in Copilot ポリシー)

Copilot Business / Enterprise の管理機能

つまり、「AI 経由で GitHub を触る」こと自体は無料で、有料機能を AI から呼ぶ場合だけ元のプランに従うという構造です。

接続方式(リモート vs ローカル)の選び方

Anthropic Model Context Protocol(MCP)公式発表ページのOGP画像

出典: Anthropic - Model Context Protocol

Claude Code から github-mcp-server に接続する方法は現時点で実質4つあります。最初にどれを選ぶかで運用負荷とセキュリティが変わるため、比較表で整理します。

経路

推奨環境

認証

主なメリット

主なデメリット

A. リモートHTTP(推奨)

Claude Code / 一般的な環境

PAT または OAuth 2.1+PKCE

セットアップ最短・自動アップデート・Docker不要

企業プロキシ配下は要確認

B. リモートHTTP(レガシー形式)

Claude Code 旧バージョン / Windows

PAT(Bearer)

旧バージョン互換・Windows で安定という報告

将来的に非推奨化の可能性

C. ローカル Docker

Claude Desktop・オフライン要件

PAT(環境変数)

閉域運用可能・クライアント差に強い

Docker 起動・PAT 管理が必要

D. ローカルバイナリ(go build)

Docker を避けたい環境

PAT(環境変数)

軽量・常駐プロセスが少ない

自前ビルド・手動アップデート

選び方の目安:

  • 迷ったら A(リモートHTTP)。 2025年9月のGA以降、最も運用が楽です。
  • Claude Desktop を使う場合は C(ローカル Docker)一択。 現時点(2026年5月)で Claude Desktop はリモート OAuth に未対応です。
  • Windows + Claude Code で A がうまく動かない場合は B。 Bearer ヘッダ周りの差で安定しないという報告があります。
  • D はオフライン環境・カスタムビルド要件がある場合のみ。 通常は A または C で十分です。

リモート vs ローカルの条件別まとめ:

条件

推奨方式

一般的な開発環境

リモート(A)

GitHub Enterprise Server(GHES)

ローカルDocker(C)必須

セキュリティポリシーで外部接続制限

ローカルDocker(C)

オフライン環境

ローカルDocker(C)

チーム開発で設定を共有したい

リモート(A)+ .mcp.json

Dockerなし環境

リモート(A)または バイナリ(D)

できること:toolset 一覧

github-mcp-server は 17+ 種類の「toolset」として約51個のツール(個別関数) を提供します(2025年6月時点・随時追加中)。--toolsets フラグまたは GITHUB_TOOLSETS 環境変数で有効化する範囲を選びます。

デフォルトで有効化されるのは contextreposissuespull_requestsusers の5つで、まずはここから始めるのが公式推奨です。

toolset

デフォルト

主な用途

context

ユーザー・GitHubの前提コンテキスト取得(強く推奨)

repos

リポジトリ閲覧・ファイル取得・コード検索・コミット解析

issues

Issue の作成・更新・コメント・ラベリング

pull_requests

PRの作成・レビュー・マージ・差分取得

users

ユーザー検索・プロファイル

actions

ワークフロー実行確認・ログ取得・再実行

code_security

Code Scanning アラート(GHAS連携)

secret_protection

Secret Scanning アラート

dependabot

Dependabot アラート・更新管理

discussions

GitHub Discussions 閲覧・投稿

gists

Gist 作成・管理

labels

ラベル作成・付与

notifications

通知取得・既読化

orgs

Organization 情報参照

projects

GitHub Projects(カンバン)操作

security_advisories

Security Advisory 参照

stargazers

スター履歴

copilot (リモートのみ)

専用

Copilot Coding Agent 等の関連機能

copilot_spaces (リモートのみ)

専用

Copilot Spaces 連携

最小から始めるなら context,repos,issues,pull_requests の4つ。日常的なコードレビュー・Issue 整理・PR 作成の大半をカバーできます。セキュリティ監査を AI に任せたくなったら code_securitysecret_protectiondependabot を追加する流れが実務的です。

toolset を絞ることにはコンテキスト節約とハルシネーション抑制の副次効果があります。MCP ツール数が多いほど AI が毎ターン読み込むツール定義が膨れ、関係ないツールを誤選択する確率も上がります。全部有効化(all)は検証用にとどめ、本番では必要分だけ有効化しましょう。

Claude Code への導入手順

Anthropic Claude Code 公式サイトのOGP画像

出典: Claude Code 公式サイト

前提:

  • Claude Code CLI がインストール済み(claude --version で確認)
  • GitHub Personal Access Token(Fine-grained PAT 推奨)
  • ローカル経路を選ぶ場合は Docker Desktop など

経路A:リモートHTTP(推奨)

claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'

スコープは --scope フラグで選べます。

  • local(デフォルト):現在のプロジェクトのみ
  • project.mcp.json 経由でチーム共有
  • user:ログインユーザーの全プロジェクト

チーム共有用途では --scope project.mcp.json にコミットし、PAT 自体は ${GITHUB_PAT} のような環境変数参照にしておくのが安全です。

経路B:リモートHTTP(レガシー形式)

Claude Code 旧バージョン、または Windows で A がうまく動かない場合:

claude mcp add --transport http github https://api.githubcopilot.com/mcp \
  -H "Authorization: Bearer YOUR_GITHUB_PAT"

経路C:ローカル Docker

claude mcp add github -e GITHUB_PERSONAL_ACCESS_TOKEN=YOUR_GITHUB_PAT \
  -- docker run -i --rm -e GITHUB_PERSONAL_ACCESS_TOKEN ghcr.io/github/github-mcp-server

経路D:ビルド済みバイナリ

claude mcp add-json github '{"command":"github-mcp-server","args":["stdio"],"env":{"GITHUB_PERSONAL_ACCESS_TOKEN":"YOUR_GITHUB_PAT"}}'

動作確認

# 登録されたMCPサーバーの一覧
claude mcp list

# github の設定詳細
claude mcp get github

Claude Code セッション内では /mcp コマンドで接続状態を確認できます。「Connected」と表示され、ツール一覧に list_issuescreate_pull_request などが並んでいれば成功です。

最初に試すプロンプト例

このリポジトリ(owner/repo)の直近1週間のOpen Issueをラベル別にまとめてください。
各Issueに対して、重要度(High / Medium / Low)の私見もつけてください。
main ブランチに対するOpen PRのうち、変更行数が500行を超えるものを一覧化し、
分割可能か判断してください。可能なら分割案を提示してください。

Claude Desktop への導入

Claude Desktop は2026年5月時点でリモートMCP(OAuth)未対応のため、ローカル Docker 構成を使います。公式インストールガイドにも明記されています。

設定ファイルの場所:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
{
  "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"
      }
    }
  }
}

編集後は Claude Desktop を再起動し、プロンプト入力欄のツールアイコンに GitHub 関連ツールが表示されれば完了です。

GitHub Personal Access Token の安全な設計

セキュリティロックとアクセス管理のイメージ

github-mcp-server のセキュリティは、PAT(Personal Access Token)のスコープ設計でほぼ決まります。 ここを雑に設定すると、プロンプトインジェクション攻撃で一気に情報が漏れる構造になります。

Fine-grained PAT を必ず使う

GitHub には Classic PAT と Fine-grained PAT がありますが、MCP 用途では Fine-grained PAT 一択です。理由は「リポジトリ単位」と「操作単位」の両方で権限を絞れるからです。

権限

推奨設定

Repository access

必要なリポジトリのみ選択(All repositories は避ける)

Contents

Read and write

Pull requests

Read and write

Issues

Read and write

Metadata

Read-only(必須)

Actions

必要なら Read-only、書き込みは慎重に

Administration

絶対に付けない

Administration スコープを付けると、AI が誤作動した瞬間にリポジトリを削除できる状態になります。公開リポ・業務リポ問わず、MCP 用 PAT に付与してはいけません。

また、2026年1月から OAuthスコープフィルタリング機能が追加され、PAT の権限外のツールは自動的に非表示になります。クラシックPAT(ghp_ プレフィックス)を使う場合は自動スコープ検出が機能します。

有効期限とローテーション

  • 有効期限は 90日以内を推奨。無期限トークンは作らない。
  • .env 等に保管し、必ず .gitignore に追加してリポジトリへのコミットを物理的に防ぐ。
  • 期限切れを契機にローテーションする運用にしておくと、万一流出しても被害が限定される。

公開用と業務用で PAT を分ける

プロンプトインジェクション対策で最も効果が高いのが、「公開OSSを触る用のPAT」と「業務リポを触る用のPAT」を物理的に分けることです。1つのPATで両方にアクセスできる状態は、攻撃が成立したときに業務情報が流出する経路になります。

セキュリティ設定オプション:Read-only / Lockdown / Dynamic Tool Discovery

github-mcp-server には、運用段階に応じて挙動を絞るフラグが用意されています。

設定

方法

効果

読み取り専用

--read-only / GITHUB_READ_ONLY=1

書き込み系ツールを完全に無効化

ロックダウンモード

--lockdown-mode / GITHUB_LOCKDOWN_MODE=1

未信頼コントリビューターのコンテンツを除外

ツールセット制限

--toolsets / GITHUB_TOOLSETS

不要なツールグループを無効化

特定ツール除外

--exclude-tools / GITHUB_EXCLUDE_TOOLS

指定ツールを強制除外

Read-only モード

--read-only    # または環境変数 GITHUB_READ_ONLY=1

書き込み系ツールを完全に無効化する厳格フィルタで、他の設定より優先されます。

適しているケース:

  • 本番環境の監査用途
  • コードレビューだけを AI に任せる
  • 初導入の試運転(業務リポに対して最初の数週間はこれで回すのが無難)

GitHub Blog の実践ガイドでも「本番テストとコードレビューに最適」と明示されています。

Lockdown モード

--lockdown-mode    # または環境変数 GITHUB_LOCKDOWN_MODE=1

公開リポジトリから取得するコンテンツを、push 権限を持つ作者の投稿に限定する機能です。外部の誰でも投稿できる Issue や PR コメントに仕込まれたプロンプトインジェクションを、AI が読み込む経路自体を狭めます。プライベートリポジトリには影響しません。

2025年12月のアップデートで導入された機能で、プロンプトインジェクション対策として公式が推奨しています。

Dynamic Tool Discovery(ベータ / ローカル限定)

--dynamic-toolsets    # または GITHUB_DYNAMIC_TOOLSETS=1

この設定を有効にすると、enable_toolsetlist_available_toolsetsget_toolset_tools の3メタツールが利用可能になり、AI が必要になったタイミングで動的に toolset をロードします。常時全ツールを読み込むよりコンテキスト消費が減り、ハルシネーションも抑えやすくなります。

2026年5月時点ではベータ表記かつローカル限定で、リモートサーバーでは使えません。採用する場合は公式 README で最新状況を確認してください。

プロンプトインジェクションの現実的リスクと対策

プロンプトインジェクション攻撃とセキュリティ対策のイメージ

github-mcp-server はプロンプトインジェクション攻撃の実例が報告されている領域で、セットアップ後に必ず意識する必要があります。

2025年5月、セキュリティ企業 Invariant Labs が公式 GitHub MCP を標的にした実証攻撃「トキシック・エージェント・フロー」を公表しました。攻撃の流れはこうです。

  1. 攻撃者が公開リポジトリの Issue に、AI 向けの悪意ある指示(プロンプトインジェクション)を仕込む
  2. 開発者が AI に「Open Issue を一覧で見せて」と依頼
  3. AI が悪意ある Issue を読み込み、仕込まれた指示に従って動作
  4. 同じ PAT の広い権限でプライベートリポにアクセス → 機密情報を公開リポに PR で流出させる

攻撃の核心は「AI が読み込むコンテンツ自体に指示が埋め込まれている」という点です。これは github-mcp-server 特有ではなく、LLM + 外部データ取得全般のリスクです。

現在の公式対策(2025年12月〜)として、ユニコードフィルタリング・HTMLサニタイズ・マークダウンコードフェンスフィルタリングが実装されています。対策の優先順位は次の通り。

  1. PAT を Fine-grained でリポジトリ単位に絞る(公開リポ用と業務リポ用で物理分離)
  2. Read-only モードで書き込み範囲を明確に区切る(書き込みは人間が最終承認)
  3. Lockdown モードを有効化(公開リポの第三者コメントを読み込み対象から除外)
  4. Docker MCP Gateway などのインターセプタ層で「1セッション=1リポジトリ」原則を強制する選択肢もあり

この設計を最初に決めておくと、「便利だから toolset を広げたい」となったときも、被害面積を小さく保てます。

トークンコスト最適化:コンテキスト消費を抑える4つの方法

コンテキストウィンドウ最適化とコンピューティングパフォーマンスのイメージ

全 toolset を有効化すると、ツール定義だけで約42,000〜55,000トークンをコンテキストウィンドウに消費します。 Claude の200Kコンテキストでも約21〜28%を toolset 定義に使う計算で、実際のコード・Issue 処理に使えるコンテキストが圧迫されます。また、ツール数が多いほど AI が無関係なツールを誤選択するリスクも上がります。

競合記事ではほとんど触れられていない重要なポイントなので、詳しく整理します。

方法1:必要なツールセットのみ指定(最高効率)

# IssueとPRのみ使う場合
docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN \
  -e GITHUB_TOOLSETS=context,issues,pull_requests \
  ghcr.io/github/github-mcp-server

# セキュリティ監査用途
docker run -i --rm \
  -e GITHUB_PERSONAL_ACCESS_TOKEN \
  -e GITHUB_TOOLSETS=context,repos,code_security,dependabot,secret_protection \
  ghcr.io/github/github-mcp-server

方法2:特定ツールのホワイトリスト化

GITHUB_TOOLS 環境変数または X-MCP-Tools ヘッダーで、toolset レベルではなく個別ツールレベルで有効化範囲を指定できます。2025年12月のアップデートで追加された機能で、コンテキスト消費を60〜90%削減できます。

方法3:Read-only モードで書き込みツール定義を省略

-e GITHUB_READ_ONLY=1

書き込み系ツールの定義自体がコンテキストに乗らなくなるため、コンテキスト節約と安全性向上を同時に達成できます。

方法4:Dynamic Tool Discovery(ローカル限定・ベータ)

-e GITHUB_DYNAMIC_TOOLSETS=1

AI が必要になったタイミングで toolset を動的にロードするため、初期コンテキスト消費を最小化できます。ベータ機能のため、本番環境への導入は公式の安定化を待ってからが無難です。

2026年1月のアップデートでは、projects ツール群の統合により約23,000トークン(50%)の削減も達成されており、バージョンアップによる自然な改善も進んでいます。

用途別おすすめ設定例

用途に応じた最小設定例を整理します。不要な toolset を最初から外すことで、コンテキスト消費を抑えながら精度よく動作します。

用途

おすすめ toolsets

補足

Issue管理・トリアージ

context,issues,labels

最小構成。ラベル付けまで含む

PRレビュー補助

context,repos,pull_requests

diff取得・コメント下書きに最適

コード探索・質問回答

context,repos

クローンなしでファイル検索・読み込み

CI/CD監視・ログ解析

context,repos,actions

Actions ログ取得・失敗原因解析

セキュリティ監査

context,code_security,dependabot,secret_protection

GHAS連携が必要

GitHub Projects管理

context,issues,projects

カンバン操作・アイテム移動

フルスタック開発補助

context,repos,issues,pull_requests,actions

日常的な開発ワークフロー全般

最新アップデート履歴(2026年5月時点)

v1.0.5(2026年5月18日)

  • list_issuesget_file_contentssearch_issues 等に IFC ラベル追加
  • get_reviews にページネーション追加
  • update_issue_type にオプションの rationale パラメータ追加
  • コード検索結果にテキストスニペット追加
  • リポジトリコラボレーター一覧ツール新規追加

v1.0.4(2026年5月11日)

  • Dependabot エラーメッセージ改善
  • Xcode インストールドキュメント追加
  • get_me ツールに IFC ラベル追加
  • get_tag の軽量タグ処理改善

2026年1月28日(大型アップデート)

  • プロジェクトツール統合:トークン使用量を約23,000トークン(50%)削減
    • projects_listprojects_getprojects_write に統合
  • OAuthスコープフィルタリング:PAT の権限外ツールを自動非表示
  • インサイダーモード:実験的機能への明示オプトイン機構
  • エンタープライズ向け HTTPサーバーモード:Authorization ヘッダー経由のOAuthトークン対応

2025年12月10日

  • ツール固有設定機能(X-MCP-Tools ヘッダー):コンテキストウィンドウ使用量60〜90%削減
  • 公式 MCP Go SDK への完全移行
  • プロンプトインジェクション対策(デフォルト有効)
  • ロックダウンモード導入

2025年10月14日

  • GitHub Projects 対応ツール追加
  • デフォルトツールセットを最頻使用5グループに最適化

2025年9月4日

  • リモート MCP サーバーが一般提供(GA)開始

トラブルシューティング

現場で遭遇しやすい問題を整理します。

症状

主な原因と対処

/mcp で github が Connected にならない

PAT の誤り、Fine-grained PAT のリポジトリ未指定、Bearer 前後のスペース

list_issues などが権限エラー

PAT のスコープ不足、または該当リポへのアクセス未付与

Windows でリモートHTTPが不安定

経路B(--transport http)に切り替える

Claude Desktop でリモート接続できない

仕様(OAuth未対応)。Docker 経路C へ切り替え

ツールが多すぎて AI が混乱する

GITHUB_TOOLSETS で最小構成に絞る、または Dynamic Tool Discovery を有効化

GHES / Enterprise Cloud に接続したい

GITHUB_HOST 環境変数でエンドポイントを指定

copilot toolset の一部が動かない

remote-only の機能あり。ローカル経路では使えないことを確認

旧 npm パッケージの手順で失敗する

廃止済み。公式の github/github-mcp-server に移行する

個人・チーム・Enterprise 別のおすすめ構成

開発チームがノートPCでコラボレーションしている様子

運用規模で最適解は変わります。

個人開発者

  • 経路 A(リモートHTTP)
  • Fine-grained PAT(公開リポ用と業務リポ用を分ける)
  • 最初は context,repos,issues,pull_requests + Read-only モードで試運転
  • 慣れたら Read-only を外し、書き込みツールに拡張

小〜中規模チーム

  • 経路 A または C(Claude Desktop 利用者がいるかで決める)
  • .mcp.json--scope project でコミット、PAT は環境変数参照
  • Lockdown モードをデフォルト有効化
  • toolset はリポジトリ単位で運用方針を決める(セキュリティ監査用チームだけ code_security を有効化等)

Enterprise

  • 経路 A(OAuth 2.1 + PKCE)を基本
  • 「MCP servers in Copilot」ポリシーで組織レベルの許可制を導入
  • PAT の長期運用をやめ、短命トークンに統一
  • Docker MCP Gateway 等のインターセプタ層で監査ログを取得
  • GHES 環境なら GITHUB_HOST を Terraform / 構成管理で配布

こんな人におすすめ

  • Claude Code から Issue / PR / リポジトリを直接操作したい開発者
  • コードレビュー・Issue トリアージを AI に任せて時間を短縮したい人
  • CI/CD ログ解析や Dependabot アラートの横断確認を自動化したい人
  • チームのコードセキュリティ運用(Code Scanning / Secret Scanning)を AI で補助したい DevOps 担当
  • GitHub Enterprise 環境を AI から扱いたい情シス・プラットフォームチーム

おすすめしない人・慎重に検討すべき人

  • PAT の権限設計やプロンプトインジェクションのリスクを把握せずに即業務導入したい人
  • Administration 相当の広い権限を AI に渡すことに抵抗がない人(逆にいうと、抵抗があるべき)
  • 「AI が勝手にマージ・削除しても確認しない」運用前提の人
  • 社内ポリシーで外部APIへの PAT 持ち出しが禁止されており、かつ Enterprise 契約のない環境

上記に該当する場合は、まず Read-only モード + 非機密リポでの試運転から始め、運用ルールと PAT 設計を整えてから本格導入するのが安全です。

FAQ

Q1. 旧 @modelcontextprotocol/server-github の設定は消してもいい?
A. はい。2025年4月に廃止されています。既存の設定は公式 github/github-mcp-server(リモートまたはDocker)に置き換えてください。

Q2. PAT を OAuth に切り替えたい
A. リモートサーバーは OAuth 2.1 + PKCE に対応しています。ただし Claude Desktop は2026年5月時点で OAuth 未対応のため、引き続き Docker + PAT 構成が必要です。Claude Code ではリモートHTTPで OAuth が利用できます。

Q3. toolset を全部有効化したらどうなる?
A. ツール定義で42,000〜55,000トークンを消費し、AI が無関係ツールを誤選択するリスクも増えます。推奨は最小構成から段階的に広げる方式です。

Q4. GitHub Enterprise Server(オンプレ)でも使える?
A. GITHUB_HOST 環境変数で接続先を指定すれば GHES / Enterprise Cloud(ghe.com)で動作します。ただし GHES ではリモートサーバー(api.githubcopilot.com)は使えず、ローカル Docker が必須です。

Q5. プロンプトインジェクションが怖い。導入すべきではない?
A. リスクはゼロではありませんが、Fine-grained PAT + Read-only + Lockdown モード + 公開/業務でPAT分離で現実的に抑え込めます。同じリスクは GitHub 以外の MCP サーバーやブラウザオペレーター型AIにも共通するため、運用設計で対応するのが実務的です。

Q6. 料金は本当にかからない?
A. github-mcp-server 本体とリモートサーバーの利用は無料です。ただし Code Scanning(プライベートリポ)や Copilot Coding Agent など、元の GitHub 機能側で有料プランが必要なものは通常通り課金対象です。

Q7. Cursor や VS Code Copilot でも使える?
A. 使えます。MCP 対応クライアント全般で動作しますが、設定ファイル形式やリモート対応状況はクライアントごとに異なるため、各クライアントの公式ドキュメントを参照してください。VS Code 1.101以上ならコマンドパレットから「GitHub MCP: Install Remote Server」でワンクリックインストールが可能です。

Q8. GITHUB_READ_ONLY=1GITHUB_TOOLSETS はどちらが優先される?
A. GITHUB_READ_ONLY=1(または --read-only)が優先されます。toolsets でどんなに書き込み系ツールを指定しても、Read-only モードでは書き込みツールの定義自体が無効化されます。

まとめ

github-mcp-server は、Claude Code と GitHub を最小の工数で直結させる公式MCPサーバーで、2025年9月のリモートGA・2026年5月の v1.0.5 到達で運用が安定した段階に入っています。導入そのものは claude mcp add-json 一行で完了しますが、勝負は PAT 設計と toolset 選定です。

  • 現行手順は github/github-mcp-server(旧 npm パッケージではない)
  • 迷ったら リモートHTTP(経路A)+ Fine-grained PAT
  • 最初は Read-only + 最小toolset で試運転
  • Administration スコープは絶対に付けない
  • 公開リポ用と業務リポ用で PAT を物理分離
  • コンテキスト消費が気になる場合は GITHUB_TOOLSETS で用途別に絞る

この6点を守れば、プロンプトインジェクションのような既知リスクをコントロールしながら、Issue・PR・コードレビュー・Actions 運用を AI で一気に効率化できます。

最新情報は公式リポジトリ(github/github-mcp-server)と GitHub Changelog を月1回程度チェックし、v1.0.x 以降のマイナーアップデートに追従するのが運用の基本線です。

関連記事

この記事の著者

AI革命

AI革命

編集部

AI革命株式会社の編集部です。最新のAI技術動向から実践的な導入事例まで、企業のデジタル変革に役立つ情報をお届けしています。豊富な経験と専門知識を活かし、読者の皆様にとって価値のあるコンテンツを制作しています。

AI活用ならAI革命にお任せ。サービスを見てみる
AI Revolution Growth Arrow

AIでビジネスを革新しませんか?

あなたのビジネスにAIがどのような価値をもたらすかをご提案いたします。