GitHub 公式 MCP と GitLab MCP|エージェントに任せる範囲の決め方
GitHub 公式 MCP はリモートとローカル、GitLab MCP は 19.2 から Free でも使えます。Issue・PR を任せる範囲は、ツールの絞り込み・トークンの権限・保護ブランチの3つの層で決まります。
目次 クリックで開く
この記事の要点
- GitHub の公式は github/github-mcp-server で、GitHub が動かすリモートのサーバーと、Docker などで自分で動かすローカルのサーバーがあります。GitLab の公式は GitLab 本体に入った MCP サーバー(/api/v4/mcp)で、GitLab 19.2 から Free のプランでも使えます。2026年10月14日時点でリリース済みの最新は 19.4 で、状態はベータでした。その後、2026年10月15日にリリースされた 19.5 で一般提供(GA)になりました。
- エージェントに任せる範囲は、指示文ではなく3つの層の設定で決まります。サーバーが見せるツール(ツールセット・読み取り専用)、トークン(誰の権限で動くか)、リポジトリの保護(誰がマージできるか)です。
- どちらのサーバーにもマージのツールがあり、トークンの持ち主がマージできるなら、エージェントもマージできます。最初は読むツールだけでつなぎ、マージのツールは、保護ブランチで人のレビューが必須になっていることを確かめてから使います。
エージェントに任せる範囲を決める3つの層
出典:GitHub「Remote GitHub MCP Server」、「Policies & Governance」、GitLab Docs「GitLab MCP server」19.5 版、GitHub Docs「保護されたブランチについて」、GitLab Docs「Protected branches」
GitHub と GitLab は、どちらも公式の MCP サーバーを出していて、Claude Code や Cursor などのエージェントから、Issue と PR(GitLab ではマージリクエスト、MR)を読んだり作ったりできます。
当社は、Claude Code をはじめとする生成AIの導入や、業務の自動化を支援しています。この記事では、GitHub の公式リポジトリ(github/github-mcp-server)と GitHub Docs、GitLab Docs の記述に沿って、提供の形・認証・ツールの絞り方・読み取り専用の設定・GitLab 側の提供状況を確かめ、層ごとに何を設定するかを書きます。コミュニティが作った GitLab 向けの MCP サーバー、GitLab Duo Agent Platform の使い方、Cursor の設定ファイルの細部(別の記事にあります)は扱いません。
例は、架空の社内プロジェクト「受注管理」のリポジトリ1つで通します(説明のための架空の例です)。エージェントに任せたいのは、バグ報告の Issue を読んで整理のコメントを書き、修正の PR(MR)の下書きを作るところまでで、マージは人がします。
MCP でつなぐときに気をつける点は、動画でも解説しています。
提供の形:GitHub はリモートとローカル、GitLab は GitLab 本体に入っている
GitHub の公式の MCP サーバーは、github/github-mcp-server というリポジトリで開発されています。GitHub が動かすリモートのサーバー(https://api.githubcopilot.com/mcp/)と、自分のパソコンで動かすローカルのサーバーがあります。リモートにしか無いツール(Copilot のコーディングエージェントを呼ぶ create_pull_request_with_copilot など)もあります(GitHub「Remote GitHub MCP Server」)。ローカルは、Docker のイメージ ghcr.io/github/github-mcp-server か、配布されているバイナリで動かします(README)。GitHub Docs は、多くの人にはリモートを、設定を細かく変えたい人や特定のセキュリティ要件がある人にはローカルを勧めています。サーバーはプランに関係なく使えます。ただし、個々のツールは元の機能と同じ契約を求めます。たとえば、Copilot のクラウドエージェントを使うツールには、有料の Copilot が要ります(GitHub Docs「GitHub MCP サーバーの設定」)。
GitLab の公式の MCP サーバーは別のソフトではなく、GitLab のインスタンスに入っています。つなぐ先は https://<GitLab のホスト>/api/v4/mcp で、GitLab.com なら gitlab.com です。以前は Premium 以上と GitLab Duo が前提でしたが、ドキュメントの履歴では次のように変わっています(GitLab Docs「GitLab MCP server」19.4 版)。
GitLab の MCP サーバーの経緯(GitLab Docs の履歴)
18.3
試験的な機能(Experiment)
- フィーチャーフラグつき
- 既定では無効
18.6
ベータ
- フラグを撤去
- HTTP でつなぐ方式を追加
19.2
Premium から Free へ
- 独立した設定になる
- GitLab.com はグループごとに接続を許可
19.4
10月14日時点の最新(ベータ)
- Issue・MR・マージ・コミットのツールがそろう
- 2026年9月17日リリース
19.5
2026年10月15日リリース
- 一般提供(GA)
- ツールセットの指定、GitLab.com の利用者ごとの上限
出典:GitLab Docs「GitLab MCP server」19.4 版、19.5 版、GitLab のリリースノート
版には気をつけます。2026年10月14日の時点で、リリース済みの最新は 19.4(2026年9月17日)でした。その後、19.5 が2026年10月15日にリリースされ、MCP サーバーは一般提供(GA)になりました。リリースノートには、ツールセットの選択と、GitLab.com での利用者ごとの上限も載っています(GitLab 19.5 のリリースノート)。この記事では、19.4 の版の文書にある事実と、19.5 の版の文書(GitLab Docs 19.5 版)で入った事実を分けて書きます。19.5 の版の文書に無く、版を付けない docs.gitlab.com のページ(次の 19.6 の開発中の内容)にだけある記述は、そのように断ります。どの機能も、自分の GitLab の版で効くかを確かめてから使ってください。
どちらの場合も、使う前に接続の許可が要ります。GitLab.com では、トップレベルのグループの Owner が、グループの[Settings]→[General]→[Permissions and group features]の[MCP client access]で[Allow connection to GitLab]をオンにします。今あるトップレベルのグループは、19.2 で設定が入った時点で GitLab Duo と実験・ベータの機能を両方オンにしていたものを除き、既定でオフです。19.5 以降に作るグループは、既定でオンです。Self-Managed と Dedicated では、管理者がインスタンスで許可します(GitLab Docs「Allow access to the MCP server」19.5 版)。
| 項目 | GitHub | GitLab |
|---|---|---|
| 公式のサーバー | github/github-mcp-server(リモートとローカル) | GitLab 本体の MCP サーバー |
| つなぐ先 | リモート:https://api.githubcopilot.com/mcp/。ローカル:Docker のイメージかバイナリ | https://<ホスト>/api/v4/mcp |
| つなぎ方 | リモートは HTTP(Streamable HTTP)、ローカルは stdio(HTTP でも起動できる) | HTTP(推奨)か、mcp-remote を挟む stdio(Node.js 20 以降) |
| 認証 | OAuth か PAT | OAuth(動的なクライアント登録か、事前に登録したアプリ)。細かい権限の個人用トークンの記述は、19.5 の版の文書に無く、開発中の文書(19.6)にある |
| プラン | すべてのプラン。ツールは元の機能の契約を継ぐ | Free・Premium・Ultimate(19.2 から)。GitLab.com・Self-Managed・Dedicated |
| 自社で動かす版 | GitHub Enterprise Server はリモート非対応。ローカルのサーバーに GITHUB_HOST を渡す | Self-Managed・Dedicated でも使える。管理者がインスタンスで許可する |
層1:サーバーが見せるツールを絞る
MCP のサーバーは、つないだ AI ツールに、使えるツールの一覧を渡します。一覧に無いツールは呼ばれないので、最初に絞るのはここです。GitHub の README も、要るツールセットだけを有効にすると、モデルがツールを選びやすくなり、文脈の量も減るとしています(README「Tool Configuration」)。
ツールの絞り方(GitHub と GitLab で書き方が違う)
GitHub
URL・ヘッダー(リモート)、引数・環境変数(ローカル)
- 既定は context・repos・issues・pull_requests・users の5つ
- URL の末尾の /readonly で、読むツールだけにする
- X-MCP-Toolsets でツールセット、X-MCP-Tools でツール名を指定
- ローカルは –toolsets・–tools・–read-only
GitLab
HTTP のヘッダー(19.5 から)
- 既定は core・merge_requests・work_items・repository・ci。使える人には duo_agent_platform も(meta は常に)
- X-Gitlab-Enabled-Mcp-Server-Toolsets でツールセットを指定
- X-Gitlab-Enabled-Mcp-Server-Tools でツール名を指定
- 2つを付けると足し算になる(狭まらない)
出典:GitHub「Remote GitHub MCP Server」、README、GitLab Docs「Select tool groups (toolsets)」
GitHub:URL とヘッダー、ローカルは起動の引数
リモートでは、URL を /x/issues のように /x/ に続けると、1つのツールセットだけになります。/x/all はすべてのツールセットです。読み取り専用は、X-MCP-Readonly のヘッダーでも指定できます。知らないツールセットの名前は黙って無視されますが、知らないツール名はエラーになり、サーバーが起動しません(GitHub「Remote GitHub MCP Server」)。
ローカルでは、環境変数 GITHUB_TOOLSETS・GITHUB_TOOLS・GITHUB_READ_ONLY=1 でも同じことができ、引数と両方あれば環境変数が優先です。読み取り専用はツール名の指定より強く、書き込みのツールを名指ししても外されます(README)。
GitLab:19.4 までは絞る設定が無く、19.5 でヘッダーが入った
19.4 の版の GitLab Docs には、サーバーが返すツールを絞る設定の記述がありません(ツール名に接頭辞を付けるヘッダーだけがあります)。ツールセットとツール名のヘッダーは、19.5 で入りました。19.5 の版の文書では、wikis と code_security は名前を書いたときだけ入り、all と書けばすべてが入ります。知らない名前には 400 が返ります。GitLab Duo Agent Platform を使える人には、duo_agent_platform のツールセットも既定で入ります(GitLab Docs 19.5 版)。
ツール名のヘッダーだけを付けると、既定のツールセットも meta も入らず、名前を書いたツールだけが返ります。読むツールだけにしたいなら、ツール名のヘッダーだけを使うことをお勧めします。ツールセットのヘッダーを足すと、そのツールセットのツールが全部戻るからです。なお、一覧に出たツールでも、呼び出すたびにプロジェクトとグループの権限が確かめられます(同じページ)。
書き込みのツールは、どちらにもマージまである
作例で任せたい操作と、それにあたるツールを並べると次のとおりです。どちらのサーバーにも、Issue を作るところからマージまでのツールがそろっています。
| 操作 | GitHub のツール | GitLab のツール |
|---|---|---|
| Issue を作る・直す | issue_write(method が create か update) | save_work_item。create_issue は 19.4 で一覧から外れたが、呼ぶことはまだできる |
| コメントを書く | add_issue_comment(Issue と PR) | save_note(MR と作業項目が対象で、行の頭は / にできない) |
| PR/MR を作る | create_pull_request | save_merge_request |
| レビュー・承認 | pull_request_review_write | save_merge_request_review(approve を含む) |
| ファイルを変えてコミットする | create_or_update_file・push_files | add_commit |
| マージする | merge_pull_request | accept_merge_request。指定した SHA が MR の先頭と違えば止まる。チェックが通ったらマージする予約もできる |
出典は GitHub の README の「Tools」と GitLab Docs「GitLab MCP server tools」です。GitLab のコメントの行の頭を / にできないのは、/merge のようなクイックアクションが動かないようにするためです。
層2:トークン。エージェントは、その持ち主として動く
GitHub の「Policies & Governance」は、MCP のサーバーを使っても、その人やアプリが API でふだんできる範囲は超えられないと書いています(GitHub「Policies & Governance」)。逆に言えば、トークンの持ち主ができることは、エージェントもできます。
GitHub:OAuth か PAT、組織は方針で縛る
リモートのサーバーは、OAuth でサインインするか PAT を渡して使います。OAuth なら、サーバーが使えるのはサインインのときに承認したスコープだけで、組織のリポジトリでは管理者の方針でさらに絞られることがあります。PAT なら、PAT に付けたスコープの範囲で、組織が決めた PAT の制限も受けます。Enterprise Managed Users では、PAT は企業の管理者が許可しない限り使えません(GitHub Docs「GitHub MCP サーバーの設定」)。
OAuth には、つなぐ側のアプリごとに GitHub App か OAuth App の登録が要ります。PAT は、リモートに対応したアプリならどれでも使えます(README)。Claude Desktop では、リモートのサーバーに要る OAuth に今は対応していないので、GitHub の手引きはローカルの Docker で動かす方法を載せています(GitHub「Install … in Claude Applications」)。Cursor でリモートにつなぐときも、今のところ PAT が要ります(Cursor の設定の記事に書いています)。ローカルのサーバーは、github.com なら最初に使うときにブラウザで OAuth のログインができ、トークンはメモリにだけ置かれます。GITHUB_PERSONAL_ACCESS_TOKEN を渡すと、そちらが優先されます(README)。
組織の側の制御は、つなぎ方で分かれます。いまの Claude Desktop と Cursor は PAT でつなぐので、効くのは PAT の方針です。ほかのアプリから OAuth でつなぐなら、組織の[Settings]→[Third-party Access]の OAuth App のアクセス制限(管理者が承認するまで組織のデータに届かない)か、GitHub App のインストールで縛ります。PAT なら、組織・企業の PAT の方針で縛ります。Fine-grained の PAT(推奨)は、組織へのアクセスに承認を求められます。Classic の PAT は、組織で丸ごと止められます。SSO を強制していれば、どちらの PAT も、最近の SSO のログインに結び付いていないと届きません。Copilot の「MCP servers in Copilot」の方針は、今は VS Code と Copilot のコーディングエージェントに効き、Claude・Cursor など他社のアプリには効きません(GitHub「Policies & Governance」)。
記録と上限も、トークンの持ち主のものです。MCP からの操作は、監査ログにふつうの API の呼び出しとして残り、MCP の接続やツールごとに見る画面は、この文書の時点(2025年7月)ではありません(同じ文書)。REST API の上限は、PAT と、その人に代わって動く OAuth App・GitHub App の要求を合わせて、1時間に5,000件です。GitHub Enterprise Cloud の組織が持つアプリを通すと、15,000件になる場合があります(GitHub Docs「REST API のレート制限」)。エージェントが広く検索すると、同じ人の枠が減ります。
GitLab:OAuth でつなぐ。受け付けるトークンの条件は、開発中の文書(19.6)にある
19.4 と 19.5 の版の GitLab Docs では、AI ツールは初めてつなぐときに自分を OAuth アプリとして登録し(動的なクライアント登録、DCR)、利用者がブラウザで承認してアクセストークンを受け取ります。受け付けるトークンの節は、19.5 の版の文書にはありません。版を付けない docs.gitlab.com のページ(次の 19.6 の開発中の内容)に書かれています。受け付けるのは、mcp スコープの OAuth のアクセストークンと、細かい権限の個人用トークン(fine-grained personal access token)に MCP tool のリソースと Execute の権限を付けたものの2つです。従来の個人用トークンと、プロジェクトとグループのアクセストークンは、api スコープがあっても 403 Forbidden で断られるとされています(開発中の版(19.6)の GitLab Docs)。19.5 以前でこれらのトークンがどう扱われるかは、19.4 と 19.5 の版の文書には書かれていません。
DCR は、AI ツールが初めてつなぐとき(認証をやり直したときも)に OAuth アプリを1つ作ります。Self-Managed と Dedicated では、利用者が多いとアプリが大量にできます。IP アドレスごとの登録の上限(1時間に10件)にも、出口の IP を共有する人たちがまとめて当たります。避けるには、インスタンス・グループ・ユーザーのどれかに OAuth アプリを1つ作って、そのアプリの ID(clientId)を使い回します。管理者が DCR をオフにしているインスタンスでは、この使い回しが必須です。アプリを共有しても、各自が自分の資格情報で承認し、それぞれのアクセストークンを受け取ります(GitLab Docs 19.5 版の「Reuse a single OAuth application」)。
ただし GitLab は、clientId を出したのがどの AI ツールかは確かめません。また REST API で作ったアプリは PKCE(認可コードの横取りを防ぐ仕組み)を必須にしないので、AI ツールが code_challenge を送っているかを確かめます(同じページ)。
コメントや承認は、認証した本人の名前で書かれます(GitLab Docs の save_note など)。開発中の文書(19.6)では、AI の書き込みをプロジェクトのアクセストークン(ボットのユーザー)に分ける手は使えず、対応は issue 586184 で提案中とされています(開発中の版(19.6)の GitLab Docs)。19.5 の版の文書には、この記述はありません。AI 専用のアカウントで分けたいなら、ふつうのユーザーを1人作り、その人が OAuth で承認してつなぐことになります。これは受け付けるトークンの条件から考えた方法で、この記事では試していません。
19.5 では、GitLab.com の MCP サーバーへの要求に、利用者ごとの上限が入りました。上限は Free が1分に60件、Premium と Ultimate が600件で、AI ツールをいくつつないでも1人分として数えます。19.5 の版の文書の履歴には、フィーチャーフラグつき・既定で無効で入ったと書かれています。超えると 429 Too Many Requests が返ります(GitLab Docs 19.5 版の「Rate limits」)。19.5 のリリースノートでは、2026年10月15日から GitLab.com でこの上限がかかっています(GitLab 19.5 のリリースノート)。
層3:リポジトリの保護。マージを止めるのはエージェントの外
層1でマージのツールを外し、層2で権限を絞っても、設定を変えれば戻ります。人がマージするという線を確実にするのは、リポジトリの側の保護です。エージェントはトークンの持ち主として動くので、見るべきなのは、その人が保護されたブランチにマージできるかです。
作例の main に、エージェントがマージできてしまうか
トークンの持ち主は、main にマージできる権限を持っているか
例:受注管理のリポジトリに書き込みの権限があり、main が保護されていない
その人はリポジトリの管理者か、保護を飛ばせるロールか
GitHub の保護ブランチの制限は、既定では管理者に効かない
出典:GitHub Docs「保護されたブランチについて」、GitLab Docs「Protected branches」、GitHub「Policies & Governance」
GitHub では、保護ブランチの[Require pull request reviews before merging](マージ前に pull request レビュー必須)で、書き込み権限のある人かコードオーナーの承認を、決めた数だけ求められます。「最新のレビュー可能なプッシュ」の承認をプッシュした人以外に求めれば、エージェントが足したコミットは別の人が見るまでマージできません。制限は既定では管理者と[ブランチ保護をバイパスする]権限のロールに効かないので、[上記の設定をバイパスすることを許可しない]を有効にします(GitHub Docs「保護されたブランチについて」)。保護ブランチは、GitHub Free ではパブリックのリポジトリで、Pro・Team・Enterprise Cloud・Enterprise Server ではプライベートのリポジトリでも使えます。
GitLab では、保護ブランチの[Allowed to merge]で、マージリクエストからマージできるロールを決めます。[Allowed to push and merge]は、保護されたブランチへの直接のプッシュとマージを決める別の設定です(GitLab Docs「Protected branches」)。トークンの持ち主のロールがどちらにも入っていなければ、accept_merge_request を呼んでも main には入りません。
判定の図の対処は、マージのツールを残すかどうかより先に決めます。ツールの一覧は接続の設定1つで変わりますが、保護ブランチはそうではありません。GitHub ではリポジトリの管理者か「リポジトリ ルールの編集」の権限を持つロール、GitLab では Maintainer か Owner でなければ変えられないからです。GitHub のルールセットを扱う governance のツールセットは既定に入っていないので、足さないでおきます(README)。
読ませる中身にも、指示が混ざる
エージェントは、Issue やコメントに書かれた文章も読みます。GitLab Docs は、MCP のツールを使うときのプロンプトインジェクション(読ませた文章に紛れた指示で AI の動きを変える攻撃)への備えは利用者の責任だとし、信頼できる GitLab のオブジェクトにだけ使うよう求めています(GitLab Docs)。
GitHub には Lockdown mode があります。パブリックのリポジトリで、プッシュの権限が無い人が書いた Issue・PR・コメントを、ツールの結果から外すか、エラーにします。ただし GitHub は、これは権限の境界ではなく、同じトークンで別のツールや API を使えば外した中身にも届くと書いています。リモートでは X-MCP-Lockdown のヘッダー、ローカルでは --lockdown-mode(GITHUB_LOCKDOWN_MODE=1)で有効にします(README「Lockdown Mode」)。外の人が Issue を書けるパブリックのリポジトリでは、有効にしたうえで、層3の保護に頼ることをお勧めします。
設定例:作例の受注管理を、読むだけでつなぐ
ここからの設定は、GitHub と GitLab の手引きにある例に、作例の絞り込みを足したものです。動かして確かめてはいません。YOUR_GITHUB_PAT には、受注管理のリポジトリだけを読める Fine-grained の PAT を入れます。
GitHub:Claude Code からリモートにつなぐ
Claude Code(2.1.1 以降)。ターミナルで実行する(作例)
claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp/","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT","X-MCP-Toolsets":"repos,issues,pull_requests","X-MCP-Readonly":"true"}}'
Windows で Invalid input が返るときは、手引きにある古い形の claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer YOUR_GITHUB_PAT" を使います。登録したら Claude Code を開き直し、claude mcp list で確かめます。--scope project を付けるとプロジェクトの .mcp.json に書かれて共有されるので、トークンを書いた設定は入れないでください。手引きも、.env と .mcp.json を .gitignore に足す例を載せています(GitHub「Install … in Claude Applications」)。
GitHub:Claude Desktop からローカルのサーバーで
claude_desktop_config.json(作例。Docker が要る)
{
"mcpServers": {
"github": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "GITHUB_PERSONAL_ACCESS_TOKEN",
"-e", "GITHUB_TOOLSETS",
"-e", "GITHUB_READ_ONLY",
"ghcr.io/github/github-mcp-server"
],
"env": {
"GITHUB_PERSONAL_ACCESS_TOKEN": "YOUR_GITHUB_PAT",
"GITHUB_TOOLSETS": "repos,issues,pull_requests",
"GITHUB_READ_ONLY": "1"
}
}
}
}
設定ファイルは、Claude Desktop の[Settings]→[Developer]→[Edit Config]で開けます。PAT を使わずに OAuth でログインするなら、GITHUB_PERSONAL_ACCESS_TOKEN の代わりに、ログインの戻り先のポートを -p 127.0.0.1:8085:8085 と GITHUB_OAUTH_CALLBACK_PORT で開けます(同じ手引き)。GitHub Enterprise Server では、GITHUB_HOST に https:// から始まるホスト名を渡します(README)。
GitLab の2つの例で使うツール名のヘッダーは 19.5 で入った機能で、19.4 の版の文書にはありません。効かない版では、既定のツール(accept_merge_request・add_commit を含む)がそのまま出るかもしれません。登録したら、Claude Code では /mcp でツールの一覧を開き、save_ で始まるツールや accept_merge_request・add_commit などの書き込みのツールが出ていないことを確かめてください。出ていれば、ヘッダーは効いていないので、層2の権限と層3の保護で絞ります。
GitLab:Claude Code から
Claude Code。ターミナルで実行する(作例。gitlab.com の場合)
claude mcp add -s user --transport http GitLab https://gitlab.com/api/v4/mcp \
--header "X-Gitlab-Enabled-Mcp-Server-Tools: get_work_item,list_work_items,get_merge_request,get_merge_request_diffs,get_repository_file,search"
Self-Managed なら、gitlab.com を自社の GitLab のホスト名に替えます。登録したら claude で Claude Code を開き、チャットで /mcp と打って GitLab のサーバーを選び、ブラウザで承認します。-s user を付けるとどのプロジェクトでも使え、付けないと、コマンドを実行したフォルダだけの local になります。同じ名前の登録が local にあるとそちらが優先され、上書きもされません。claude mcp list で確かめ、claude mcp remove GitLab -s local で消してから足し直します(GitLab Docs「Connect Claude Code」)。
GitLab:Claude Desktop から
claude_desktop_config.json(作例。Node.js 20 以降が要る):GitLab Docs の Windows 向けの例のツール名を、読むツールにしたもの
{
"mcpServers": {
"GitLab": {
"command": "npx",
"args": [
"-y", "mcp-remote", "https://gitlab.com/api/v4/mcp",
"--header", "X-Gitlab-Enabled-Mcp-Server-Tools:${GITLAB_TOOLS}"
],
"env": {
"GITLAB_TOOLS": "get_work_item,list_work_items,get_merge_request,get_merge_request_diffs,get_repository_file,search"
}
}
}
}
Claude Desktop は mcp-remote を挟み、ヘッダーは --header の引数で渡します。Windows では args の中の空白でヘッダーの値が壊れるので、値を環境変数に置き、コロンのあとの空白を外します。初めてつなぐとブラウザが開くので、承認します。mcp-remote の版は固定しないよう書かれています(GitLab Docs)。Claude Desktop では[Settings]→[Connectors]でつないだサーバーを開き、出ているツールを確かめます。Cursor のようにヘッダーを JSON の headers に書けるアプリは、URL と headers を書くだけです。
つながらない・ツールが出ないとき
| 症状 | 見るところ | 直し方 |
|---|---|---|
| GitHub:認証に失敗する | PAT の権限と期限 | Classic の PAT なら repo のスコープ、Fine-grained の PAT なら対象のリポジトリが選ばれ、要る権限が付いているか。期限が切れていないか(GitHub の手引き) |
| GitHub:Claude Desktop でリモートを足せない | つなぎ方 | ローカルの Docker で動かす(本文の層2) |
| GitHub:Claude Desktop で Docker のサーバーがうまく動かない | ほかのアプリ | GitHub の手引きは、相性の問題の報告があり調べているとして、ほかのアプリで試すよう書いている(同じ手引き) |
| GitHub:Docker のイメージを取れない | docker pull ghcr.io/github/github-mcp-server | 古いトークンが残っていることがある。docker logout ghcr.io のあとやり直す(README) |
| GitHub:起動しない | --tools・X-MCP-Tools のツール名 | 名前は完全一致(get_file_contents であって getFileContents ではない)。違う名前があると起動時にエラーになる(README) |
GitHub:古い解説の @modelcontextprotocol/server-github を使っている | 使っている部品 | 2025年4月に非推奨になった。公式の github-mcp-server に替える(GitHub の手引き) |
GitLab:403 Forbidden(19.4 以前は 404 Not Found) | 接続の許可 | GitLab.com はグループの[Allow connection to GitLab]、Self-Managed はインスタンスの許可。管理者は mcp.log の denial_reason で原因を見られる(GitLab Docs「Troubleshooting」19.5 版)。従来の個人用トークンやプロジェクトのトークンでも 403 になる、という記述は開発中の文書(19.6)にある |
GitLab:400 が返る | ツールセットのヘッダー | 知らないツールセットの名前(19.5 から) |
| GitLab:社内の一部の人だけ認証できない | 同じ出口の IP からの登録 | DCR の上限。使い回す OAuth アプリ(本文の層2) |
| GitLab:直したのに古い認証のまま | mcp-remote の認証のキャッシュ | GitLab Docs は、調べるあいだ ~/.mcp-auth/mcp-remote* を消すよう書いている(Troubleshooting) |
最初の接続は、読むツールだけで始める
作例の受注管理なら、まず読むツールだけでつなぎ、ツールの一覧に書き込みのツールが無いことを確かめてから、バグ報告の Issue の整理を読ませてください。書き込みを任せる範囲は、そのあと層2と層3を確かめながら広げます。
作例の受注管理で、任せる範囲を広げる順番
1
読むだけ
- GitHub は X-MCP-Readonly か /readonly
- GitLab は読むツールの名前(19.5 から)
確かめる:ツールの一覧に書き込みのツールが無い
2
コメントと PR(MR)の下書き
- issue_write・add_issue_comment・create_pull_request
- save_note・save_merge_request
確かめる:書き込みはトークンの持ち主の名前で残る
3
マージのツールを残す
- merge_pull_request・accept_merge_request
確かめる:main の保護でレビュー必須。トークンの持ち主が管理者でない
出典:GitHub「Remote GitHub MCP Server」、GitLab Docs「GitLab MCP server tools」、GitHub Docs「保護されたブランチについて」
エディターごとの設定ファイルの置き方はCursor の .cursor/mcp.json の記事に書いています。チームでの MCP の権限設計と運用のルールづくりは、当社のClaude Code 導入支援で一緒に進められます。
仕様と画面の名前は、2026年10月14日に、github/github-mcp-server の README と docs、GitHub Docs、GitLab Docs(19.4 の版と開発中の版)、GitLab のリリースノートで確かめました。19.5 のリリースと、19.5 で入った機能は、2026年10月20日に GitLab のリリースノートと 19.5 の版の GitLab Docs で確かめました。GitLab の MCP サーバーは版ごとにツールと設定が増えているので、自分の版のドキュメントを見てください。
AI活用支援
Claude・ChatGPT・Gemini・Copilotのどれをどの業務に使うかの見極めから、社内のAIチャット環境、権限と情報の扱いの設計、MCPやAPIでの既存システム連携、研修・伴走までを支援します。





