GitHub MCP と Claude Code を接続する: ステップバイステップガイド (2026年)

Claude Code における GitHub MCP とは（何ができるのか）？

GitHub MCP サーバーは、Claude Code が自然言語で直接 GitHub を読み取り、操作できるようにする橋渡し役です - ターミナルを離れることも、手動でのコピー＆ペーストも不要です。MCP（Model Context Protocol）は、AI を外部ツールに接続するオープンな標準規格です。この概念が初めての方は、まず MCP とは何か、どのように動作するのか からお読みください。

接続が完了すると、リポジトリや open な issue の一覧表示、新しい issue の作成、pull request の作成、PR 内のコードレビュー、説明文からのコード検索、リポジトリ内のファイルの読み取りといった操作を Claude に依頼できます。ブラウザを開いて GitHub を操作する代わりに、1 文入力するだけで Claude が代わりに GitHub API を呼び出します。これが、個別の gh コマンドを実行するのとは異なる点です。Claude はセッション全体の文脈を理解し、適切なツールを自分で選びます。

実際の例を挙げます。バグを修正しているときに 「このタイムアウトエラーに関連する issue を見つけて、コメントを要約して」 と伝えると、Claude が GitHub に問い合わせ、issue を読み取り、ターミナル上でそのまま回答します - ウィンドウを切り替える必要はありません。修正後は、続けて 「現在のブランチから PR を作成して、その issue を参照して」 と依頼できます。この一連の操作がすべて 1 つの会話の中で行われ、作業中のコードの文脈が保たれます。だからこそ、多くの開発者は GitHub MCP を毎回オン・オフするのではなく、デフォルトのツールとして組み込んでいるのです。

始める前に（チェックリスト）

サーバーを追加する前に、以下の点をざっと確認しておきましょう:

• Claude Code がインストールされていて、ターミナルで動作すること - まだの場合は Claude Code のインストール方法 をご覧ください。
• Claude に作業させたいリポジトリにアクセスできる GitHub アカウント。
• 接続方法を選ぶ: リモート HTTP（おすすめ - 高速で、インストール不要）または Docker（サーバーを自分のマシン上でローカルに動かしたい場合）。ほとんどの方にはリモート HTTP で十分です。
• Docker を選ぶ場合は、Docker Desktop をインストールし、サーバーを追加する前に起動しておいてください。

リモート HTTP の方法なら、このガイド全体でおよそ 5〜10 分で完了します。

2026 年の最速の方法: 公式プラグインマーケットプレイスからインストールする

2026 年現在、Claude Code には公式のプラグインマーケットプレイスが標準で組み込まれています。GitHub MCP を最も速く動かすには、セッション内で次を入力します:

/plugin install github@claude-plugins-official

claude-plugins-official マーケットプレイスは、Claude Code を対話モードで初めて起動したときに自動登録されます - もし見つからない場合は、/plugin marketplace add anthropics/claude-plugins-official で手動追加してください。このプラグインには事前設定済みの GitHub MCP サーバーが含まれており、下記のステップ 2 の -s フラグに対応するスコープ（User／Project／Local）も引き続き選べます。接続できたかどうかは /mcp または /plugin list --enabled で確認してください。

⚠️ 未確認: プラグイン経由でのインストールでも PAT の貼り付けを求められるのか、それとも OAuth／デバイスフローのサインインが自動的に始まるのかは、公式ドキュメントに明記されていません。直接検証でき次第、このセクションを更新します。

トレードオフ: 速い一方で、下記の 4 ステップの手動の方法に比べてスコープ・権限の制御は粗くなります - チームや本番環境での利用では、必要な権限を正確に選べる手動の方法のほうが依然として安全な既定の選択です。

GitHub 以外のプラグインや MCP サーバーも見てみたいですか？ 2026 年におすすめの Claude Code プラグイン & MCP （記事の公開時にリンクが有効になります） をご覧ください。

ステップ 1 - GitHub の Personal Access Token (PAT) を作成する

GitHub MCP は、あなたに代わって API を呼び出すためにトークンを必要とします。GitHub には 2 種類のトークンがあります: classic（スコープベースの広い権限）と fine-grained（リポジトリ単位の権限）です。必要なリポジトリと権限だけに正確に限定でき、万一トークンが漏洩した場合の被害を最小限に抑えられるため、fine-grained トークンを使いましょう:

1. GitHub にアクセスし、アバター -> Settings を開きます。
2. 左メニューの一番下までスクロールし、Developer settings を選びます。
3. Personal access tokens -> Fine-grained tokens -> Generate new token を選びます。
4. 名前（例: claude-code-mcp）を付け、適切な有効期限（30〜90 日）を設定します。
5. Repository access では Only select repositories を選び、Claude に触れさせたいリポジトリだけにチェックを入れます。
6. Permissions -> Repository permissions では、必要最小限だけを付与します: Contents（ファイルの読み書き）、Issues、Pull requests。組織で作業する場合は read:org を追加します。
7. Generate token をクリックし、すぐにトークンをコピーします。

セキュリティ上の注意: GitHub はトークンを一度しか表示しません。コピーして、安全な場所（パスワードマネージャー）に保管してください。トークンをリポジトリにコミットしないでください。また、git 管理下のファイルに貼り付けないでください。Claude に自分でコンテンツを作成・編集させたいときだけ、書き込み権限を付与しましょう。

ステップ 2 - GitHub MCP サーバーを追加する（おすすめ: リモート HTTP）

これが最速の方法で、Docker も不要です。ターミナルを開き、YOUR_PAT を先ほど作成したトークンに置き換えて、次を実行します:

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

JSON 形式の設定のほうが好みなら（コピーしてすぐ使える形にしておきたいときに便利です）、次の代替方法を使います:

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

-s フラグで設定スコープを選びます:

• -s local（デフォルト）: このマシンの、現在のディレクトリにのみ適用されます。
• -s user: すべてのプロジェクトで共有されます - GitHub MCP を常に使えるようにしつつ、トークンをどのリポジトリにも含めたくない場合に便利です。
• -s project: .mcp.json に保存され、git 経由でチーム全体と共有されます。チームには便利ですが、注意してください: 本物のトークンをこのファイルに入れては絶対にいけません。

たとえば、すべてのプロジェクトで共有するには、上記の claude mcp add コマンドの末尾に -s user を追加します。claude mcp add の完全な構文は Claude Code MCP の公式ドキュメント（2026 年更新）にあります。

OAuth について: 2026 年 8 月時点では、Claude Code のリモート GitHub MCP で OAuth フローはまだ完全にはサポートされていないため、上記のように PAT を使うのが最も確実な方法です。

ステップ 3（代替）- Docker で GitHub MCP を実行する（ローカル）

サーバーを完全に自分のマシン上で動かしたい場合（たとえば完全に制御したい、あるいは隔離された環境で動かしたい場合）は、公式イメージ ghcr.io/github/github-mcp-server を使います。Docker Desktop が起動していることを確認してから、次を実行します:

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

リモート HTTP ではなく Docker を選ぶべきなのはどんなときでしょうか。簡単に比較してみましょう:

非推奨の npm パッケージは使わないこと

これは最もよくある間違いです。 古いガイドの多くは（どの言語でも）今なお npm で @modelcontextprotocol/server-github をインストールするよう案内しています。そのコミュニティパッケージは 2025 年 4 月に非推奨となっており - その通りに進めると、接続できないサーバーになったり、分かりにくいエラーが出たりします。2026 年の正しい方法は、リモート HTTP、または github/github-mcp-server リポジトリ（GitHub 公式のソース、2026 年更新）の公式 Docker イメージです。

ステップ 4 - 確認して試してみる

サーバーを追加したら、「Connected」と表示されることを確認します:

claude mcp list

github が接続済みステータスで表示されるはずです。次に、Claude Code を開いて次を入力します:

/mcp

/mcp コマンドは、いま利用できる GitHub のツールをすべて一覧表示します。では、実際のプロンプトをいくつか試してみましょう:

• 「私の GitHub リポジトリを一覧表示して。」
• 「owner/repo に『Improve the setup docs』というタイトルで issue を作成して。」
• 「このリポジトリの open な pull request を要約して。」

Claude が正しいデータを返し、issue を作成できれば、接続は完了です。

よくあるエラーのトラブルシューティング

GitHub MCP の接続トラブルのほとんどは、3 つの原因に集約されます: トークンの誤りや権限不足、古いインストール方法を誤って使っている、あるいはサーバー追加後に Claude Code を再起動していない、のいずれかです。うまくいかない場合は、下の表で症状を照らし合わせてください:

一般的なコツ: 迷ったら、claude mcp remove github を実行して最初から追加し直しましょう - たいていの設定の問題はこれで解消します。

セキュリティと最小権限（read-only、toolset）

エージェントに GitHub への書き込み権限を与えるのは便利ですが、現実的なリスクもあります: 曖昧なプロンプトによって、意図しない issue や PR を Claude が作成してしまうことがありますし、権限が広すぎるトークンが漏洩すれば、多くのリポジトリに影響が及びます。安全を保つためのルールをいくつか挙げます:

• 最小限のトークンを付与する: 必要なリポジトリだけ、使う権限だけを選びます。
• トークンをコミットしない: トークンをどのリポジトリにも残さないよう -s user を推奨します。どうしても -s project を使う場合は、平文で書き込まず、環境変数経由でトークンを渡します。
• 読み取りだけでよいときは read-only を使う: GitHub MCP サーバーは read-only モードに対応しており、個々の toolset を有効・無効にできます - 内容の確認や調べ物だけがしたいときは、Claude が書き込みではなく読み取りしかできないように制限しましょう。
• トークンの有効期限を短く設定し、使い終わったら無効化します。

正直に言えば: AI に書き込み権限を渡した時点で、完璧に安全な設定は存在しません - トークンのスコープはきつく絞り、重要な操作は必ず再確認してください。

次のステップ: Claude Code で git ワークフローを自動化する

GitHub MCP が動くようになったら、次に自然と進むのは、変更のライフサイクル全体を Claude に任せることです: ブランチを作成し、規約に沿ってコミットし、PR を作成し、レビューする。それを扱ったのが Claude Code で git ワークフローを自動化する （記事の公開時にリンクが有効になります） です。

よくある質問（FAQ）

GitHub MCP は無料ですか？

GitHub MCP サーバー自体（リモート HTTP と公式 Docker イメージのどちらも）は無料です。必要なのは GitHub アカウントと Personal Access Token だけです。操作は、通常どおりアカウントの GitHub API レート制限にカウントされます。

Docker は必須ですか？

いいえ。おすすめの方法はリモート HTTP です - claude mcp add --transport http コマンドを 1 つ実行するだけで、Docker は不要です。Docker が必要なのは、サーバーを自分のマシン上でローカルに動かしたい場合だけです。

PAT にはどのスコープが必要ですか？

fine-grained トークンでは、使いたい特定のリポジトリに対して、少なくとも Contents、Issues、Pull requests を付与します。組織内で作業する場合は read:org を追加します。必要以上の権限は付与しないでください。

GitHub MCP サーバーを削除するには？

claude mcp remove github を実行します。別のスコープで追加していた場合は、削除時にそのスコープ（例: -s user）を再度指定してください。

gh CLI と何が違うのですか？

gh は、コマンドを自分で 1 つずつ入力するコマンドラインツールです。GitHub MCP は、会話の文脈に基づいて Claude に GitHub API を呼び出させます - 自然言語でリクエストすると、Claude がツールを選んで実行し、同じセッション内で他のステップと連鎖させることもできます。

OAuth はもう使えますか？

2026 年 8 月時点では、Claude Code のリモート GitHub MCP で OAuth はまだ完全にはサポートされていないため、接続には PAT が引き続き確実でおすすめの方法です。

まとめ

わずか 4 ステップ - PAT を作成する -> リモート HTTP でサーバーを追加する -> claude mcp list と /mcp で確認する -> 試してみる - で、Claude Code に、自然言語で GitHub を読み取り、操作する能力を与えられました。要点は次のとおりです: リモート HTTP または公式 Docker イメージを使い、非推奨の npm パッケージは避け、トークンはスコープをきつく絞り、どのリポジトリにも残さないこと。もっと速くしたくて、スコープ制御が粗くても構わないなら、上記の /plugin install github@claude-plugins-official コマンドを試す価値があります。基礎をより深く理解するには MCP とは何か、どのように動作するのか を、さらに自動化を進めるには Claude Code での git ワークフロー （公開時にリンク） をご覧ください。/mcp コマンドやその他のスラッシュコマンドが必要ですか？ Claude Code のスラッシュコマンド をご覧ください。