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 を付けます。