GitHub MCP サーバーの使用

GitHub MCP サーバーについて

GitHub MCP サーバーとは、GitHub によって提供および管理されるモデル コンテキスト プロトコル (MCP) サーバーです。 MCP を使うと、AI 機能を他のツールやサービスと統合し、コンテキスト対応の AI 支援を提供することで開発エクスペリエンスを強化できます。

GitHub MCP サーバーの詳細内容と MCP の概要については、「モデル コンテキスト プロトコル (MCP) について」を参照してください。

前提条件

• GitHub アカウント。
• Visual Studio Code または別の MCP 互換エディター。
• If you are a member of an organization or enterprise with a Copilot Business or Copilot Enterprise plan, the "MCP servers in Copilot" policy must be enabled in order to use MCP with Copilot.

Visual Studio Code での GitHub MCP サーバーの設定

以下では、Visual Studio Code で GitHub MCP サーバーを設定する手順を見ていきます。 他の MCP 互換エディターでは、手順は似ていることがありますが、正確なプロセスは異なる場合があります。

ニーズとユーザー設定に応じて、GitHub MCP サーバーをリモートまたはローカルで設定できます。 次のいずれかを対象に GitHub MCP サーバーを構成することもできます。

• 特定のリポジトリ。 これにより、Visual Studio Code でプロジェクトを開いたすべてのユーザーと MCP サーバーを共有できます。 これを行うには、リポジトリのルートに .vscode/mcp.json ファイルを作成します。
• Visual Studio Code の個人インスタンス。 構成した MCP サーバーにアクセスできるのは自分だけです。 これを行うには、Visual Studio Code で settings.json ファイルに構成を追加します。 この方法で構成された MCP サーバーは、すべてのワークスペースで使用できます。

リモート GitHub MCP サーバーでは、ワンクリック OAuth 認証が既定で使われますが、personal access token (PAT) を認証に使うように手動で構成することもできます。 OAuth をお使いの場合、MCP サーバーはユーザーがサインイン中に承認したスコープにのみアクセスできます。 Organization 所有のコンテキストでは、許可されるスコープとアプリを制御する管理者ポリシーによっても、アクセスが制限される場合があります。 PAT をお使いの場合は、MCP サーバーは PAT によって許可されるスコープにアクセスでき、これは organization によって構成される PAT 制限の対象にもなります。

Enterprise Managed User の場合、Enterprise 管理者が有効にしない限り、PAT は既定で無効になります。 PAT が無効になっている場合、PAT 認証は使用できません。 OAuth アクセス ポリシー制限がある場合は、各クライアント (MCP ホスト アプリケーション) に対して OAuth アプリを有効にする必要があります (ただし、Visual Studio Code と Visual Studio は Microsoft 純正の IDE であり、Copilot がネイティブで統合されているため、この対象には含まれません)。

• OAuth を使用するリモート MCP サーバーの構成
• PAT を使用するリモート MCP サーバーの構成
• ローカル MCP サーバーのセットアップ

OAuth を使用するリモート MCP サーバーの構成

リモート GitHub MCP サーバーを OAuth で使うために、PAT を作成したり、追加のソフトウェアをインストールしたりする必要はありません。 Visual Studio Code で直接設定できます。 また、個々のツールセットを、読み取り専用モードまたは完全な読み取り/書き込みアクセス権限でインストールすることもでき、サーバーの機能を特定のニーズに合わせて調整できます。 詳しくは、「ツールの構成」をご覧ください。

1. Visual Studio Code で、Ctrl + Shift + P キー (Windows/Linux) または Command + Shift + P キー (Mac) を押して、コマンド パレットを開きます。

2. 「mcp: add server」と入力して Enter キーを押します。

3. 一覧から [HTTP (HTTP またはサーバー送信イベント)] を選びます。

4. [サーバー URL] フィールドに「https://api.githubcopilot.com/mcp/」と入力して Enter キーを押します。

5. [サーバー ID の入力] で、Enter キーを押して既定のサーバー ID を使うか、カスタム サーバー ID を入力します。

6. [構成を保存する場所を選択する] で、MCP サーバーの構成を保存する場所を選びます。

   • Visual Studio Code により、選んだファイルがエディターで開かれて構成が追加されるか、存在しない場合は新しいファイルが作成されます。

7. Visual Studio Code のポップアップで、OAuth を使って MCP サーバーを認可するには、[許可] をクリックして、一覧から個人用アカウントを選びます。

PAT を使用するリモート MCP サーバーの構成

PAT を使ってリモート GitHub MCP サーバーを構成するには、MCP サーバーに許可するアクセス権に必要なスコープで PAT が作成されていることを確認します。 詳しくは、「個人用アクセス トークンを管理する」をご覧ください。

認可に PAT を使うには、Visual Studio Code で MCP サーバーを手動で構成する必要があります。

1. Visual Studio Code で、Ctrl + Shift + P キー (Windows/Linux) または Command + Shift + P キー (Mac) を押して、コマンド パレットを開きます。

2. 「mcp: add server」と入力して Enter キーを押します。

3. 一覧から [HTTP (HTTP またはサーバー送信イベント)] を選びます。

4. [サーバー URL] フィールドに「https://api.githubcopilot.com/mcp/」と入力して Enter キーを押します。

5. [サーバー ID の入力] で、Enter キーを押して既定のサーバー ID を使うか、カスタム サーバー ID を入力します。

6. [構成を保存する場所を選択する] で、MCP サーバーの構成を保存する場所を選びます。

   • Visual Studio Code により、選んだファイルがエディターで開かれて構成が追加されるか、存在しない場合は新しいファイルが作成されます。

7. Visual Studio Code のポップアップで、OAuth の認可を拒否するには、[キャンセル] をクリックします。

8. PAT を使うには、構成ファイルを手動で編集する必要があります。 構成ファイルで、url 行の最後に次のコードを追加します。

   JSON

       ,
         "headers": {
           "Authorization": "Bearer ${input:github_token}"
         }
       },
     },
     "inputs": [
       {
         "id": "github_token",
         "type": "promptString",
         "description": "GitHub Personal Access Token",
         "password": true
       }
     ]
   }
   

9. ファイルで [Restart] ボタンが表示されます。 [Restart] をクリックし、新しい構成で MCP サーバーを再起動します。

   

10. コマンド パレットに、GitHub トークンの入力を求めるプロンプトが表示されます。 先ほど作成した PAT を入力して、Enter キーを押します。

    • 認可に PAT を使うように MCP サーバーが構成されます。

ローカル MCP サーバーのセットアップ

GitHub MCP サーバーをローカル環境で使うには、Docker をコンピューターにインストールして実行する必要があります。 また、ローカル MCP サーバーでは OAuth がサポートされていないため、認可には PAT のみを使用できます。

1. お使いのコンピューターに Docker がインストールされ、実行されていることを確認します。 Docker のインストール手順に関するページを参照してください。

2. スコープが (少なくとも) read:packages と repo に設定された PAT を作成します。 詳しくは、「個人用アクセス トークンを管理する」をご覧ください。

3. MCP サーバーの構成対象を特定のリポジトリにするか、Visual Studio Code の個人用インスタンスにするかを決めます。

   • 特定のリポジトリをお使いの場合は、Visual Studio Code で .vscode/mcp.json ファイルを開き、次の構成を追加します。
   JSON

      {
       "inputs": [
         {
           "type": "promptString",
           "id": "github_token",
           "description": "GitHub Personal Access Token",
           "password": true
         }
       ],
       "servers": {
         "github": {
           "command": "docker",
           "args": [
             "run",
             "-i",
             "--rm",
             "-e",
             "GITHUB_PERSONAL_ACCESS_TOKEN",
             "ghcr.io/github/github-mcp-server"
           ],
           "env": {
             "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
           }
         }
       }
     }
   

   • Visual Studio Code の個人用インスタンスをお使いの場合は、Visual Studio Code で settings.json ファイルを開きます。
     • Ctrl+Shift+P キー (Windows/Linux) または Cmd+Shift+P キー (macOS) を押します。
     • 「Preferences: Open Settings (JSON)」と入力して、それを選びます。
     • 次の構成を追加します。
   JSON

   {
     "mcp": {
       "inputs": [
         {
           "type": "promptString",
           "id": "github_token",
           "description": "GitHub Personal Access Token",
           "password": true
         }
       ],
       "servers": {
         "github": {
           "command": "docker",
           "args": [
             "run",
             "-i",
             "--rm",
             "-e",
             "GITHUB_PERSONAL_ACCESS_TOKEN",
             "ghcr.io/github/github-mcp-server"
           ],
           "env": {
             "GITHUB_PERSONAL_ACCESS_TOKEN": "${input:github_token}"
           }
         }
       }
     }
   }
   

4. ファイルを保存します。

5. コマンド パレットに、GitHub トークンの入力を求めるプロンプトが表示されます。 先ほど作成した PAT を入力して、Enter キーを押します。

   • 認可に PAT を使ってローカル環境で実行するように MCP サーバーが構成されます。

ツールの設定

GitHub MCP サーバーでは、個々のツールセットを、読み取り専用モードまたは完全な読み取り/書き込みアクセス権限でインストールすることがサポートされており、サーバーの機能を特定のニーズに合わせて調整できます。 各ツールセットのワンクリック インストール オプションについては、GitHub MCP サーバーのリポジトリを参照してください。

Visual Studio Code での GitHub MCP サーバーの使用

GitHub MCP サーバーを使うと、Visual Studio Code の Copilot Chat を介して、GitHub でさまざまなアクションを実行できます。

1. Visual Studio Code のタイトル バーの アイコンをクリックして、Copilot Chat を開きます。
2. Copilot Chat ボックスで、ポップアップ メニューから [Agent] を選びます。
3. 使用できるアクションを表示するには、Copilot Chat ボックスの [Select tools] アイコンをクリックします。
   • [Tools] ドロップダウンの [MCP Server: GitHub] の下に、使用できるアクションの一覧が表示されます。
4. Copilot Chat ボックスに、実行するアクションに関連するコマンドまたは質問を入力して、Enter キーを押します。
   • たとえば、新しい issue の作成、pull request の一覧表示、リポジトリの情報の取得を、GitHub MCP サーバーに依頼できます。
5. GitHub MCP サーバーによって要求が処理されて、チャット インターフェイスで応答が提供されます。
   • Copilot Chat ボックスでは、アクションを完了するために、追加のアクセス許可の付与または詳細情報の指定を求められる場合があります。
6. プロンプトに従ってアクションを完了します。

トラブルシューティング

GitHub MCP サーバーの使用中に問題が発生した場合は、いくつかの一般的なトラブルシューティング手順を実行できます。

承認の問題

MCP サーバーの認可で問題が発生した場合は、次のことを確認します。

• 任意の IDE で GitHub にサインインしています。

personal access token (PAT) で認証を行っている場合は、次のことを確認します。

• GitHub の PAT が有効であり、実行するアクションに必要なスコープを持っています。
• 正しい PAT を入力しました。

Copilot エージェント モードの問題

Copilot Chat エージェント モードで問題が発生した場合は、次のことを確認します。

• Copilot Chat ボックスで適切なエージェントを選択しています。
• IDE で MCP サーバーを正しく構成しました。
• 実行しようとしているアクションを実行するために必要なアクセス許可があります。

一般的なヒント

GitHub MCP サーバーで他の問題が発生する場合のトラブルシューティングに役立つ一般的なヒントを次に示します。

• MCP サーバーの出力ログでエラー メッセージを調べます。
• MCP サーバーをローカル環境で実行している場合は、ローカル環境が Docker コンテナーの実行用に正しく設定されていることを確認します。
• MCP サーバーまたは IDE を再起動してみます。

  {
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_GITHUB_PAT"
                }
            }
        }
    }
  }

  {
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_GITHUB_PAT"
                }
            }
        }
    }
  }

  {
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_GITHUB_PAT"
                }
            }
        }
    }
  }

  {
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_GITHUB_PAT"
                }
            }
        }
    }
  }

  {
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_GITHUB_PAT"
                }
            }
        }
    }
  }

  {
    "servers": {
        "github": {
            "url": "https://api.githubcopilot.com/mcp/",
            "requestInit": {
                "headers": {
                    "Authorization": "Bearer YOUR_GITHUB_PAT"
                }
            }
        }
    }
  }