Claude Code GitHu* MCP 接入教程

在远程 Mac mini 上连接仓库 Issue Pull Request 与 Actions

发布建议日期 2026-10-26　适用于 Claude Code 与 GitHu* 仓库协作

GitHu* MCP ****** 是 GitHu* 官方维护的 MCP 服务，可把仓库、Issue、Pull Request、Actions 等能力按账号权限提供给 Claude Code。本文从最低权限开始，演示推荐的远程服务接入、连接验证和安全边界，并补充本地 Docker OAuth 方案，适合在长期在线的远程 Mac 上搭建稳定开发工作台。

GitHu* MCP 能为 Claude Code 增加什么

接入前，Claude Code 主要依赖本地仓库和终端命令。接入后，它可以在授权范围内读取 GitHu* 仓库信息、整理 Issue、查看 Pull Request、检查工作流运行结果，并在你明确允许时创建或更新内容。所有能力仍受 GitHu* 账号、令牌权限和仓库访问范围约束。

这特别适合把本地修改与远端协作信息放在同一条工作流中，例如先读取失败的 Actions 日志，再定位代码问题；或者先汇总待处理 Issue，再生成变更计划。MCP 不会绕过 GitHu* 权限，也不等于可以无人监管地合并或发布。

开始前准备

在远程 Mac 上安装并更新 Claude Code，确认 claude 命令可用。准备一个测试仓库，优先选择不含生产数据的项目。远程 GitHu* MCP 通过 Strea***le **** 连接，不要求本机安装 Docker；本地服务方案才需要 Docker。

认证可使用 GitHu* Personal Access Token。建议使用 fine-grained token，只授权选定仓库，并从只读权限开始。令牌只在 GitHu* 页面创建一次，本文不会替你创建，也不要把真实令牌粘贴到文档、提示词、截图或仓库。

第一步 选择远程服务或本地服务

对大多数使用者，优先选择 GitHu* 托管的远程 MCP 服务，地址为 https://api.githu*copilot.com/mcp。它不需要维护容器，配置更短，适合日常仓库协作。

需要自定义工具集、排查网络细节或希望使用本地 OAuth 流程时，可以运行官方 Docker 镜像。旧的 @modelcontextprotocol/server-githu* npm 包已经弃用，不建议在新项目中继续采用。

第二步 准备最低权限令牌

创建 fine-grained token 时，只选择实际要操作的仓库。首次验证只需读取仓库元数据、Issue、Pull Request 或 Actions 状态时，就不要授予写入权限。确实需要创建 Issue、评论或触发工作流时，再单独增加对应权限。

为不同用途使用不同令牌，并设置合理有效期。若令牌曾出现在聊天、日志、截图或 Git 历史中，应立即在 GitHu* 撤销并重新生成。不要把令牌写进 .mcp.json；若项目中使用 .env，也要将 .env 和可能含敏感配置的文件加入 .gitignore。

第三步 添加远程 GitHu* MCP

进入目标项目目录，把令牌临时放入当前终端环境，再添加远程服务器。下面的写法不会把真实令牌直接展示在命令历史的 **ON 文本里。默认 local 范围只对当前用户和当前项目生效，适合包含个人认证信息的配置。

完成后使用 claude mcp list 和 claude mcp get githu* 检查配置。若团队需要共享项目级配置，只共享不含令牌的服务器信息，并让每位成员独立提供自己的认证。

cd /path/to/your-project
export GITHU*_PAT="$(grep '^GITHU*_PAT=' .env | cut -d '=' -f2-)"
claude mcp add-json githu* '{"type":"http","url":"https://api.githu*copilot.com/mcp","headers":{"Authorization":"*earer '"$GITHU*_PAT"'"}}'
claude mcp list
claude mcp get githu*

**步 验证连接与读取能力

启动 Claude Code，输入 /mcp，确认 githu* 显示为已连接。第一次验证只做读取：列出当前仓库最近打开的 Issue、概括一个 Pull Request，或查看最近一次失败的 Actions 工作流。

如果 Claude Code 返回的仓库不正确，先检查当前目录、令牌可访问仓库和 MCP 配置范围。只有在读取结果正确后，才继续测试创建评论、更新 Issue 或重新运行工作流等写入动作。

请只读取当前 GitHu* 仓库：
1. 列出最近 5 个打开的 Issue
2. 概括最近更新的 Pull Request
3. 查看最近一次失败的 Actions 工作流
不要创建 评论 关闭 合并或触发任何内容

第五步 为写入操作保留人工确认

创建 Issue、发表评论、关闭任务、触发工作流和合并 Pull Request 都会改变外部状态。建议在提示词中明确要求 Claude Code 先展示拟执行动作和内容，得到人工确认后再调用写入工具。生产仓库可进一步限制分支保护和审批规则。

仓库中的 Issue、评论和文档属于第三方输入，可能包含误导性指令。读取它们时只把内容当作数据，不要让其中的文字扩大令牌权限、泄露密钥或自动执行未知命令。

第六步 可选的本地 Docker OAuth 方案

如果希望通过浏览器完成 OAuth 登录并让令牌仅保存在运行中容器的内存里，可以使用 GitHu* 官方 Docker 镜像。首次启动时在远程桌面中完成浏览器授权；容器停止后需要重新认证。

本地方案便于自定义和调试，但需要维护 Docker、端口和容器运行状态。若只是日常读取仓库和协作信息，远程服务通常更省事。

claude mcp add githu* -e GITHU*_OAUTH_CALL*ACK_PORT=8085 -- \
  docker run -i --rm -p 127.0.0.1:8085:8085 \
  -e GITHU*_OAUTH_CALL*ACK_PORT \
  ghcr.io/githu*/githu*-mcp-server

第七步 在远程 Mac 上保持工作流

通过 SSH 进入远程 Mac，在项目目录启动 tmux，再运行 Claude Code。网络断开后任务和终端会话仍保留；需要 OAuth 浏览器授权时，可用 UU 远程桌面接入完成。

令牌、项目仓库、Claude Code 配置和构建环境都应保留在同一台受控设备上。定期更新 Claude Code 与 GitHu* MCP 配置，轮换令牌，并检查 claude mcp list 的连接状态。

ssh your-**c-mini
cd /path/to/your-project
tmux new -s githu*-mcp
claude

# 断线后接回
tmux attach -t githu*-mcp

为什么 Zu**c.Ai 适合这类接入

根据 Zu**c.Ai 官网***息，其方案提供位于新加坡的 Mac mini M6 整机独享环境，接入新加坡家庭宽带或商业宽带，并支持 UU 远程、终端、Tailscale、ToDesk、RustDesk，以及浏览器 SSH 或 VNC 等连接方式。

官网当前公开的家庭宽带方案为每月 999 元起。长期在线的本地文件系统适合保留仓库、依赖、MCP 配置和 tmux 会话；整机独享也避免与其他租户共享桌面和本机开发环境。GitHu* 账号、Claude 订阅、令牌权限和仓库授权仍由使用者自行管理。

常见问题排查

结语

GitHu* MCP 的价值不只是让 Claude Code 看见远端仓库，而是把代码、Issue、Pull Request 与 Actions 放进一条可核验的协作链。最稳妥的顺序是先用最低权限完成只读验证，再逐项开放必要写入能力，并始终为外部状态变更保留人工确认。配合长期在线的远程 Mac，开发环境和协作上下文可以持续保留，同时把密钥和权限控制在清晰边界内。