VSCodeでGitHub MCPを使う方法について

2026年10月26日

VSCodeでは、GitHub MCP Serverを利用することで、AIエージェントからGitHub上のリポジトリやIssue、Pull Requestなどの情報を参照・操作できます。

MCPとは「Model Context Protocol」の略で、AIと外部サービスを接続するための共通プロトコルです。

GitHubは公式の「GitHub MCP Server」を提供しており、VSCodeのGitHub CopilotなどからGitHubの情報を扱えるようになっています。

特に現在は、GitHub側でホストされているRemote GitHub MCP Serverを利用できるため、自分のPCでMCPサーバーを構築しなくても比較的簡単に導入できます。

この記事では、VSCodeでGitHub MCPを使う方法や設定ファイルの書き方、OAuthとPATの違い、トラブルが発生した場合の確認方法まで詳しく解説します。

GitHub MCPとは

MCPはAIと外部サービスを接続する仕組み

MCPは、AIエージェントから外部のサービスやツールを利用するための仕組みです。

通常のAIチャットでは、GitHub上にある最新のIssueやPull Requestを自由に取得したり、新しいIssueを作成したりすることはできません。

GitHub MCP Serverを利用すると、AIエージェントがGitHubの機能をMCPツールとして呼び出せるようになります。

たとえば、次のような用途があります。

GitHubリポジトリの情報を取得する
Issueを検索する
Issueの詳細を確認する
Issueを作成する
Pull Requestを検索する
Pull Requestの内容を確認する
リポジトリ内のファイル情報を取得する
GitHub上の情報をもとにAIへ質問する

AIとの会話だけでGitHub上の情報を調査できるため、開発作業の効率化に役立ちます。

GitHub公式のGitHub MCP Serverが提供されている

GitHub MCP ServerはGitHub公式で開発・公開されています。

そのため、VSCodeからGitHubをMCP経由で利用したい場合は、基本的にGitHub公式のMCP Serverを利用するとよいでしょう。

GitHub MCP Serverには、大きく分けて次の2種類があります。

Remote GitHub MCP Server
Local GitHub MCP Server

一般的な利用であれば、GitHub側でホストされているRemote GitHub MCP Serverから始めると簡単です。

VSCodeでGitHub MCPを使うために必要なもの

VSCode

GitHub MCPを利用するには、MCPに対応したVSCodeが必要です。

GitHub公式では、Remote GitHub MCP ServerとOAuthを利用する環境としてVS Code 1.101以降が案内されています。

ただし、MCP関連機能は継続的に更新されているため、基本的には最新版のVSCodeを利用することをおすすめします。

GitHubアカウント

GitHub MCP ServerでGitHubへアクセスするため、GitHubアカウントが必要です。

実際に利用できるリポジトリや操作範囲は、そのGitHubアカウントが持っている権限によって変わります。

たとえば、非公開リポジトリを参照する場合は、そのリポジトリへのアクセス権限が必要です。

GitHub Copilot

VSCodeでGitHub MCPを利用する代表的な方法が、GitHub Copilot ChatのAgent機能です。

そのため、VSCodeのCopilot AgentからGitHub MCPを利用する場合は、GitHub Copilotを利用できる環境が必要です。

ただし、GitHub MCP ServerそのものはGitHub Copilot専用ではありません。

MCPに対応した別のクライアントから利用することもできます。

VSCodeにGitHub MCPを追加する方法

MCPサーバーギャラリーから追加する

VSCodeでは、MCPサーバーを検索して追加できます。

まずVSCodeを開き、コマンドパレットを表示します。

WindowsやLinuxでは次のショートカットです。

Ctrl + Shift + P

macOSでは次のショートカットです。

Command + Shift + P

コマンドパレットからMCP関連のメニューを開き、GitHub MCP Serverを追加します。

VSCodeのMCP GalleryからGitHubを検索して追加する方法も利用できます。

MCP: Add Serverを利用する

MCPサーバーを手動で追加する場合は、コマンドパレットから次のコマンドを利用できます。

MCP: Add Server

画面の指示に従ってGitHub MCP Serverを登録します。

設定保存先として、ワークスペース単位またはユーザー単位の設定を選択できます。

GitHub MCPが登録されたか確認する方法

MCP: List Serversを開く

GitHub MCP Serverを追加したら、正常に認識されているか確認します。

コマンドパレットを開き、次のコマンドを実行します。

MCP: List Servers

登録済みのMCPサーバーが一覧表示されます。

GitHub MCP Serverが表示されていれば、VSCode側への登録はできています。

MCPサーバーを開始・停止する

MCPサーバーの一覧から対象サーバーを選択すると、サーバーの状態を確認したり管理したりできます。

環境によっては、次のような操作が利用できます。

Start
Stop
Restart
Show Output

GitHub MCPがうまく動作しない場合は、Restartを試したり、Show Outputからエラー内容を確認したりすると原因を調査しやすくなります。

Copilot ChatからGitHub MCPを使う方法

Copilot Chatを開く

VSCodeでGitHub Copilot Chatを開きます。

GitHub MCPをツールとして利用する場合は、AIエージェントがツールを呼び出せるモードを使用します。

Agentを選択する

Copilot ChatのモードからAgentを選択します。

Agentでは、AIがMCPサーバーなどの外部ツールを必要に応じて呼び出せます。

GitHub MCP Serverが登録されていれば、GitHub関連ツールをAgentから利用できるようになります。

Configure Toolsで利用可能なツールを確認する

Copilot Chatの「Configure Tools」を開くと、AIエージェントから利用できるツールを確認できます。

GitHub MCP Serverを展開すると、GitHub MCPが提供している各種ツールが表示されます。

必要なツールが無効になっている場合は、ここから有効にします。

GitHub MCPを自然言語で利用する方法

Issueを検索する

GitHub MCPでは、AIに自然言語で指示できます。

たとえば、次のように入力します。

このリポジトリの未解決Issueを確認して

GitHub MCP ServerがIssue情報を取得し、AIが内容を整理して回答します。

より具体的に検索することも可能です。

このリポジトリでログインエラーに関係する未解決Issueを探して

Pull Requestを確認する

Pull Requestの調査にも利用できます。

たとえば、次のように依頼できます。

現在オープンになっているPull Requestを一覧表示して

さらに、AIによる要約と組み合わせることもできます。

現在オープンになっているPull Requestを確認して、変更内容を簡単にまとめて

Issueを作成する

書き込み権限がある場合は、Issueの作成なども可能です。

たとえば次のように指示します。

この不具合についてGitHub Issueを作成して

書き込みを伴う操作では、VSCodeやAIエージェント側から確認が表示される場合があります。

内容を確認してから実行しましょう。

mcp.jsonでGitHub MCPを設定する方法

VSCodeでは複数のMCP設定方式がある

GitHub MCPはGUIから追加するだけでなく、設定ファイルへ直接記述することもできます。

VSCodeでは、代表的に次のような設定方式があります。

.vscode/mcp.json

または、

.mcp.json

などです。

ただし、これらは設定ファイルの形式が同じではないため注意が必要です。

.vscode/mcp.jsonを利用する

VSCode固有のワークスペース設定として.vscode/mcp.jsonを利用できます。

Remote GitHub MCP ServerをOAuthで利用する基本的な設定例は次のとおりです。

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

Remote GitHub MCP ServerのURLは次のとおりです。

https://api.githubcopilot.com/mcp/

VSCodeからMCPサーバーへ接続すると、必要に応じてGitHubへの認証が行われます。

.mcp.jsonを利用する

現在のVSCodeでは、ワークスペースルートに.mcp.jsonを置くポータブルなMCP設定方式も利用できます。

.mcp.jsonは.vscode/mcp.jsonとはJSON構造が異なります。

.vscode/mcp.jsonではトップレベルに、

servers

を使用します。

一方、ポータブルな.mcp.jsonでは、

mcpServers

を使用する形式があります。

そのため、設定ファイルをコピーするときは、保存場所だけでなく設定フォーマットも確認することが重要です。

.vscode/mcp.jsonと.mcp.jsonの違い

.vscode/mcp.jsonはVSCode向けの設定

.vscode/mcp.jsonは、VSCodeワークスペース向けの設定として利用できます。

プロジェクト単位でMCP構成を管理するときに便利です。

たとえば、次のような構成になります。

project/
├─ .vscode/
│  └─ mcp.json
├─ src/
├─ package.json
└─ README.md

チームで共通のMCP構成を利用したい場合にも活用できます。

.mcp.jsonはポータブルな設定として利用できる

.mcp.jsonは、VSCodeだけに強く依存しないMCP設定として利用しやすい形式です。

Agent HostやほかのMCP対応環境との互換性を意識する場合は、.mcp.jsonなどのポータブル形式を検討するとよいでしょう。

新しくMCP設定を作成する場合は、使用するツールや環境に応じて設定方式を選択することが重要です。

OAuthでGitHub MCPを使う方法

OAuthならPATを直接管理しなくてよい

Remote GitHub MCP ServerではOAuth認証を利用できます。

基本設定は次のようになります。

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/"
    }
  }
}

サーバーへ接続するとGitHub認証が行われます。

OAuth方式では、自分でPersonal Access Tokenを作成し、設定ファイルへ登録する必要がない点がメリットです。

一般的なVSCode利用であれば、まずOAuth方式から試すと分かりやすいでしょう。

PATでGitHub MCPを使う方法

Personal Access Tokenによる認証も可能

GitHub MCP Serverでは、PATを利用した認証も可能です。

設定例は次のようになります。

{
  "servers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${input:github_mcp_pat}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "github_mcp_pat",
      "description": "GitHub Personal Access Token",
      "password": true
    }
  ]
}

このように入力変数を利用すれば、PATを設定ファイルへ直接書き込まずに済みます。

PATを設定ファイルへ直接書かない

次のようにPATを直接記述する方法は避けましょう。

{
  "Authorization": "Bearer github_pat_xxxxxxxxx"
}

特に.vscode/mcp.jsonなどをGit管理している場合、誤ってトークンをGitHubへコミットしてしまう危険があります。

APIキーやPATなどの機密情報は、ソースコードや共有設定から分離して管理することが重要です。

Remote GitHub MCP Serverとは

GitHub側でホストされるMCPサーバー

Remote GitHub MCP ServerはGitHub側でホストされています。

そのため、自分のPCでMCPサーバーを起動・管理する必要がありません。

主なメリットは次のとおりです。

セットアップが簡単
Dockerを用意する必要がない
ローカルサーバーを管理しなくてよい
OAuthを利用しやすい

特別な理由がなければ、まずRemote GitHub MCP Serverから始めると導入しやすいでしょう。

Local GitHub MCP Serverとは

自分のPCでMCPサーバーを実行する

Local GitHub MCP Serverでは、自分のPC上でGitHub MCP Serverを実行します。

Remote版よりもセットアップの手間は増えますが、サーバー構成を細かく制御したい場合に適しています。

Docker以外でも実行できる

Local GitHub MCP ServerはDockerで実行できます。

ただし、ローカル版はDocker必須というわけではありません。

ネイティブバイナリを使用して実行する方法もあります。

環境によっては、次のようにstdioモードで実行できます。

github-mcp-server stdio

現在のGitHub MCP Serverでは、ローカルstdio版でもOAuthログインを利用できる構成があります。

GitHub MCPのToolsetとは

利用するGitHub機能を制限できる

GitHub MCP ServerにはToolsetという考え方があります。

GitHub MCPを接続したからといって、必ずすべてのGitHub機能がAIから利用できるわけではありません。

たとえば、次のようなToolsetがあります。

issues
pull_requests
repos
actions

利用するToolsetを絞れば、AIへ公開するGitHub機能を制限できます。

利用可能な機能は権限によって変わる

実際にAIが利用できる操作は、主に次の条件で変わります。

有効になっているToolset
有効になっている個別ツール
GitHubアカウントの権限
PATやOAuthで付与された権限
組織のポリシー

GitHub MCP Serverを接続しただけで、GitHub上のすべての情報へ自由にアクセスできるわけではありません。

GitHub MCPを読み取り専用で使う

調査だけなら書き込み権限を減らす

GitHub MCP Serverには、読み取り専用で利用するための構成もあります。

たとえば、次のような用途であれば、書き込み権限は必ずしも必要ありません。

Issueを調べる
Pull Requestを確認する
リポジトリ情報を確認する
コードや履歴を分析する

AIからGitHubへの書き込みが不要な場合は、可能な限り権限を絞ると安全です。

GitHub MCPが使えない場合の対処法

VSCodeのバージョンを確認する

まずVSCodeが古くないか確認します。

Remote GitHub MCP ServerやOAuthを利用する場合は、MCPに対応したバージョンが必要です。

基本的には最新版へアップデートしておくとよいでしょう。

GitHubへの認証を確認する

OAuth認証を利用している場合は、GitHubへのログインが正常に完了しているか確認します。

認証が切れている場合は、再度ログインが必要になることがあります。

MCPサーバーの状態を確認する

コマンドパレットから次のコマンドを実行します。

MCP: List Servers

GitHub MCP Serverが停止している場合は、StartまたはRestartを試します。

エラーが発生している場合はShow Outputからログを確認します。

MCPツールが有効か確認する

Copilot ChatのConfigure Toolsを開き、GitHub MCP Serverのツールが有効になっているか確認します。

MCPサーバー自体が登録されていても、必要なツールが無効になっているとAIから利用できません。

MCPのキャッシュをリセットする

必要に応じて、次のコマンドを利用できます。

MCP: Reset Cached Tools

MCPツール情報のキャッシュが原因で正常に認識されない場合に役立つことがあります。

MCPの信頼設定をリセットする

MCPサーバーの信頼設定に問題がある場合は、次のコマンドも利用できます。

MCP: Reset Trust

信頼設定をリセットした後、MCPサーバーを再度確認します。

組織アカウントでGitHub MCPを使う場合の注意点

管理者ポリシーで利用できないことがある

GitHub Copilot BusinessやGitHub Copilot Enterpriseなどを組織で利用している場合、管理者側の設定によってMCPの利用が制限されることがあります。

自分のVSCode設定に問題がなくてもMCPを利用できない場合は、組織のCopilotやMCPに関するポリシーを確認するとよいでしょう。

企業環境では、セキュリティ上の理由から外部MCPサーバーや特定ツールの使用が制限されているケースがあります。

GitHub MCPを安全に使うためのポイント

信頼できるMCPサーバーだけを利用する

MCPサーバーはAIから外部システムへアクセスするための入口になります。

そのため、提供元が不明なMCPサーバーを安易に追加するのは避けるべきです。

GitHub連携では、基本的にGitHub公式のGitHub MCP Serverを利用すると安心です。

不要な書き込み権限を与えない

Issue作成やPull Request操作などが不要であれば、読み取り中心の権限に制限すると安全性を高められます。

権限は「必要最小限」にするのが基本です。

PATをGitへコミットしない

PATやAPIキーは、絶対にGit管理対象へ直接記述しないようにします。

特に、

.vscode/mcp.json

などをリポジトリへ含める場合は注意が必要です。

${input:...}などを利用し、秘密情報と設定を分離しましょう。

AIが実行する操作を確認する

GitHub MCPを利用すると、AIが実際にGitHubへ書き込みを行う場合があります。

Issue作成や変更操作を実行する前には、内容や対象リポジトリが正しいか確認することが重要です。

VSCodeでGitHub MCPを使う基本的な流れ

初めて利用する場合の手順

VSCodeでGitHub MCPを初めて使う場合は、次の流れで進めると分かりやすいでしょう。

VSCodeを最新版へ更新する
GitHubアカウントを用意する
GitHub MCP Serverを追加する
MCP: List Serversで登録状態を確認する
必要に応じてGitHubへOAuth認証する
Copilot Chatを開く
Agentを選択する
Configure ToolsでGitHub MCPのツールを確認する
GitHubに関する指示を自然言語で入力する

たとえば、

このリポジトリの未解決Issueを確認して

と入力すれば、GitHub MCPを通してIssue情報を取得できます。

まとめ

VSCodeでGitHub MCPを利用すると、AIエージェントからGitHub上のIssueやPull Request、リポジトリ情報などを直接扱えるようになります。

現在はGitHub公式のRemote GitHub MCP Serverが提供されているため、自分でサーバーを構築しなくても比較的簡単に導入できます。

一般的な環境では、Remote GitHub MCP ServerとOAuthを組み合わせる方法から始めると分かりやすいでしょう。

VSCodeでは.vscode/mcp.jsonだけでなく、.mcp.jsonなどのポータブルなMCP設定も利用できます。

そのため、チーム共有やAgent Hostなどとの互換性まで考える場合は、どの形式でMCP設定を管理するかも重要になります。

また、GitHub MCPはIssue作成などの書き込み操作も実行できるため、PATの管理、Toolsetの制限、読み取り専用構成などを活用し、必要最小限の権限で運用することが大切です。

GitHub MCPを適切に設定すれば、VSCodeから離れることなくGitHubの情報収集や調査、開発作業をAIと連携して効率化できます。

以上、VSCodeでGitHub MCPを使う方法についてでした。

最後までお読みいただき、ありがとうございました。

よかったらシェアしてね！

URLをコピーしました！

URLをコピーしました！