GitHub
Claude Codeに渡せる権限の範囲と、つなぎ方を、公式の資料から読み取れる範囲でまとめました。
← ラボ / Claude Code ガイド / 連携台帳
GitHub・プロジェクト管理・開発・海外 公式サイト
公式MCPリポジトリに「GitHub's official MCP Server」と書かれているとおり、GitHub自身がMCPサーバーを公開している。コマンドラインツール gh(公式マニュアルに「a command-line interface to GitHub for use in your terminal or your scripts」とある)とREST APIも公式に提供されている。
Claude Codeに、どこまで権限を渡せるか
- 読み取り専用で渡せるか あり
- 公式MCPに読み取り専用がある。リモートは URL の末尾に /readonly を付ける(例 https://api.githubcopilot.com/mcp/readonly、toolset単位は /mcp/x/repos/readonly)か、ヘッダー X-MCP-Readonly(「Enables only “read” tools」)。ローカルは --read-only(「Read-only mode takes priority: write tools are skipped」)。https://github.com/github/github-mcp-server/blob/main/docs/remote-server.md
- 権限(スコープ)を選べるか あり
- (調べる係の記載のとおり)fine-grained PATは1つの所有者・選んだリポジトリに限定でき、権限を細かく選べる。MCPはtoolset単位(/mcp/x/{toolset})で絞れる。個々の権限一覧は今回も未読。
- 危険な操作の既定
- 制御の記載なし(README・remote-server.md・tool-renaming.md を読んだ範囲に、確認プロンプトや危険ツールの既定無効の記載なし。READMEのトークン案内は「Only grant necessary permissions」のみ)。ghは引数なしの gh repo delete で確認が入り、--yes で省略できる。
- 削除ができるか できる
- 【MCP】ファイル削除(delete_file:ブランチ上の1ファイル)、コメント・ラベル・レビュー・プロジェクト項目・通知購読などの削除系操作(label_write / discussion_comment_write / pull_request_review_write / projects_write の delete 系メソッド)。リポジトリを削除するツール名は、README(約107,000字を全部は読めず、repos toolsetの一部のみ)・tool-renaming.md・remote-server.md のどれにも見当たらない(create_repository / fork_repository はある)。見当たらないだけで、無いとの記載ではない。【CLI】gh repo delete(delete_repo スコープが必要)ほか。
- 取り消し方(キー・接続)
- PAT:Settings > Developer settings > Personal access tokens > 該当トークンの Delete(公式の記載)。使われていないPATは1年で自動削除。
つなぎ方(公式の資料にある範囲)
公式MCP あり
GitHub公式MCPサーバー。リモート版は https://api.githubcopilot.com/mcp/ 。ローカル版(Docker: ghcr.io/github/github-mcp-server)もある。toolset(actions, code_security, copilot, dependabot, discussions, gists, git, issues, labels, notifications, orgs, projects, pull_requests, repos, secret_protection, security_advisories, stargazers, users など)で機能を絞れる。既定のtoolsetは context, repos, issues, pull_requests, users。README上のツール一覧には、書き込み系(issue_write, create_pull_request, merge_pull_request, actions_run_trigger, projects_write 等)が含まれる(一覧はページ途中までしか読めていない)。
つなぎ方(公式の記載)
公式のClaude向け手順(docs/installation-guides/install-claude.md):Claude Code 2.1.1以降は `claude mcp add-json github '{"type":"http","url":"https://api.githubcopilot.com/mcp","headers":{"Authorization":"Bearer YOUR_GITHUB_PAT"}}'`(取得結果が分割されていたため、2つの断片をつないだ形。実行前に公式ページで文字列を要確認)。2.1.0以前は `claude mcp add --transport http github https://api.githubcopilot.com/mcp -H "Authorization: Bearer YOUR_GITHUB_PAT"`。OAuthは、公式Dockerイメージを使うローカル版で `claude mcp add github -e GITHUB_OAUTH_CALLBACK_PORT=8085 -- docker run -i --rm -p 127.0.0.1:8085:8085 -e GITHUB_OAUTH_CALLBACK_PORT ghcr.io/github/github-mcp-server`(初回にブラウザログイン、トークンはメモリのみ保持)。
公式CLI あり
gh(GitHub CLI)。コマンド群:issue, pr, repo, release, gist, label, discussion, project, ruleset, search, run, workflow, cache, secret, variable, auth, ssh-key, gpg-key, org, codespace, extension, copilot, api など。削除系のサブコマンドもマニュアルに並ぶ(repo delete, release delete, issue delete, gist delete, project delete, codespace delete, secret delete など。ページには動作の説明がなく、名前からの判断)。gh repo delete は「Deletion requires authorization with the `delete_repo` scope」とあり、`--yes` で確認を省略できる(リポジトリ引数なしの場合は --yes が無視され確認が入る)。
公式API あり
GitHub REST API(GraphQLも公式ドキュメントにレート制限の記載がある)。認証はPAT・OAuth・GitHub App。公式のレート制限ページでPAT/OAuthの認証済みユーザーは1時間5,000リクエスト等の数値が示されている。エンドポイント一覧そのものは今回開いていない。
第三者製MCP(公式ではない) 2件
- modelcontextprotocol/servers-archived の GitHub サーバー(src/github、npm @modelcontextprotocol/server-github)(作者: Model Context Protocol プロジェクト(modelcontextprotocol 組織)。GitHub社ではない・最終更新: リポジトリは2025-05-29にアーカイブ(読み取り専用)。保守・セキュリティ更新なしと表示)
書き込み・削除: あり(READMEの書き込み系12ツール: create_or_update_file、push_files、create_repository、create_issue、create_pull_request、fork_repository、create_branch、update_issue、add_issue_comment、create_pull_request_review、merge_pull_request、update_pull_request_branch。削除ツールの記載なし)
READMEは、開発は github/github-mcp-server に移ったと案内。認証はGITHUB_PERSONAL_ACCESS_TOKEN。権限はprivateリポジトリならrepo、公開のみならpublic_repoを推奨と書く。
https://github.com/modelcontextprotocol/servers-archived - cyanheads/github-mcp-server(作者: cyanheads(GitHubユーザー)・最終更新: 未確認(日付表示なし。READMEに「This repository is deprecated」とあり公式サーバーへ誘導))
書き込み・削除: あり(create_repository、create_branch、create_issue、create_pull_request、merge_pull_request、update_pull_request、update_file、create_release に加え、delete_branch の削除ツールあり)
TypeScript製。ブランチ・Issue・PR・ファイル・リリースの管理。GITHUB_TOKEN(PAT)を使う。
https://github.com/cyanheads/github-mcp-server
第三者製のMCPは、サービスの運営元が作ったものではありません。作者と中身を確かめてから使うかどうかを決めてください。ここに載せているのは、公式のレジストリやGitHubで見つかったものを、書かれている範囲でまとめたもので、おすすめではありません。
探した場所(6件)
- WebSearch(github.com / registry.modelcontextprotocol.io を対象にした汎用検索。GitHub向けの第三者製MCPは個別には調べていない)
- https://github.com/modelcontextprotocol/servers-archived
- https://github.com/modelcontextprotocol/servers-archived/blob/main/src/github/README.md
- https://github.com/cyanheads/github-mcp-server
- WebSearch(GitHub MCP server unofficial / GitHub MCP server)
- (公式MCPレジストリは取得エラーで開けず)
できる操作
読み取りでできる操作
- 【MCP】README記載のtoolset(repos, issues, pull_requests, actions, code_security, discussions, notifications, projects など)で、リポジトリ・Issue・PR・Actions・セキュリティ情報などを読める(ツール一覧はページ途中までしか読めていない)
- 【MCP】リモートでは X-MCP-Readonly ヘッダー、または URL /mcp/readonly で「Enables only “read” tools」。ローカルは --read-only / GITHUB_READ_ONLY
- 【CLI】gh issue / pr / repo / run / search / api などで参照できる(コマンド群の列挙のみ確認)
- 【MCP】README後半に get_file_contents, list_branches の記載あり(repos toolset)
書き込みでできる操作
- 【MCP】issue_write, sub_issue_write, add_issue_comment, create_pull_request, merge_pull_request, add_comment_to_pending_review, add_reply_to_pull_request_comment, pull_request_review_write(create, submit, delete), actions_run_trigger(ワークフロー実行), create_gist / update_gist, label_write, projects_write
- 【MCP】assign_copilot_to_issue, request_copilot_review(Copilotへの割り当て・レビュー依頼)
- 【CLI】gh issue / pr / repo / release / workflow などのサブコマンド(具体的な動作はコマンド名のみ確認)
- 【MCP】delete_file(ブランチ上の1ファイルを削除), create_repository, fork_repository(README後半の repos toolset)
管理者操作(削除・課金・設定変更など)
- 【MCP】削除を含む操作:delete_file(ブランチ上の1ファイル)、discussion_comment_write(delete)、label_write(delete)、sub_issue_write(remove)、pull_request_review_write(delete)、projects_write の delete_project_item、通知購読の delete。リポジトリを削除するツールは、README・tool-renaming.md・remote-server.md の読めた範囲に見当たらない(ただし README は約107,000文字で repos toolset の一覧を全部は読めておらず、「ない」とは断定しない)
- 【CLI】repo delete(delete_repo スコープが必要), repo archive, release delete, issue delete, gist delete, secret delete, ssh-key delete など、削除・設定変更系サブコマンドがマニュアルに並ぶ
- 【MCP】README上のトークン推奨スコープは repo / read:packages / read:org。ツールごとの必要スコープとして gist, notifications, security_events, read:project, project, admin:org/write:org なども記載
制限
- 【API】REST:認証済みユーザー(PAT/OAuth/GitHub App)1時間5,000リクエスト、未認証は1時間60リクエスト(IPごと)、GHEC組織所有のGitHub App/OAuth appは15,000/時間、Actionsの GITHUB_TOKEN はリポジトリごとに1,000/時間
- 【API】二次レート制限:同時100リクエストまで(REST・GraphQL共通)、REST 900ポイント/分、GraphQL 2,000ポイント/分、コンテンツ作成は約80件/分・500件/時間。超過時は403または429。レート制限中に送り続けると「may result in the banning of your integration」と記載
- 【MCP】MCP専用のレート制限の記載は読んだページになし(未確認)。Lockdown mode(X-MCP-Lockdown)は公開Issueの内容を一部隠すベストエフォートのフィルターで、セキュリティ境界ではないと記載
- 【MCP】リモートのtoolset:copilot_spaces, github_support_docs_search はリモート限定。Insidersモード(/insiders)で新機能の先行利用
- 【MCP】merge_pull_request・actions_run_trigger・issue_write など、他人に見える/取り消しにくい操作がMCPに含まれる。公式資料に確認プロンプトの記載は見つからなかったので、読み取り専用で渡すなら /mcp/readonly か X-MCP-Readonly を使う(公式の記載)。
- 【CLI】gh repo delete は `delete_repo` スコープが必要で、`gh auth refresh -s delete_repo` で付与する(公式の記載)。リポジトリ引数を付けない場合は --yes が無視され確認が入る。引数を明示した `gh repo delete owner/repo --yes` は確認なしで削除される。
- 【CLI】gh auth login --with-token が受け付けるclassic PATの最低スコープは repo, read:org, gist。fine-grained PATでは「confusing behavior」が起きうるとされる。
- 【API】PATは「Treat your access tokens like passwords」と記載。
認証・料金・日本語・実機検証
- 認証方式
- MCP:OAuth(ローカルDockerイメージ)またはPAT(Authorization: Bearer)。PATを設定するとOAuthより優先。CLI:gh auth login(既定はブラウザ認証)、--with-token、環境変数 GH_TOKEN(fine-grained PATには GH_TOKEN を推奨と記載)。API:PAT/OAuth/GitHub App。
- 公表されている料金(2026年10月16日確認)
- Free:月額0 USD(「per month forever」)。Team:$4 USD per user/month、Enterprise:Starting at $21 USD per user/month。ただしTeam・Enterpriseは「for the first 12 months*」と表示され、*の注記を読めていないため、13か月目以降の価格(基本価格)は未確認。ページはUSD表示のみで円表示なし。Codespacesは従量課金(コンピュート$0.18/時〜、ストレージ$0.07/GB/月)(2026-10-16確認) 料金ページ
- 日本語対応
- あり。GitHub Docs に日本語版がある(https://docs.github.com/ja)。MCPのREADME・ghのマニュアルの日本語版は未確認。
- Claude Code実機検証
- 未検証(この台帳は、動かして確かめた記録ではありません。Akiraが試したときは、検証日つきで書き換えます)
確認できていない点(7件)
- MCP READMEは約107,000文字で、100,000文字以降も開いたが、repos toolset を含むツール一覧は全部は読めていない。リポジトリ削除ツールは README・tool-renaming.md・remote-server.md に見当たらないというだけで、無いとの記載ではない。確認プロンプトの記載も見当たらない。
- Claude Code向け add-json コマンドは取得結果が断片で返ったため、つないだ文字列を公式ページで要確認。
- 料金:Team/Enterpriseの「for the first 12 months*」の注記(13か月目以降の価格)を読めていない。
- GitHub向けの第三者製MCPは個別には探していない。
- MCPのREADMEとghのマニュアルの日本語版は未確認。GitHub Enterprise Server向けの扱い、fine-grained PATの権限一覧(読み取り/書き込みレベル)も開いていない。
- GraphQL APIの仕様・REST APIのエンドポイント一覧は今回開いていない。
- 2026-10-17再確認で残った点: third_party_mcp: 現役で保守されている第三者製は今回見つけられなかった(見つかった2件はいずれもREADME上で公式へ移行/廃止の案内)。公式MCPレジストリは取得エラー
出典(13件)
- github/github-mcp-server README(GitHub)(確認日 2026-10-16)
- Remote server docs(GitHub)(確認日 2026-10-16)
- Install Claude guide(GitHub)(確認日 2026-10-16)
- GitHub CLI manual(GitHub)(確認日 2026-10-16)
- gh auth login(GitHub)(確認日 2026-10-16)
- gh repo delete(GitHub)(確認日 2026-10-16)
- Rate limits for the REST API(GitHub Docs)(確認日 2026-10-16)
- Managing your personal access tokens(GitHub Docs)(確認日 2026-10-16)
- Pricing(GitHub)(確認日 2026-10-16)
- tool-renaming.md(GitHub)(確認日 2026-10-16)
- GitHub Docs(日本語)(確認日 2026-10-16)
- servers-archived(modelcontextprotocol/GitHub)(確認日 2026-10-17)
- cyanheads/github-mcp-server(GitHub)(確認日 2026-10-17)
この台帳は、公式の資料を読んだ範囲のことで、動かして確かめたものではありません。確認日: 2026年10月16日。
ラボの資料は、公式の文書を読んでまとめたもので、実際に使って確かめた記録ではありません。日付や仕様は変わるので、使う前に各ページの出典で確かめてください。事実と「僕らの見立て」は、分けて書いています。