Claude Code GitHu* MCP 接入教程
在远程 Mac mini 上连接仓库 Issue Pull Request 与 Actions
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 包已经弃用，不建议在新项目中继续采用。
| 方案 | 运行位置 | 适合场景 | 主要特点 |
|---|---|---|---|
| 远程 GitHu* MCP | GitHu* 托管 | 多数日常使用 | 无需 Docker，配置简单 |
| 本地 Docker OAuth | 本机容器 | 重视 OAuth 与自定义 | 需维护 Docker 和端口 |
| 本地 Docker PAT | 本机容器 | 已有令牌的离线式部署 | 注意环境变量和容器日志 |
第二步 准备最低权限令牌
创建 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 工作流
不要创建 评论 关闭 合并或触发任何内容| 验收项 | 通过标准 |
|---|---|
| 服务器状态 | /mcp 中 githu* 显示已连接 |
| 仓库范围 | 只能看到令牌明确授权的仓库 |
| 只读测试 | 能列出 Issue 或概括 Pull Request |
| 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* 显示 disconnected | 地址 配置或网络异常 | 用 claude mcp get githu* 检查 **L 与配置范围 |
| 返回 401 或 403 | 令牌失效或权限不足 | 检查有效期 仓库范围和所需权限 |
| 看不到目标仓库 | fine-grained token 未授权该仓库 | 在 GitHu* 调整仓库访问范围后重试 |
| 可以读取但不能评论 | 令牌只有读权限 | 仅在需要时增加对应写权限 |
| Docker OAuth 无法回调 | 端口占用或远程桌面未完成授权 | 检查 8085 端口并在 UU 远程桌面完成登录 |
| 团队成员认证冲突 | 把个人令牌写入共享配置 | 共享无密钥配置 每人独立认证 |
结语
GitHu* MCP 的价值不只是让 Claude Code 看见远端仓库，而是把代码、Issue、Pull Request 与 Actions 放进一条可核验的协作链。最稳妥的顺序是先用最低权限完成只读验证，再逐项开放必要写入能力，并始终为外部状态变更保留人工确认。配合长期在线的远程 Mac，开发环境和协作上下文可以持续保留，同时把密钥和权限控制在清晰边界内。
Claude Code Sentry MCP 接入教程
Claude Code Notion MCP 接入教程
Claude Code Figma MCP 接入教程
KingFlow AI Obsidian Copilot 接入教程
