MCP 连接工具与资料
从官方只读文档服务开始,完成连接、调用、来源核对、故障定位与最小权限设计。
已经会使用 AI 工具,希望减少复制资料、连接真实数据来源的读者。
前置知识能使用 Codex CLI 或 Claude Code 中任一工具;理解任务输入、工具权限与资料来源。
一套可复现的官方文档问答流程,附 MCP 配置、证据记录、诊断手册和最小权限方案。
学习前准备什么?
- 支持 MCP 的客户端及其当前配置文档
- OpenAI Docs MCP 等公开官方只读服务
- 用于权限设计的虚构项目,不连接生产数据库或真实客户资料
课程内容免费。第三方 AI 账户、订阅、API、云资源或硬件按实际使用另行计费。具体所需账户、权限及替代方案会在对应课节中说明。
六节课,一个完整成果。
- 交付物
一张角色与数据去向图。
展开本节大纲、练习与验收
学完能做到能画出自己的任务在哪里运行、通过谁读取什么资料。
本节准备准备一个需要读取官方文档的问题。
内容大纲
- 区分协议、具体服务和运行应用
- 理解服务可提供的能力及其权限边界
- 把“做事的方法”和“访问能力”分别标注
动手练习
画出文档问答任务的数据流和信任边界。
交付物一张角色与数据去向图。
验收标准
- 每个外部服务的用途清楚
- 不会把连接等同于获得全部权限
- 交付物
配置步骤、环境版本与连接读回结果。
展开本节大纲、练习与验收
学完能做到能按目标客户端文档添加、列出和验证连接。
本节准备已确认客户端可用,服务地址来自官方页面。
内容大纲
- 检查远程 HTTP 与本地程序服务的区别
- 在 Codex 或 Claude Code 中配置官方文档服务
- 核对作用域、连接状态与可发现能力
动手练习
添加 OpenAI Docs MCP,并保存不含凭据的配置检查记录。
交付物配置步骤、环境版本与连接读回结果。
验收标准
- 配置名称和作用域正确
- 无令牌进入公开配置或日志
- 交付物
问题、调用记录、引用与人工核对表。
展开本节大纲、练习与验收
学完能做到能区分回答来自本次检索还是模型记忆。
本节准备连接已通过检查,准备一个可在官网核对的问题。
内容大纲
- 明确要求先搜索,再读取对应页面
- 查看实际调用与返回资料,定位支持结论的段落
- 处理找不到资料、过时页面及无法访问情况
动手练习
询问一个 Skills 配置问题,给出读取记录和直接官方链接。
交付物问题、调用记录、引用与人工核对表。
验收标准
- 回答由本次读取的页面支持
- 检索失败时明确报告缺口
- 交付物
故障矩阵、诊断记录和恢复步骤。
展开本节大纲、练习与验收
学完能做到能从具体错误判断应检查地址、认证还是工具输入。
本节准备保留已成功的配置与调用,准备可撤销的错误例子。
内容大纲
- 按网络、连接、认证、能力、参数和结果逐层检查
- 设置超时与有限重试,记录有用而脱敏的错误
- 修复一项问题后只重复必要验证
动手练习
在练习配置中模拟错误地址与错误输入,恢复后复测。
交付物故障矩阵、诊断记录和恢复步骤。
验收标准
- 失败原因与证据对应
- 恢复过程没有扩大访问范围
- 交付物
权限清单、数据流、授权条件与停用步骤。
展开本节大纲、练习与验收
学完能做到能说明哪些数据会离开本机,哪些动作需要额外授权。
本节准备准备虚构资料库的读取、创建与删除需求。
内容大纲
- 核对服务运营者、数据范围和身份凭据管理
- 区分只读问答、写入草稿与对外执行
- 设计撤销访问、错误回滚与操作留痕
动手练习
给虚构项目写一份连接权限方案,只演练脱敏数据。
交付物权限清单、数据流、授权条件与停用步骤。
验收标准
- 每项权限有具体任务理由
- 写操作和外部内容不能自行扩大授权
- 交付物
可复现流程说明、三组问答和故障处理手册。
展开本节大纲、练习与验收
学完能做到能在新会话中重复得到可核对的文档结论。
本节准备完成连接、调用、故障与权限练习。
内容大纲
- 将连接能力和可选技能组合为小流程
- 为三类问题设定来源、缺口与停止条件
- 整理启动、诊断、停用及环境差异说明
动手练习
对一组新问题运行流程,由他人核对引用与失败报告。
交付物可复现流程说明、三组问答和故障处理手册。
验收标准
- 接手者能按说明重复执行
- 资料缺失时不会伪装成完整结论
编写正文时核对的官方资料
这些链接是资料入口,不代表本课程操作已完成实机测试。具体版本、命令和账户能力在每节正文发布前重新确认。