COURSE 06 / 工作流扩展

MCP 连接工具与资料

从官方只读文档服务开始,完成连接、调用、来源核对、故障定位与最小权限设计。

进阶入门6 节0 节正文已发布免费课程
查看第一节大纲 ↗
适合谁

已经会使用 AI 工具,希望减少复制资料、连接真实数据来源的读者。

前置知识

能使用 Codex CLI 或 Claude Code 中任一工具;理解任务输入、工具权限与资料来源。

贯穿项目

一套可复现的官方文档问答流程,附 MCP 配置、证据记录、诊断手册和最小权限方案。

学习前准备什么?
  • 支持 MCP 的客户端及其当前配置文档
  • OpenAI Docs MCP 等公开官方只读服务
  • 用于权限设计的虚构项目,不连接生产数据库或真实客户资料

课程内容免费。第三方 AI 账户、订阅、API、云资源或硬件按实际使用另行计费。具体所需账户、权限及替代方案会在对应课节中说明。

THE SYLLABUS

六节课,一个完整成果。

大纲已就绪,正文逐节补充
  1. 06.1
    大纲已就绪 · 正文待编写

    分清宿主、客户端、服务端与 Skill

    能画出自己的任务在哪里运行、通过谁读取什么资料。

    ↗
    交付物

    一张角色与数据去向图。

    展开本节大纲、练习与验收
    学完能做到

    能画出自己的任务在哪里运行、通过谁读取什么资料。

    本节准备

    准备一个需要读取官方文档的问题。

    内容大纲

    1. 区分协议、具体服务和运行应用
    2. 理解服务可提供的能力及其权限边界
    3. 把“做事的方法”和“访问能力”分别标注

    动手练习

    画出文档问答任务的数据流和信任边界。

    交付物

    一张角色与数据去向图。

    验收标准

    • 每个外部服务的用途清楚
    • 不会把连接等同于获得全部权限
  2. 06.2
    大纲已就绪 · 正文待编写

    接入第一个官方只读文档服务

    能按目标客户端文档添加、列出和验证连接。

    ↗
    交付物

    配置步骤、环境版本与连接读回结果。

    展开本节大纲、练习与验收
    学完能做到

    能按目标客户端文档添加、列出和验证连接。

    本节准备

    已确认客户端可用,服务地址来自官方页面。

    内容大纲

    1. 检查远程 HTTP 与本地程序服务的区别
    2. 在 Codex 或 Claude Code 中配置官方文档服务
    3. 核对作用域、连接状态与可发现能力

    动手练习

    添加 OpenAI Docs MCP,并保存不含凭据的配置检查记录。

    交付物

    配置步骤、环境版本与连接读回结果。

    验收标准

    • 配置名称和作用域正确
    • 无令牌进入公开配置或日志

    现有预习资料

    以下是独立短教程,可先阅读;不计作本节系统课正文。

    把官方文档接进 Codex 与 Claude Code ↗
  3. 06.3
    大纲已就绪 · 正文待编写

    完成一次有证据的工具调用

    能区分回答来自本次检索还是模型记忆。

    ↗
    交付物

    问题、调用记录、引用与人工核对表。

    展开本节大纲、练习与验收
    学完能做到

    能区分回答来自本次检索还是模型记忆。

    本节准备

    连接已通过检查,准备一个可在官网核对的问题。

    内容大纲

    1. 明确要求先搜索,再读取对应页面
    2. 查看实际调用与返回资料,定位支持结论的段落
    3. 处理找不到资料、过时页面及无法访问情况

    动手练习

    询问一个 Skills 配置问题,给出读取记录和直接官方链接。

    交付物

    问题、调用记录、引用与人工核对表。

    验收标准

    • 回答由本次读取的页面支持
    • 检索失败时明确报告缺口
  4. 06.4
    大纲已就绪 · 正文待编写

    按层定位连接与调用故障

    能从具体错误判断应检查地址、认证还是工具输入。

    ↗
    交付物

    故障矩阵、诊断记录和恢复步骤。

    展开本节大纲、练习与验收
    学完能做到

    能从具体错误判断应检查地址、认证还是工具输入。

    本节准备

    保留已成功的配置与调用,准备可撤销的错误例子。

    内容大纲

    1. 按网络、连接、认证、能力、参数和结果逐层检查
    2. 设置超时与有限重试,记录有用而脱敏的错误
    3. 修复一项问题后只重复必要验证

    动手练习

    在练习配置中模拟错误地址与错误输入,恢复后复测。

    交付物

    故障矩阵、诊断记录和恢复步骤。

    验收标准

    • 失败原因与证据对应
    • 恢复过程没有扩大访问范围
  5. 06.5
    大纲已就绪 · 正文待编写

    为私有资料连接设计最小权限

    能说明哪些数据会离开本机,哪些动作需要额外授权。

    ↗
    交付物

    权限清单、数据流、授权条件与停用步骤。

    展开本节大纲、练习与验收
    学完能做到

    能说明哪些数据会离开本机,哪些动作需要额外授权。

    本节准备

    准备虚构资料库的读取、创建与删除需求。

    内容大纲

    1. 核对服务运营者、数据范围和身份凭据管理
    2. 区分只读问答、写入草稿与对外执行
    3. 设计撤销访问、错误回滚与操作留痕

    动手练习

    给虚构项目写一份连接权限方案,只演练脱敏数据。

    交付物

    权限清单、数据流、授权条件与停用步骤。

    验收标准

    • 每项权限有具体任务理由
    • 写操作和外部内容不能自行扩大授权
  6. 06.6
    大纲已就绪 · 正文待编写

    结课实战:交付一套文档问答流程

    能在新会话中重复得到可核对的文档结论。

    ↗
    交付物

    可复现流程说明、三组问答和故障处理手册。

    展开本节大纲、练习与验收
    学完能做到

    能在新会话中重复得到可核对的文档结论。

    本节准备

    完成连接、调用、故障与权限练习。

    内容大纲

    1. 将连接能力和可选技能组合为小流程
    2. 为三类问题设定来源、缺口与停止条件
    3. 整理启动、诊断、停用及环境差异说明

    动手练习

    对一组新问题运行流程,由他人核对引用与失败报告。

    交付物

    可复现流程说明、三组问答和故障处理手册。

    验收标准

    • 接手者能按说明重复执行
    • 资料缺失时不会伪装成完整结论

编写正文时核对的官方资料

这些链接是资料入口,不代表本课程操作已完成实机测试。具体版本、命令和账户能力在每节正文发布前重新确认。

需要补充前置知识?

按自身基础选择,不要求购买工具或依次学完所有课程。