GitHub MCP とは、Claude Code から GitHub の PR や Issue を道具として扱えるようにする、GitHub 公式の MCP サーバーです。

知りたい事答え
Claude Code にどう入れるか端末で claude mcp add-json か claude mcp add を撃つ。リモート・Docker・手元のバイナリの 3 通り（入れ方の節）
繋がったかの見方Claude Code の中で /mcp、端末で claude mcp list・claude mcp get github（確かめ方の節）
統合（merge）が済んだかの見方統合の列（merge queue）のリポでは、コマンドの出力の 1 行では分からない。当社で確かめられたのは GraphQL の isInMergeQueue・mergeQueueEntry だけ（当社の記録の節）

出典: GitHub MCP Server 公式 https://github.com/github/github-mcp-server・Claude Code 公式文書 https://code.claude.com/docs/en/mcp（どちらも 2026-10-20 に開いて確かめた）、社の実測 2026-09-19

GitHub MCP を Claude Code に入れる 3 つの道

GitHub 公式の Claude 向け手引き（install-claude.md・2026-10-20 に開いて確かめた）には、GitHub MCP を Claude Code に入れて GitHub と連携させる道が 3 つ載っています。どれも Claude Code の中ではなく、端末で撃ちます。

道前に要る物撃つコマンド
リモートのサーバー（GitHub が置いている口）GitHub の個人用アクセストークン（PAT）claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'
手元の Docker で動かす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
手元のバイナリで動かす（Docker なし）配布されているバイナリを落として PATH に置くclaude mcp add-json github '{"command": "github-mcp-server", "args": ["stdio"], "env": {"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT"}}'

出典: GitHub MCP Server 公式 https://github.com/github/github-mcp-server/blob/main/docs/installation-guides/install-claude.md（2026-10-20 に開いて確かめた）。同じ手引きでは、リモートの add-json の形は Claude Code 2.1.1 以降向けで、2.1.0 以前は claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer YOUR_GITHUB_PAT" の古い形を使う、とされています。

Claude Code 側の公式文書（code.claude.com/docs/en/mcp・2026-10-20 に開いて確かめた）にも、GitHub のリモートのサーバーを claude mcp add --transport http github https://api.githubcopilot.com/mcp/ --header "Authorization: Bearer YOUR_GITHUB_PAT" で足す例が載っています。トークンは GitHub のトークンの設定で、使わせたいリポだけに絞った fine-grained のトークンを作る、とあります。

手元の Docker で動かす道では、トークンを先に用意せず、最初に使う時にブラウザでログインする形（OAuth）も選べます。OAuth で入る形は、公式 README（https://github.com/github/github-mcp-server・2026-10-20 に開いて確かめた）の該当の節を見てください。

どの範囲で使えるようにするかは --scope で選び、local（既定）・project・user があります。範囲の考え方は Claude Code の MCP の足し方 にまとめています。

繋がったかを確かめる

Claude Code の公式文書では、claude mcp add はトークンが正しいかを確かめずに設定を保存する、とされています。仮の値のままでも足せてしまい、後で繋がらずに気づく形です。繋がったかは Claude Code の中で /mcp を撃ち、github の行に印が付いているかで見ます（出典: code.claude.com/docs/en/mcp・2026-10-20 確認）。

GitHub 側の手引きでは、Claude Code を立ち上げ直してから端末で claude mcp list を撃って github が在るかを見て、claude mcp get github で中身を見ます。繋がらない時は、トークンに repo の権限が在るか・期限が切れていないかを確かめる、とあります（出典: install-claude.md・2026-10-20 確認）。

道具を絞る: toolsets と読むだけの形

GitHub MCP は、道具を束（toolsets）ごとに出し入れできます。何も指定しない時に出る束は context・repos・issues・pull_requests・users です。束は --toolsets か、環境変数 GITHUB_TOOLSETS で選びます（両方在れば環境変数が優先）。既定の束に足したい時は default,stargazers のように書きます（出典: github.com/github/github-mcp-server・2026-10-20 確認）。

書き込みを一切させたくない時は --read-only（Docker なら GITHUB_READ_ONLY=1）を付けると、読むだけの道具しか出なくなります。--tools で書き込みの道具を名指ししても出ません（同じ出典・2026-10-20 確認）。まず読むだけで入れて、PR の要約や Issue の検索から任せる、という始め方ができます。

当社の記録: 統合の列（merge queue）のリポで、成功を何で確かめたか

当社の席（仕事を任せた AI）は、GitHub の操作（PR を作る・統合の列に入れる）に gh コマンドを使っています。main に統合の列（merge queue）を入れたリポで、PR を列に入れる時に詰まった所が 3 つありました（社の実測 2026-09-19）。GitHub MCP でも gh でも、「統合が済んだか・列に入ったか」をどこで確かめるかは同じ問いになるので、記録をそのまま載せます。

撃った物出た物読み違えやすい所
gh pr merge --squash! The merge strategy for main is set by the merge queue の 1 行列に入れた時も入れなかった時も同じ 1 行が出る。成功の証拠にならない
gh pr merge --delete-branchCannot use -d or --delete-branch when merge queue enabled断られて何も統合されない。出力を | tail に流していたため終了の番号が 0 に見えた
gh pr view --json mergeQueueEntryその欄自体が無い列に入ったかをこれでは見られない

出典: 社の実測 2026-09-19

出力の 1 行は「成功」と読まない

gh pr merge --squash が出す ! The merge strategy for main is set by the merge queue は、列に入った知らせに見えます。ですが当社の記録では、列に入れた時も入れなかった時も、同じ 1 行が出ました（社の実測 2026-09-19）。この 1 行を見て次の仕事に進むと、統合されていない PR を「済み」と数えることになります。

断られたのに、終了の番号が 0 に見えた

同じリポで gh pr merge --delete-branch を撃つと、Cannot use -d or --delete-branch when merge queue enabled で断られ、1 行も統合されませんでした。この時、出力を | tail に流していたため、終了の番号が 0 に見え、席は成功と読み違えかけました（社の実測 2026-09-19）。AI に GitHub を操作させる時は、出力を管に流して短くする前に、そのコマンド自体が通ったかを見る形にしておきます。

列に入ったかは GraphQL で見る

当社で、PR が列に入ったかを確かめられたのは、GitHub の GraphQL の isInMergeQueue と mergeQueueEntry だけでした。gh pr view --json mergeQueueEntry は、その欄自体が無く使えませんでした（社の実測 2026-09-19）。

なお、GitHub MCP の公式の README（github.com/github/github-mcp-server・2026-10-20 に開いて確かめた）には、PR を統合する道具 merge_pull_request は載っていますが、merge queue に触れた記述は見当たりませんでした。統合の列を入れたリポで AI に統合させるなら、どの道具を使うにせよ、列に入ったかを別の所で確かめる手を用意しておくと安心です。

.github/workflows/ を変える PR には workflow の権限が要る

当社では、.github/workflows/ を変える PR を列に入れるのに、workflow の権限が要りました。席は、ブラウザで端末の承認（device code を入れる → Authorize を押す → メールに届いた確認コードを入れる）を代わりに通して権限を足し、人の手は 0 で済みました（社の実測 2026-10-05）。

GitHub MCP の公式の README でも、ファイルを書く道具 create_or_update_file・delete_file・push_files は、求める権限に repo と並んで workflow が挙がっています（出典: github.com/github/github-mcp-server・2026-10-20 確認）。workflow の中身を AI に直させる予定があるなら、トークンを作る時点でこの権限も足りているかを見ておきます。

こうした「道具を繋ぐ」「済んだかを確かめる」を組み合わせて、仕事を丸ごと任せる AIエージェント にしていくのがブルーランプの考え方です。GitHub 以外にどんな MCP が配られているかは MCP の一覧 にまとめています。

よくある質問

GitHub MCP を Claude Code に入れるコマンドは何ですか？

リモートのサーバーなら、端末で claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}' を撃ちます。Claude Code 2.1.0 以前は claude mcp add --transport http の形を使います（GitHub 公式の手引き・2026-10-20 確認）。

トークン（PAT）なしで GitHub MCP は使えますか？

手元の Docker で動かす形なら、github.com では最初に使う時にブラウザでログインする形（OAuth）を選べます。リモートのサーバーを使う手順では、公式の手引きは PAT を前に要る物として挙げています（GitHub 公式の手引き・2026-10-20 確認）。

GitHub MCP が Claude Code に出てきません。

claude mcp add はトークンを確かめずに保存するので、仮の値のままだと後で繋がりません。Claude Code の中で /mcp を撃って github の行に印が在るかを見て、無ければトークンの repo の権限と期限を確かめます（Claude Code 公式文書・GitHub 公式の手引き・2026-10-20 確認）。

AI に PR を統合させた時、済んだかはどう確かめますか？

統合の列（merge queue）を入れたリポでは、gh pr merge の出力の 1 行は、列に入れた時も入れなかった時も同じに出たので、証拠になりませんでした。当社で確かめられたのは GitHub の GraphQL の isInMergeQueue・mergeQueueEntry だけです（社の実測 2026-09-19）。

出典