MCP中文文档
从你要完成的事开始:第一次接触 MCP、动手开发、接入运行,还是核对版本与查询参考。每一段先给出该读的第一页,再列出随后的页面,全部对应当前协议版本 2026-07-28。
第一次动手写服务端?第一个 MCP 服务端用 12 行代码跑通启动、列出工具、add(2,3) 与缺参恢复,全程不需要密钥或大模型。
正在核对版本,或要把客户端、服务器在两个版本之间迁移?见协议与版本章节的版本规则与修订矩阵,逐条迁移步骤见跨协议时代迁移。
三个角色先分清:Host 是驱动会话的应用程序,比如一个 IDE 或聊天客户端;Client 是 Host 里为每个服务器维持连接、收发协议消息的组件;Server 是对外提供工具、资源和提示词的服务进程。一次工具调用的边界也就清楚了——模型从 tools/list 的结果里选择工具,Host 决定授权,Client 把 tools/call 发给对应的 Server,Server 执行并在结果里返回内容;Server 不会因建立 MCP 连接而自动获得 Host 的完整上下文;实际可见内容取决于 Host 经协议显式提供的信息与授权。角色与消息的完整定义见架构与角色,工具一层的字段与错误通道见MCP 工具详解。
开始使用
MCP 是什么、宿主、客户端与服务器如何协作,以及从哪一页开始读。
开发 MCP
实现一个服务器或客户端,选择一种 SDK,并用 Agent Skills 扩展能力。
接入与运维
连接本地与远程服务器,配置授权与安全边界,并排查运行中的问题。
- 连接本地服务器
- 连接远程服务器
- 配置 OAuth 2.1 授权
- 本地服务器安全默认值
- 上线前安全检查
- 大规模宿主应用实践
- 排查连接与调用问题
- Inspector:交互式测试服务器
- Inspector CLI:脚本化检查与 CI
- Inspector 配方:传输、Docker、导入配置
- Inspector 实测:可复现调用与故障诊断
协议与版本
先读版本协商规则,再看 2026-07-28 的变更与弃用项,并确认各客户端对扩展的支持。
参考资料
查概念定义、客户端能力矩阵、生产环境检查表,以及 Registry 发布流程。
- 工具与 Registry 总览
- 生产环境检查表
- 客户端能力矩阵
- 工具:定义与版本差异
- 资源:定义与版本差异
- 提示:定义与取舍
- 采样:服务器请求客户端调用模型(自 2026-07-28 起弃用)
- 当前传输:stdio 与 Streamable HTTP
- 发布服务器到 Registry
- 官方 SEP 状态索引
- SEP 影响与方法生命周期导读
- 常见问题:版本、授权与故障处理
Skills 与参考服务器更新
- 准备采用远程 Agent Skills:先读 FastMCP 4.2 与 Skills over MCP,核对 API 迁移、文件校验和宿主支持边界,再查 Skills 规范。
- 正在使用 Filesystem、Git 或 Fetch:按 11 月安全更新识别宿主实际启动的包并升级。
官方来源
需要核对原文措辞、查看历史版本或提案状态时,进入下列官方资料;中文页为社区译文,以英文原文为准据。