GitHub MCPサーバーは、AIエージェントにGitHubの操作を「ツール」として渡すための、GitHub公式のMCPサーバーです。つなぐと、Claude CodeやVS CodeのCopilot、Cursorなどから、自然言語の指示でファイルの参照、Issueの起票、プルリクエストの作成やレビュー依頼、GitHub Actionsのログ確認ができるようになります。この記事では、2026年10月21日に公開されたv2.0.3を手元で起動して数えたツール数をもとに、22のtoolsetでできること、ローカル版とリモート版の選び方、Claude Code・VS Codeへの登録手順、読み取り専用やロックダウンで権限を絞る設定、料金と組織での利用条件をまとめます。
まとめ:GitHub MCPサーバーの要点
- 正体:GitHubが開発するGo製・MITライセンスのオープンソース
github/github-mcp-server。2025年に開発が止まった旧参照実装@modelcontextprotocol/server-githubとは別物です。GitLabの公式MCPサーバーについてはGitLab MCPサーバーの接続設定:Claude Code・Cursorでの使い方とツール一覧で解説しています。 - できること:v2.0.3のtoolsetは22。既定で有効なのは context・copilot・issues・pull_requests・repos・users の6つで、実測では46ツール(うち読み取り27)。全部有効にすると91ツールになります。
- 使い方は2通り:GitHubがホストするリモート版(
https://api.githubcopilot.com/mcp/)と、Dockerやバイナリで動かすローカル版。迷ったらリモート版、GitHub Enterprise Serverならローカル版です。 - 認証:ローカル版も初回のブラウザログイン(OAuth)が標準になり、PATの発行は必須ではなくなりました。CIなど対話できない環境はPATかGitHub Appを使います。
- 権限:使うtoolsetだけを有効にし、読むだけの用途は
--read-onlyにします。公開リポジトリのIssueを読ませる場合は、プロンプトインジェクション対策としてロックダウンモードも併用します。 - 料金:サーバー自体は無料でプランを問いません。Copilot経由で使う場合のモデル利用料と、Copilot Business・Enterpriseの組織ポリシーは別に確認が必要です。
GitHub MCPサーバーの仕組みと公式サーバーの実体
MCP(Model Context Protocol)は、AIアプリと外部のツールやデータをつなぐための共通仕様です。仕様の全体像はMCP(Model Context Protocol)とは?AIと外部ツールをつなぐ標準規格の仕組みをわかりやすく解説で扱っています。GitHub MCPサーバーはその「サーバー側」で、issue_read や create_pull_request といったGitHub APIの操作をツール定義として公開します。AIは指示を受けると、どのツールをどの引数で呼ぶかを決め、サーバーがGitHub APIを実行して結果を返します。
公式リポジトリ github/github-mcp-server と旧参照実装の違い
公式サーバーはgithub/github-mcp-serverで、2025年3月にリポジトリが作られ、2026年10月21日時点でスターは3万3千を超えています。2026年10月6日にv2.0.0、同21日にv2.0.3が出ています(リリース一覧)。
検索すると、npmの @modelcontextprotocol/server-github を npx で起動する古い手順も見つかります。これはMCPの参照実装集に入っていたサーバーで、現在は「もう保守されていない参照サーバー」としてmodelcontextprotocol/servers-archivedに移されています。npmのパッケージも最終版2025.4.8で非推奨(deprecated)の表示です。新しく導入するなら公式の github-mcp-server を使ってください。
GitHub MCP Registry(github.com/mcp)との違い
「github mcp」で検索すると出てくる github.com/mcp は、GitHub MCPサーバーそのものではなく、さまざまな会社のMCPサーバーを探すための一覧(GitHub MCP Registry)です。2025年9月16日のGitHub Changelogで公開されました。GitHub MCPサーバーもこの一覧に載っていますが、FigmaやPostmanなど他社のサーバーと並ぶ1項目です。
GitHub MCPサーバーでできること:22のtoolsetとツール数
ツールはtoolset(機能のまとまり)ごとに有効・無効を切り替えます。2026年10月21日、v2.0.3のDarwin_x86_64版リリースバイナリ(コミットb98d115)をstdioで起動し、MCPプロトコルバージョン2025-06-18で接続して、toolsetを1つずつ指定して tools/list の件数を数えました(GitHub CLIのトークンで認証。読み取りはツールの readOnlyHint 注釈で判定)。
| toolset | 対象 | ツール数(読み取り) | 代表的なツール |
|---|---|---|---|
| repos ★ | リポジトリ・ファイル | 19(13) | get_file_contents, push_files, search_code |
| issues ★ | Issue | 10(6) | issue_read, issue_write, search_issues |
| pull_requests ★ | プルリクエスト | 10(3) | pull_request_read, create_pull_request, merge_pull_request |
| context ★ | ログイン中のユーザー・チーム | 4(4) | get_me, get_teams |
| copilot ★ | Copilotへの依頼 | 2(0) | assign_copilot_to_issue, request_copilot_review |
| users ★ | ユーザー検索 | 1(1) | search_users |
| actions | GitHub Actions | 4(3) | actions_list, actions_run_trigger, get_job_logs |
| notifications | 通知 | 6(2) | list_notifications, dismiss_notification |
| discussions | Discussions | 5(4) | list_discussions, get_discussion |
| gists | Gist | 4(2) | create_gist, list_gists |
| governance | ルールセット・カスタムプロパティ | 4(2) | repository_ruleset_read |
| security_advisories | セキュリティアドバイザリ | 4(4) | list_global_security_advisories |
| labels | ラベル | 3(2) | list_label, label_write |
| projects | GitHub Projects | 3(2) | projects_list, projects_write |
| stargazers | スター | 3(1) | star_repository |
| code_security | Code scanning | 2(2) | list_code_scanning_alerts |
| secret_protection | Secret scanning | 2(2) | list_secret_scanning_alerts |
| dependabot | Dependabot | 2(2) | list_dependabot_alerts |
| code_quality | Code Quality | 1(1) | get_code_quality_finding |
| git | Git API(ツリー取得) | 1(1) | get_repository_tree |
| orgs | Organization検索 | 1(1) | search_orgs |
| copilot_issue_intents | 意図付きのCopilot割り当て | 1(0) | assign_copilot_to_issue_with_intent |
★が既定で有効なtoolsetです。--toolsets all にすると91ツール(読み取り57)になりました(get_label が issues と labels の両方に属するため、表の合計92より1つ少なくなります)。数はトークンの権限やライセンスで変わります。リモート版にはこのほか、Copilot Spacesとサポート文書検索のtoolsetがあります。
既定で有効になる6つのtoolsetと46ツール
何も指定しないと、context・copilot・issues・pull_requests・repos・users が有効になり、46ツール(読み取り27、書き込み19)が並びました。READMEの既定の一覧は5つで copilot を含みませんが、v2.0.3の stdio --help と実際の起動結果では copilot も既定に入っています。書き込み19個には merge_pull_request、delete_file、push_files、create_repository が含まれるので、既定のまま渡すと「ファイルを消す」「PRをマージする」までAIに任せる構成になります。
2025年の解説には --dynamic-toolsets(必要に応じてtoolsetを有効化する機能)が出てきますが、v1.1.0(2026年5月28日)で削除され、v2.0.3のフラグ一覧にもありません。ツール数を抑えたいときは、後述のtoolset指定で絞ります。
GitHub Actionsの操作(actions toolset)
Actionsは既定では無効なので、--toolsets default,actions のように足します。ツールは4つにまとめられていて、actions_list でワークフローや実行の一覧、actions_get で個々の実行の詳細、get_job_logs でジョブのログを取り、actions_run_trigger でワークフローの実行や再実行、取り消しを行います。書き込みは actions_run_trigger だけなので、失敗したジョブのログを読ませて原因を調べる用途なら、読み取り専用モードと組み合わせても使えます。
ローカル版とリモート版の選び方
同じサーバーを、GitHubのクラウドで動くリモート版と、自分のマシンで動かすローカル版のどちらでも使えます。
| 観点 | ローカル版 | リモート版 |
|---|---|---|
| 動く場所 | 自分のマシン(Docker・バイナリ) | GitHubのクラウド |
| 登録するもの | 起動コマンド | URLだけ |
| 認証 | OAuthログイン・PAT・GitHub App | OAuth(対応ホスト)・PAT |
| 更新 | イメージ・バイナリを自分で更新 | GitHubが反映 |
| GitHub Enterprise Server | 使える | 使えない |
| ツールの絞り方 | フラグ・環境変数 | URLのパス・ヘッダ |
リモート版は2025年9月4日に一般提供(GA)になりました。Dockerを入れられない環境や、まず試したい場合はリモート版が手早く、GitHub Enterprise Serverを使う会社や、ツールの説明文を差し替えたい場合はローカル版です。リモート版のURLの書き方、ヘッダでの絞り込み、クライアントごとのOAuthとPATの違いはGitHub Remote MCP Serverとは?ローカル版との違い・接続手順・OAuth/PAT認証を解説【2026年10月】で実測値つきで解説しています。この記事では以下、ローカル版の導入を中心に説明します。
なお、GitHub上でIssueを任せるCopilot cloud agent(旧coding agent)には、GitHub MCPサーバーが最初から組み込まれていて、既定で有効です。GitHub Docsによると、このサーバーは作業中のリポジトリだけを読み取れるトークンで接続します。cloud agentで使う分には、自分で登録する必要はありません。
ローカル版GitHub MCPサーバーの起動と認証設定
ローカル版は公開イメージ ghcr.io/github/github-mcp-server か、リリースページのバイナリで動かします。2026年6月以降の公式手順では、トークンを用意せずに起動し、初回にブラウザでGitHubへログインする方法が標準です。
Docker版のOAuth認証とコールバックポート設定
公式のイメージとバイナリにはGitHubが登録したOAuthアプリの情報が入っているため、github.comならクライアントIDも不要です。取得したトークンはメモリ上だけに置かれ、ディスクには書かれません(Local Server OAuth Login)。Dockerの場合は、ログイン後のコールバックを受けるポート8085を固定して公開します。
docker run -i --rm \
-p 127.0.0.1:8085:8085 \
-e GITHUB_OAUTH_CALLBACK_PORT=8085 \
ghcr.io/github/github-mcp-server
ポートは必ず 127.0.0.1: を付けてループバックだけに公開します。-p 8085:8085 にすると、認可コードを受け取る口が同じネットワークの他の端末にも開きます。8085番が他のプロセスに使われていると、サーバーはエラーで止まります(別ユーザーのプロセスにリダイレクトを渡さないための仕様です)。ブラウザもポートも使えないSSH先やコンテナでは、短いコードを別端末で入力するデバイスコード方式に切り替わります。
CI・非対話環境向けのPAT認証設定
環境変数 GITHUB_PERSONAL_ACCESS_TOKEN を渡すと、OAuthより優先してPATで認証します。ブラウザでの承認を挟めない自動化や、トークンの権限を固定したい場合に使います。次のコマンドは、実行元のシェルで GITHUB_PERSONAL_ACCESS_TOKEN を設定・エクスポート済みであることを前提とします。
docker run -i --rm \
-e GITHUB_PERSONAL_ACCESS_TOKEN \
-e GITHUB_TOOLSETS="repos,issues,pull_requests,actions" \
-e GITHUB_READ_ONLY=1 \
ghcr.io/github/github-mcp-server
Dockerを使わない場合は、バイナリを置いて github-mcp-server stdio で起動します。フラグは --toolsets、--read-only のように同じ名前です。PATはclassicよりも、対象リポジトリと権限を選べるfine-grained PATが向いています。GitHub CLIでログイン済みなら、検証用に gh auth token の値を渡すこともできます(GitHub CLIの導入はghコマンド(GitHub CLI)とは?インストール方法と使い方・コマンド一覧【v2.102対応】を参照)。
GitHub Enterprise Server・ghe.comの接続先と認証設定
接続先は --gh-host か環境変数 GITHUB_HOST で指定します。GitHub Enterprise Serverは https:// から書き、データレジデンシー付きのGitHub Enterprise Cloudは https://<サブドメイン>.ghe.com です。v2.0.3はHTTPSでないホストを拒否します(例外はローカル開発用のループバックホストで、http://localhost、http://127.0.0.1、http://[::1] など)。github.com以外では組み込みのOAuthアプリが使えないため、PATを渡すか、自社で登録したOAuthアプリかGitHub Appのクライアントを --oauth-client-id で指定します。
Claude Code・VS CodeへのGitHub MCPサーバー登録設定
上の起動コマンドを、クライアントの設定ファイルに書くかCLIで登録します。クライアント別の公式手順は、Claude向けインストールガイドなど docs/installation-guides にあります。
Claude CodeへのCLI登録と設定の保存先
Claude Codeの中ではなく、ターミナルで実行します。ローカル版(Docker)をOAuthログインで登録する場合は次のとおりです。
claude mcp add github -e GITHUB_OAUTH_CALLBACK_PORT=8085 -- \
docker run -i --rm -p 127.0.0.1:8085:8085 \
-e GITHUB_OAUTH_CALLBACK_PORT ghcr.io/github/github-mcp-server
claude mcp list
PATで登録する場合は、Claude Code側と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
この形式はトークンの値が設定に保存されるので、--scope project で .mcp.json に書く場合はリポジトリにコミットしないようにしてください。リモート版をClaude Codeに登録する場合はPATをヘッダで渡します(手順はリモート版の解説にあります)。
VS Codeのmcp.json設定とCopilotエージェントモードでの接続
VS Codeでは、ワークスペースの .vscode/mcp.json に書くか、READMEのインストールボタンから追加します。ローカル版をOAuthログインで使う設定は次のとおりです。
{
"servers": {
"github": {
"command": "docker",
"args": ["run", "-i", "--rm",
"-p", "127.0.0.1:8085:8085",
"-e", "GITHUB_OAUTH_CALLBACK_PORT",
"ghcr.io/github/github-mcp-server"],
"env": { "GITHUB_OAUTH_CALLBACK_PORT": "8085" }
}
}
}
保存したらCopilot Chatをエージェントモードに切り替えると、サーバーが起動してツールが選べるようになります。コンテナはブラウザを開けないため、ログイン用のURLはVS Codeの確認ダイアログ(MCPのURL elicitation)で表示されます。エージェントモードの承認設定やモードの違いはGitHub Copilotエージェントモードの使い方|Ask・Plan・Agentの違いと承認設定・料金で扱っています。
Claude Desktopは、設定画面の「カスタムコネクタ」からリモート版を追加する方法が公式ガイドで非対応とされているため、claude_desktop_config.json にローカル版(Docker)を書くのが公式の手順です。CursorやCodex向けのインストールガイドでは、リモート版にPATをヘッダで渡す設定が案内されています。ただし、CursorのOAuth対応はGitHubのGA発表にも記載されており、利用バージョンで対応状況を確認してください。
権限を絞る設定とプロンプトインジェクション対策
GitHub MCPサーバーに渡したトークンで読める・書けるものは、AIも読めて書けます。設定で減らせるのは「AIに見せるツール」と「トークンの権限」の2つで、両方を絞ります。
toolset・ツール単位の公開範囲設定
READMEは、使うtoolsetだけを有効にするとモデルのツール選択が楽になり、コンテキストも減ると説明しています。指定方法は3つです。
# toolsetを指定(既定に足すなら default,actions のように書く)
github-mcp-server stdio --toolsets repos,issues,pull_requests
# ツール単位で追加(toolset指定と足し算になる)
github-mcp-server stdio --toolsets repos,issues --tools get_gist
# 特定のツールだけ外す
github-mcp-server stdio --exclude-tools merge_pull_request,delete_file,push_files
環境変数 GITHUB_TOOLSETS と GITHUB_TOOLS も使え、フラグと両方あると環境変数が優先されます。書き間違えたときの挙動はtoolsetとツールで違い、実測では存在しないtoolset名(--toolsets nosuch)はエラーにならずツール0個で起動しました。一方、存在しないツール名を --tools に書くと unknown tools specified in WithTools で起動自体が失敗します。
読み取り専用モードとPATのスコープ
--read-only(Dockerでは GITHUB_READ_ONLY=1)を付けると、既定の46ツールが27ツールになり、書き込み系の19ツールが一覧から消えました。--tools で書き込みツールを明示しても、読み取り専用が優先されます。
ただし、これはAIに見せるツールを減らす設定で、トークン自体の権限は変わりません。PATは対象リポジトリを限定したfine-grained PATで作り、読むだけなら書き込み権限を付けないようにします。必要なスコープは github-mcp-server list-scopes --toolsets=repos,issues --output=summary で確認でき、既定のtoolsetを読み取り専用にした場合は repo と read:org の2つでした。なお、この出力はOAuthスコープの一覧で、fine-grained PATの権限項目とは異なります。repo は書き込みも許可するため、トークン自体を読み取り専用にする場合は、fine-grained PATで対象リポジトリと必要な読み取り権限を個別に指定します。
公開リポジトリのIssue経由の乗っ取りとロックダウンモード
2025年5月26日、Invariant Labsは公開リポジトリのIssueに仕込んだ指示で、GitHub MCPサーバーを使うエージェントに非公開リポジトリの情報を漏らさせる攻撃を公表しました。ユーザーが「公開リポジトリのIssueを見て」と頼むだけで、エージェントがIssue内の指示に従い、非公開リポジトリの内容を公開側のPRに書き出します。Invariant Labsは、これはサーバーのコードの欠陥ではなく、エージェントの構成の問題だとしています。同じ型の攻撃の別の例はAgentjackingとは?偽のSentryエラーでAIコーディングエージェントを乗っ取る攻撃と防御設定で解説しています。
対策として、現在のサーバーにはロックダウンモード(--lockdown-mode、Dockerでは GITHUB_LOCKDOWN_MODE=1)があります。公開リポジトリで、そのリポジトリへのpush権限を持たない人が書いたIssueやコメント、PRの内容を、ツールの応答から外すかエラーにします。github-actions[bot] と copilot の書いた内容は例外として常に通します。READMEは「ベストエフォートの内容フィルタで、権限の境界ではない」と明記しているので、次の対策と重ねます。
- 公開リポジトリを読ませるセッションには、非公開リポジトリを読み取れるトークンを渡さない
- 1つのセッションで扱うリポジトリを1つにする(Invariant Labsが挙げた緩和策)
- クライアントのツール実行の承認を「常に許可」にしない
複数のMCPサーバーをまとめて権限や秘密情報を管理したい場合は、Docker MCP Gatewayとは|docker mcp gateway runでMCPサーバーを安全に集約する使い方【2026年版】のようにゲートウェイを挟む方法もあります。
料金と組織での利用条件
GitHub MCPサーバーは無料で、GitHubのプランを問わず使えます。GitHub Docsのセットアップ手順は、全ユーザーが利用できるとしたうえで、有料のGitHub機能やCopilot機能に対応するツールは、その機能と同じライセンスが必要だと書いています。たとえば request_copilot_review でCopilotにレビューを頼むには、Copilotのコードレビューを使えるプランが要ります。
サーバー自体の利用料とは別に、AIクライアントの利用料や、呼び出したGitHub機能に応じた費用が発生します。たとえばCopilotコードレビューでは、GitHub AIクレジットに加えてGitHub Actionsの実行時間も課金対象になり得ます。Copilotのエージェントモードから使えばCopilotの利用枠(2026年6月からAIクレジット制)を、Claude CodeやCursorから使えばそれぞれの料金を消費します。ツールの定義と応答もモデルへの入力になるので、toolsetを絞ることは費用の面でも効きます。
会社で使う場合、Copilot BusinessまたはCopilot Enterpriseの組織に属するメンバーは、組織かエンタープライズで「MCP servers in Copilot」ポリシーが有効でないと、Copilot経由でMCPサーバーを使えません。GitHub Docsは、このポリシーを既定で無効と説明しています。Claude CodeやCursorなどCopilot以外のクライアントはこのポリシーでは止まらないため、OAuth Appのアクセス制限やPATのポリシーで管理します。社内のリポジトリやチケットとエージェントをつなぐ権限設計から相談したい場合は、AIエージェント開発の支援内容も参考にしてください。
GitHub MCPサーバーの使い方の例
登録が済んだら、エージェントに自然言語で頼みます。AIが選ぶツールと、そのとき必要なtoolsetは次のとおりです。
| 頼み方の例 | 使われるツール | 必要なtoolset |
|---|---|---|
| このPRの差分を読んで問題点を挙げて | pull_request_read | pull_requests |
| このPRのレビューをCopilotに依頼して | request_copilot_review | copilot |
| 未対応のバグIssueを優先度順に整理して | search_issues, issue_read | issues |
| 昨日失敗したCIの原因を調べて | actions_list, get_job_logs | actions |
| このリポジトリのDependabotアラートを要約して | list_dependabot_alerts | dependabot |
BacklogなどのMCPサーバーと並べると、Issueとチケットをまたいだ整理も頼めます。ツール数の多いサーバーの絞り方はBacklog MCPサーバーの導入手順と権限設計|63ツールの絞り込みと削除系の封じ方【2026年版】で扱っています。
つながらない・ツールが出ないときの確認
- ツールが1つも出ない:toolset名のつづりの誤り(存在しない名前は黙って無視される)。
- サーバーが起動しない:
--toolsに存在しないツール名がある。READMEの一覧と照合します。 - イメージのpullが失敗する:イメージは公開されています。READMEは、期限切れの認証情報が残っている場合に
docker logout ghcr.ioを案内しています。 - OAuthのログインで止まる:8085番ポートが使用中か、
-p 127.0.0.1:8085:8085の公開を忘れている。 - 特定のツールだけ出ない:classic PATのスコープ不足。サーバーはスコープの足りないツールを一覧から隠します。
- Copilotでだけ使えない:組織の「MCP servers in Copilot」ポリシーが無効になっていないか確認します。有効なら、Copilot側の認証状態とMCPサーバーのログも確認します。
よくある質問
GitHub MCPとは何ですか?
GitHubが公開しているMCPサーバー(github/github-mcp-server)のことです。AIエージェントにリポジトリ、Issue、プルリクエスト、GitHub Actionsなどの操作をツールとして渡します。MCPという仕様をGitHubが作ったわけではなく、GitHubはMCPに対応したサーバーを提供している立場です。
GitHub MCPの料金はいくらですか?
サーバー自体は無料で、GitHubのプランを問わず使えます。費用がかかるのは、Copilot・Claude Code・Cursorなど、ツールを呼び出すAI側の利用料です。Copilotのコードレビューの依頼など、有料機能に対応するツールにはその機能のライセンスが必要です。
GitHub Copilotがなくても使えますか?
使えます。Claude Code、Cursor、Codexなどの対応クライアントから利用できますが、接続方式と認証方式はクライアントごとに異なります。Claude Desktopは、GitHubの公式ガイドではローカル版での接続が案内されています。リモート版のURLが api.githubcopilot.com なのはホストしている基盤の名前で、Copilotの契約は前提ではありません。
GitHub MCPサーバーは読み取り専用にできますか?
できます。ローカル版は --read-only か GITHUB_READ_ONLY=1、リモート版はURLの末尾に readonly を付けるか X-MCP-Readonly: true ヘッダを送ります。v2.0.3のローカル版では、既定の46ツールが27ツールになりました。
旧来の @modelcontextprotocol/server-github はまだ使えますか?
npmに残っていますが、非推奨で保守されていません。参照実装はアーカイブ用のリポジトリに移され、ツールの追加やセキュリティ対応は公式の github-mcp-server でしか行われません。新しく導入するなら公式サーバーを使ってください。
関連記事
- GitHub Remote MCP Serverとは?ローカル版との違い・接続手順・OAuth/PAT認証を解説【2026年10月】
- MCP(Model Context Protocol)とは?AIと外部ツールをつなぐ標準規格の仕組みをわかりやすく解説
- GitHub Copilotエージェントモードの使い方|Ask・Plan・Agentの違いと承認設定・料金
- Agentjackingとは?偽のSentryエラーでAIコーディングエージェントを乗っ取る攻撃と防御設定
- Docker MCP Gatewayとは|docker mcp gateway runでMCPサーバーを安全に集約する使い方【2026年版】