GitHub Remote MCP Serverとは?ローカル版との違い・接続手順・OAuth/PAT認証を解説

GitHub Remote MCP Serverは、GitHubが自社でホストするModel Context Protocol(MCP)サーバーで、AIエージェントにGitHubの操作を「ツール」として提供する仕組みです。エンドポイントは https://api.githubcopilot.com/mcp/ の1つで、リポジトリやコードの参照、Issue・Pull Requestの作成や更新、GitHub Actionsの実行状況の確認などを、Copilot ChatやClaude、Cursorといった対応クライアントから自然言語で指示できます。コード補完エンジンではなく、AIとGitHubをつなぐ橋渡し役という点が要点です。この記事では、Docker運用が前提のローカル版との違い、VS CodeやClaude Desktopからの接続手順、OAuthとPATの使い分けまでを整理します。

まとめ:GitHub Remote MCP Serverの要点

  • 正体:GitHubがホストするMCPサーバー。AIエージェントにGitHub操作をツールとして提供する(コード補完サービスではない)。
  • エンドポイントhttps://api.githubcopilot.com/mcp/。ローカル版のようにDockerを立てる必要がない。
  • ローカル版との違い:リモート版はGitHubが運用・自動更新し、OAuthワンクリックで認証できる。ローカル版はDockerで自分のマシンに立て、PATを管理する。
  • 認証:OAuth 2.1(PKCE)が推奨で、主要なCopilot対応IDEとCursorで使える。PAT(GITHUB_PERSONAL_ACCESS_TOKEN)も使え、設定した場合はOAuthより優先される。
  • クライアント:Copilot対応IDE全般が対応。stdioのみのClaude Desktopなどは mcp-remote でHTTPのリモートサーバーへ橋渡しする。
  • 提供状況:2025年6月12日にパブリックプレビュー、2025年9月4日に一般提供(GA)へ移行。ツールセットは拡張が続くため、最新は公式ドキュメントで確認する。

GitHub Remote MCP Serverの正体(GitHubホスト型MCPサーバー)

前提として、MCP(Model Context Protocol)はAIモデルと外部のツール・データソースを標準化された方法でつなぐオープン仕様です。MCPサーバーは「AIが呼び出せるツール群」を公開する側で、GitHub Remote MCP Serverはそのツール群としてGitHubの操作一式を提供します。AIエージェントはこのサーバー経由で、リポジトリの中身を読む、Issueを立てる、Pull Requestにコメントする、といった作業を実行できます。

「Remote(リモート)」は、このサーバーの実体がGitHubのクラウド上に置かれていることを指します。利用者は https://api.githubcopilot.com/mcp/ というURLに対応クライアントを接続するだけで、サーバー本体を自分で用意する必要はありません。GitHubの一般的なMCPサーバーの仕組みや利用目的そのものはGitHub MCPサーバーの基本的な仕組みとその利用目的で扱っているため、本記事はリモート版に固有の論点に絞ります。

リモート版が用意された理由

GitHubのMCPサーバーはもともと、github/github-mcp-server をDockerコンテナとしてローカルに立てて使う形が基本でした。しかしこの方式では、コンテナの管理、Personal Access Token(PAT)の発行とローテーション、イメージ更新の手動pullといった運用の手間が発生します。リモート版はこれらをGitHub側が肩代わりし、Docker不要・自動更新・OAuthワンクリック認証で使い始められるようにしたものです。ローカルのセットアップを省きたい場合の既定の選択肢になります。

ローカル版とリモート版の違い

観点 ローカル版 リモート版
設置 Dockerで自分のマシンに起動 GitHubがホスト(設置不要)
エンドポイント ローカルのstdio/HTTP api.githubcopilot.com/mcp/
認証 PATを自分で発行・設定 OAuthワンクリック(PATも可)
更新 イメージを手動pull GitHubが自動更新
向く場面 オフライン・独自ビルド・細かな制御 手早く導入・運用を任せたい

手軽さを優先するならリモート版、ネットワークから隔離した環境で動かしたい・サーバーの挙動を自分で制御したいならローカル版、という切り分けになります。両者は排他ではなく、同じ github-mcp-server の提供形態が違うだけなので、途中で乗り換えても使えるツールの体系は共通です。

Remote MCP Serverでできること

提供されるツールは、GitHubのAPIでできる操作をAIから呼べるようにしたものです。代表的なものを挙げます。

  • リポジトリ・コード:ファイルやコミットの参照、コード検索、ブランチやリポジトリ構造の把握。
  • Issue・Pull Request:Issueの作成・更新・トリアージ、PRの作成やレビューコメント、変更差分の要約。
  • GitHub Actions・CI/CD:ワークフロー実行の監視、ビルド失敗の調査、リリース管理。

これらは「ツールセット」という単位でまとまっており、必要な機能だけを有効化できます。全ツールを常時渡すとAIに与えるコンテキストが膨らみ、ツール選択の精度も落ちるため、用途に合わせて絞るのが実務上のコツです。

ツールセットで機能を絞る

ローカル版は起動時の --toolsets フラグで有効化するツールセットを指定します。リモート版はURLのパス(例:/mcp/x/repos のように特定ツールセットを指す)や、リクエストヘッダ X-MCP-Toolsets(カンマ区切りで列挙)で切り替えます。何も指定しなければ既定のツールセットが使われます。

読み取り専用モードで安全に使う

書き込みを伴う操作を避けたい場合は読み取り専用にできます。リモート版はヘッダ X-MCP-Readonly、またはURLパスの /readonly を付けることで「read」系ツールだけに限定されます(ローカル版は --read-only)。本番環境での調査やデモなど、AIに誤って変更を加えさせたくない場面で有効です。

対応するAIクライアント

Copilotに対応するIDEはいずれもリモートサーバーに接続できます。GA(2025年9月)以降はOAuthが主要なファーストパーティIDEとCursorに広がり、PATは自動化やstdioのみのクライアントで使う形が中心です。

クライアント 認証 接続方法
VS Code(1.101以降) OAuth/PAT ワンクリック接続
Visual Studio / JetBrains / Xcode / Eclipse OAuth/PAT 設定でURL・認証を指定
Cursor OAuth/PAT 設定でリモートURLを指定
Claude Desktop / Windsurf 等(stdioのみ) OAuth/PAT mcp-remoteで橋渡し

Claude Desktopのように標準ではstdio接続しか持たないクライアントは、HTTPのリモートサーバーへ直接つなげません。この橋渡しを担うのが次に触れる mcp-remote です。Claude Code連携を前提にMCPサーバーを使う具体例はSerena MCPとは?仕組み・導入手順・Claude Code連携も参考になります。

接続・セットアップ手順

VS Codeでワンクリック接続する(OAuth)

VS Codeはバージョン1.101以降であれば、ワンクリック用のインストールボタンからOAuth認証で接続できます。認証を終えたらCopilot Chatの入力欄付近にあるエージェントモードに切り替えると、サーバーが起動しGitHubのツールが使えるようになります。OAuthではサインイン時に承認したスコープの範囲だけがAIに渡り、SAMLや組織の管理ポリシーにも従います。GA以降はVS Code以外の主要Copilot IDEやCursorでも同様にOAuthで接続できます。

Claude Desktopなどをmcpリモートでつなぐ

stdioのみのクライアントは、Node.js製プロキシ mcp-remote(npxで実行)を挟んでリモートサーバーへ接続します。Claude Desktopの設定ファイルには次のように記述します。

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["mcp-remote", "https://api.githubcopilot.com/mcp/"]
    }
  }
}

初回接続時にブラウザでOAuth認証が求められ、承認するとトークンがローカルにキャッシュされます。PATを使う場合は環境変数 GITHUB_PERSONAL_ACCESS_TOKEN を設定します。この値がある場合はOAuthより優先されます。

OAuthとPATによる認証の違い

リモート版はOAuthとPATの両方を使えます。基本はOAuth、CI環境や自動化などブラウザ操作を挟めない場面ではPAT、という使い分けになります。

方式 特徴 ツールの見え方
OAuth 2.1/PKCE(推奨) ワンクリック・短命トークンで自動更新・スコープを承認時に限定 承認したスコープに対応
classic PAT(ghp_) スコープを手動付与 スコープ不足のツールは非表示
fine-grained PAT(github_pat_) 権限を細かく設定 全ツール表示・API側で権限判定

classic PATはスコープが足りないツールをそもそも一覧に出さないため、「必要なツールが表示されない」ときはトークンのスコープ不足を疑うのが定石です。fine-grained PATはツールは全て見えますが、権限外の操作はAPI呼び出し時に弾かれます。

提供状況とつまずきやすい注意点

リモート版は2025年6月12日にパブリックプレビューとして公開され、2025年9月4日に一般提供(GA)へ移行しました。GAでOAuth 2.1(PKCE)が主要Copilot IDEとCursorに広がり、GitHub Projects対応などツールセットの拡張も続いています。細かな対応範囲は更新されるため、導入前に公式ドキュメントで確認してください。認証が通らない・ツールが出ないといった不具合の多くは、クライアントのバージョン不足(VS Codeは1.101以上)かPATのスコープ不足が原因です。

よくある質問

GitHub Remote MCP Serverは無料で使えますか?

MCPサーバー自体はオープンソースで、追加料金なしにGitHubアカウントの権限範囲で利用できます。実行できる操作はアカウントのリポジトリ権限に従います。ただしCopilot固有の機能をあわせて使う場合はCopilotのプランが必要になるため、料金体系は公式で確認してください。

ローカルMCPとリモートMCPの違いは何ですか?

リモート版はGitHubがホストしDocker不要・OAuthワンクリックで使えます。ローカル版はDockerで自分のマシンに立て、PATを管理し、更新も自分で行います。手軽さならリモート、隔離環境や細かな制御が必要ならローカルが向きます。

認証はPATとOAuthのどちらを使うべきですか?

通常はOAuthが推奨です。ワンクリックで、承認したスコープだけがAIに渡るため安全です。ブラウザ操作を挟めないCI・自動化では、環境変数 GITHUB_PERSONAL_ACCESS_TOKEN にPATを設定します。設定するとOAuthより優先されます。

Claude DesktopやCursorからリモートMCPに接続できますか?

できます。これらはstdio接続のため、mcp-remote をnpxで挟んで https://api.githubcopilot.com/mcp/ に橋渡しします。初回にOAuth認証を行うとトークンがキャッシュされます。

リモートサーバーのURLは何ですか?

https://api.githubcopilot.com/mcp/ です。ツールセットを絞る場合はこの後ろにパスを付け(例 /x/repos)、読み取り専用にする場合は /readonly を付けます。

関連記事

資料請求

RELATED POSTS 関連記事