深度教程·第3期
用 AI 编码工具的人不少。但把 Claude Code 的 MCP 扩展协议配好、真正让 AI 接管日常 PR 审查的，还不多。下面五个步骤，把连接 GitHub、读取代码变更、输出审查意见这件事一次说清。
MCP（Model Context Protocol，模型上下文协议）是 Anthropic 推出的开放标准，让 AI 工具能安全访问外部数据源。配好之后，Claude Code 能直接操作 GitHub 仓库，不用把代码一段段复制进对话框。
这个教程解决什么问题
目标：让 Claude Code 通过 GitHub 官方 MCP 服务器访问仓库，PR 审查从手动贴代码变成一句话触发。审查时，AI 能直接读取 diff、查看文件内容、分析提交历史。
准备什么
开始之前，确认这些东西就位。缺一样后面都会卡住。
Claude Code：已安装并完成登录。如果还没装，到 Anthropic 官方文档查当前推荐方式，npm 全局安装或平台原生安装包都可以。
GitHub 账号：有至少一个需要审查的仓库，私有仓库要能正常登录。
Node.js 环境：GitHub 官方 MCP 服务器通过 npx 启动，需要 Node.js。版本要求以官方 README 为准。
终端：macOS 的 Terminal、Linux 的 shell 或 Windows 的 PowerShell 都行。
步骤一 确认 Claude Code 能正常启动
打开终端，输入 claude 启动。看到交互式提示符，安装就成功了。第一次使用需要绑定 Anthropic 账号，按提示完成登录。登录成功再继续，否则后面配置完成也无法正常调用。
步骤二 创建 GitHub Fine-grained Token
MCP 服务器访问 GitHub 数据，需要一个 PAT（Personal Access Token）。建议选 Fine-grained token，权限粒度更细，能精确到单个仓库和具体操作，比 classic token 安全。
操作路径：GitHub 右上角头像 → Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token。
创建时注意三点：
仓库范围：选 Only select repositories，只勾选需要审查的仓库。不要选全部仓库。
权限勾选：Contents 和 Pull requests 都选 Read-only。只做审查，不需要写入权限。
保存 token：GitHub 只显示一次，创建成功后马上复制到密码管理器。关掉页面后无法再次查看。
Fine-grained token 的仓库范围是最常见的翻车点。创建了 token 但没勾选具体仓库，后面连接会直接报 404。
步骤三 在 Claude Code 中注册 MCP GitHub 服务器
Claude Code 内置 /mcp 命令，用来管理 MCP 服务器。在对话中输入 /mcp，进入配置界面，选择添加服务器。
GitHub 官方 MCP 服务器对应的 npm 包是 @modelcontextprotocol/server-github。这个包由 MCP 官方模型上下文协议组织维护，不是 GitHub 官方账号发布的。用命令行添加时，可以参考这个形式：
claude mcp add github --env GITHUB_PERSONAL_ACCESS_TOKEN=你的token -- npx -y @modelcontextprotocol/server-github
token 作为环境变量传入，不写死在配置文件里。添加完成后，用 /mcp 列表确认 github 服务器已出现，名称和启动命令都显示正常，这步就成功了。以上命令和 --env 用法来自 Anthropic 官方文档中对 MCP 支持的说明。
--env 传进去的 token 会写进 Claude Code 的 MCP 配置，重启后仍然有效。真正会丢的是你用 export 设置的环境变量——那个只活在当前终端会话。
步骤四 验证连接
配置好不等于能用。先做一次最小验证：启动 Claude Code，让它读取一个有权限的仓库。可以直接说：读取仓库 X 的 README 文件。
返回文件内容，连接成功。报认证错误或权限不足，回步骤二检查 token 的仓库范围和权限勾选。报服务器未找到，回步骤三检查注册命令是否执行成功。
步骤五 在 PR 审查中实际使用
连接通过后，在 Claude Code 对话中直接触发审查。例如：查看当前仓库的 PR #123，分析代码变更的潜在问题。
Claude Code 会通过 MCP 调用 GitHub API，获取 PR 的 diff、变更文件列表和相关上下文，再按你的要求输出分析。可以进一步限定方向，比如只看安全相关的风险或性能影响。
完成之后，Claude Code 不再是一个被动问答工具。它变成了能主动访问代码仓库的 AI 助手，PR 审查从复制粘贴变成一句话。
转发给团队里负责 PR 审查的同事。Claude Code 配 MCP 连 GitHub，半天内能把 PR 审查从复制粘贴变成一句话触发。
常见坑
坑一：token 没勾选具体仓库。Fine-grained token 默认不授权任何仓库。创建时跳过仓库选择，后面访问私有仓库会直接失败。解法：重新编辑 token，把目标私有仓库加入授权列表。
坑二：环境变量没持久化。用 export 设置的环境变量，重启后失效。解法：使用 claude mcp add --env 传入，让 token 存入 Claude Code 配置；或把 export 写入 shell 配置文件（.zshrc / .bashrc），让它在每次启动终端时自动生效。
坑三：权限给多了。为了省事给 token 全仓库加写入权限，一旦泄露影响面会扩大。解法：遵守最小权限原则，只读就够，能单仓库就单仓库。
坑四：服务器包版本更新导致行为变化。GitHub 官方 MCP 服务器会持续迭代，偶尔引入破坏性变更。解法：配置突然报错时，先查官方仓库的 release notes，确认是否版本更新引起。
什么人适合，什么人不适合
适合：日常处理大量 PR 的开发者，尤其已经在用 Claude Code 写代码的团队。配置一次，每次审查都受益。希望通过 MCP 把 AI 工作流和 GitHub 深度集成的人，也能从这套流程里学到通用方法。
不适合：不用 Claude Code 的人，这套配置只对 Claude Code 用户有意义。完全不用命令行、习惯纯 Web 操作的人，配置过程会有摩擦。审查需求非常低频的个人项目，手动贴代码可能更快。
如果不用 Claude Code，可以看看其他工具是否支持 MCP。通义灵码、百度 Comate、腾讯云 AI 代码助手等产品都在推进协议能力，具体支持情况以各自官方文档为准。
你日常审查 PR 是手动贴代码还是已经接入了 AI？配置过程卡在哪一步？
#ClaudeCode教程 #MCP配置 #GitHub集成 #PR审查自动化 #AI编程工具