MCP 三连通是什么
Claude Code MCP 指通过 MCP 协议，把 GitHub（需求与 issue）、CodeGraph（仓库结构与影响面）、API（环境与真实数据）接到 Claude Code 里，让 Agent 在写代码时同时看见「要做什么、改哪里、对不对」——我们把它叫做三连通。
本篇是 Cloud Mac AI Stack 里 MCP 主题的总览页：用架构图帮你建立整体印象，再按你的任务跳到安装教程、原理说明或 CodeGraph 专题。具体命令与排错在专题文里；若你刚读完 L2，上一篇是内存排班。
为什么拆成多篇，而不是一篇写到底
读 MCP 的人处境不同：有人此刻只想把环境配通；有人想先弄明白「为什么要同时接 GitHub 和 CodeGraph」；还有人最关心 token 和权限能不能收拢。若把安装步骤、原理和权限清单全塞进一篇，急着复制配置的人要在长文里来回翻，想先建立整体认识的人又会被大段 mcpServers 和排错清单打断思路。
因此我们按任务拆开写：本篇用一张图帮你看清三连通各自干什么；要动手时打开安装教程；需要和团队讲清设计时再看架构说明。你可以把本篇当作 MCP 三连通的入口——从这儿进对应专题即可。
本篇在系列里负责什么
可以把本篇想成 MCP 三连通系列的目录页：先在这里看清各块分工，再进入对应专题动手或深读。它不负责替你执行安装，也不替代 CodeGraph 部署文或 Runner 配置文。
本篇不会展开的内容：
- 逐步安装 Claude Code MCP（没有复制粘贴的命令清单）
- 长篇架构推导与 Context Engineering 理论
- 单独部署、运维 CodeGraph（见 CodeGraph 五分钟专题）
本篇会帮你做的：根据你的目标或报错症状，指向该读的下一篇文章（安装、架构、图谱、Runner、运行环境或权限专题）。
别在这里找：该去哪篇
如果你要的是下表左列的内容，请直接点「去看」——避免在总览页里翻找具体步骤。
| 你可能在找… | 本篇没有 | 去看 |
|---|---|---|
安装命令、mcpServers 配置示例 |
无逐步教程 | 安装教程 |
~/.claude.json 完整示例、GitHub PAT 怎么填 |
无配置文件正文 | 安装教程 |
MCP 工具报错、codegraph_impact 为空 |
无排错步骤 | 安装教程 · 或查 问题对照表 |
| Context → Diff → Fact 为什么这样分层 | 无原理长文 | 架构说明 |
| push 后 CI 绿勾、Runner 怎么注册 | 不属于 MCP 安装篇 | GitHub Runner 专题 |
快速导航：下一步读哪篇
按你的目标选一篇专题即可；下文还有按场景、按报错的更细对照。
| 我想… | 去读 | 里面有什么 |
|---|---|---|
| 把 MCP 装通、能在对话里用 | 安装教程 | 配置 · 验证 · 常见报错 |
| 搞懂为什么要接 GitHub / 图谱 / API | 架构说明 | 分层 · 工作流 · 设计取舍 |
| 只部署仓库图谱（CodeGraph） | CodeGraph 五分钟 | 图谱 MCP 单点接入 |
| 收紧 token、只读 API、权限边界 | 权限专题 | 最小权限 · 环境隔离 |
需要 push 后的 CI 绿勾？请看 GitHub Runner 专题。机器合盖就断、索引失效？见 Cloud Mac 与本地 Mac 怎么选。
你想完成哪件事
很多人用不同关键词搜到 MCP，但目的通常落在下面四类。选对类型，少绕路。
① 先把环境配起来
例如：Claude Code MCP setup、install MCP server、configure GitHub MCP、connect Claude Code to GitHub
目标：跑通工具链，在 Claude Code 里能看到 mcp__* 工具。
建议阅读：安装教程
② 先搞懂整体设计
例如：MCP architecture explained、Context Diff Fact、why MCP needed
目标：理解系统怎么分层，方便跟团队对齐。
建议阅读：架构说明
③ 只要仓库图谱 / 影响面分析
例如：CodeGraph MCP、codegraph_impact、repo graph Claude Code
目标：先接图谱，暂不接 GitHub issue 流。
建议阅读：CodeGraph 五分钟；以后要三连通再回到 安装教程
④ 关心权限与安全
例如：MCP permissions、token scope、read-only API MCP
目标：控制 token 范围、隔离可写工具、staging 只读。
建议阅读：权限专题；想先跑通最小配置，可先按 安装教程 接上再收紧
还不确定？用上方 快速导航，或下文的 问题对照表 按现象找文章。
常见场景：从这里点进去
同一套三连通，不同人切入点不同——按你的情况选链接即可。
- 第一次用 MCP：先看完本篇架构图 → 安装教程
- CodeGraph 已经有了，只想接 GitHub → 安装教程 里的 GitHub 章节；图谱仍看 CodeGraph 五分钟
- 在做 CI，push 后要绿勾 → GitHub Runner 专题；MCP 和 Runner 的分工 → 架构说明
- 在收紧 token / 环境变量 / 只读 API → 权限专题
- 装上了但工具不出现、不好用 → 安装教程 · 排错
- 暂时不想装，只想看懂架构 → 架构说明
遇到问题？先对一下表
下面按你看到的症状列出最该打开的文章。根因分析与具体命令在专题文里，这里只做指路。
| 你遇到的问题 | 通常涉及 | 建议阅读 |
|---|---|---|
Claude Code 看不到 GitHub issue / 无 mcp__github__* |
GitHub 上下文未接入 | 安装教程 |
codegraph_impact 为空 / MCP tools 列表没有 CodeGraph |
图谱索引或工作目录 | 安装教程 · 或 CodeGraph 五分钟 |
| 改完代码但 CI 不过 / 无 Checks 绿勾 | CI / 检查结果 | GitHub Runner 专题 |
| 不知道改哪些文件 / Agent 全库 grep | 缺少代码上下文 | CodeGraph 五分钟 → 安装教程 |
| staging / API 返回与预期不符、猜 .env | 环境与真实数据（API） | 架构说明 · 接入步骤见 安装教程 |
| 装好后 MCP 仍不可用 | 配置与排错 | 安装教程 |
| 笔记本合盖后 MCP 断、索引失效 | 运行环境（本机 / 云端） | Cloud Mac 与本地 Mac 怎么选 |
| MCP 权限过大 / token 暴露 / 可写 API 风险 | 权限与安全 | 权限专题 |
| 能不能不用 Runner 只用 MCP？ | MCP 与 CI 的分工 | 架构说明 + Runner 专题 |
三种常见读法
第一次接触 MCP
打开 Claude Code → 先读本篇（看清三连通）→ 跟 安装教程 配好 mcpServers 并在对话里确认工具出现 → 若要 push 后自动检查，再加 GitHub Runner 专题。
图谱已经有了，只补 GitHub
已做完 CodeGraph 五分钟 → 回本篇确认 GitHub 在整体里的位置 → 在 安装教程 里只接 GitHub MCP → 用 issue 驱动开发；需要讲清边界时再读 架构说明。
团队要上 AI 辅助 CI
本篇总览 → 安装教程 → Runner 专题（自动化检查）→ 架构说明（6/7）→ 权限专题（收紧 token）。
一张图看懂分工
GitHub = intent CodeGraph = context API = truth Claude Code = diff Runner = fact
常见问题
| 问题 | 去看 |
|---|---|
| 装好了但 MCP 不工作？ | 安装教程 |
codegraph_impact 为什么是空的？ |
安装教程 |
| 可以只用 MCP、不用 GitHub Runner 吗？ | 架构说明 |
| 怎么把 GitHub 接到 Claude Code？ | 安装教程 |
| MCP 整体架构怎么理解？ | 架构说明 |
| token 权限怎么收紧？ | 权限专题 |
收藏本篇，方便以后从总览跳进安装或架构专题。英文版同主题：claude-code-mcp-github-files-api-chain。