Claude Code 使用手册 · 第 6 章 MCP 扩展

Claude Code 使用手册 · 第 6 章 MCP 扩展

章节摘要:MCP(Model Context Protocol)是 Claude Code 访问外部工具、API 与实时数据的标准化协议——与记忆(存静态偏好)不同,MCP 提供的是对动态变化数据的实时访问。架构三部分:Claude → MCP Server → 外部服务。传输方式:HTTP(推荐)、stdio(本地进程)、SSE(已弃用)。配置三作用域:local(默认,仅你)/project(.mcp.json,随仓库共享)/user(跨项目)。CLI 命令族:claude mcp add/list/get/remove/login。工具以 /mcp__服务器__工具 形式调用,权限按 mcp__github 三档授予。本章共 3 节。

解剖坐标

一句话主线:理解"实时数据"定位 → 选对传输方式 → 掌握三种配置途径 → 用权限与排查把 MCP 用稳。

学习目标

阅读完本章,你应当能够:

1. 说出 MCP 架构三部分,以及"什么时候用 MCP、什么时候用记忆"的决策规则。
2. 区分 HTTP/stdio/SSE 三种传输方式与适用场景(含 Windows 的 cmd /c 特例)。
3. 用 CLI 添加/列出/移除 MCP 服务器,并说出 local/project/user 三作用域的区别。
4. 读懂 .mcp.json 与 ${VAR:-default} 环境变量展开语法。
5. 说出工具权限三档的授予方法,以及 /mcp__server__prompt、@ 资源引用的用法。

子章节导航

01 MCP架构与传输方式

MCP 的本质定位(实时数据 vs 记忆的静态偏好);架构三部分与生态;决策矩阵;HTTP(推荐)/stdio(本地)/SSE(弃用);CLAUDE_PROJECT_DIR 注入;Windows 特例。

02 配置管理:CLI、作用域与JSON

claude mcp add/list/get/remove/login/logout;三作用域(local/project/user)与 .mcp.json;环境变量展开 ${VAR} 与 ${VAR:-default};OAuth 2.0 认证;claude mcp serve 反向接线。

03 权限、Prompts与进阶用法

工具权限三档(mcp__github 语法);MCP Prompts 变斜杠命令(/mcp__server__prompt);@server:resource 资源引用;动态工具更新与工具搜索;输出限制;上下文膨胀与代码执行方案;故障排查与安全最佳实践。

前置知识与后续延伸

前置知识:第 3 章记忆系统(MCP 与记忆是"实时 vs 静态"的互补关系)。

后续延伸:第 7 章 Hooks 的 mcp_tool 事件(工具调用前后挂钩子)、第 8 章插件(插件可自带 MCP 服务器)。