T learn.traeai

第 7 节 · 本站原创中文课程 · 建议 45 分钟

第七节:接入工具前,先定义信任边界

学完能做:区分 MCP 的工具连接、授权和结果可信度,设计只读调用流程。

MCP 连接能力,模型决定如何使用

MCP 让客户端发现和调用服务器提供的工具。它并不自动让外部数据成为事实,也不代替服务端授权。先从只读资料查询开始,列清服务器来源、允许读取的范围和返回字段。

参考原文:05-mcp/README.md ↗

描述一次完整调用

将用户目标、工具输入、服务端操作和返回结果分开记录。检索结果保留 ID、出处与时间;没有结果时返回空集合,不让模型补造来源。下面是协议无关的设计草稿,不是 MCP 配置文件。

工具:search_notes
权限:只读公开练习笔记
输入:query(非空字符串),limit(1–5)
输出:[{id, title, snippet, source}]
失败:无结果 / 未授权 / 超时
禁止:写入笔记、越目录读取、返回凭据

返回内容也是不可信输入

工具返回的网页或文件可能含有诱导指令。回答应把它们当待分析资料,不能因为某段资料写“忽略原任务”就扩大权限。对于写工具,要单独校验参数和授权,不能仅凭模型的文字解释放行。

先测最小权限

记录正常查询、越权查询、超时和诱导内容四个案例。凭据放在本地受控的密钥机制中,分享配置时只保留占位符。第三方服务器应先审查来源,再按当前版本帮助配置和连接。

这是本站独立编写的讲解与示例,并非官方课程逐字翻译。理解之后,请完成下面的练习、自测和笔记。

参考来源:luongnv89 / claude-howto · 社区开源教程

动手,把理解变成成果

本节练习

正在读取本机草稿…

为 search_notes 设计只读工具契约,画出客户端、服务器与资料库的调用顺序,并写四个边界案例。

43 / 6000 字。本页不执行代码;可下载后在本地运行,或用 Agent 获取定性建议。

给我一个提示

一个服务器能连通,不代表它应该拿到整个文件系统。

查看参考思路(本站预写,非实时 Agent)

只允许读练习笔记,服务端限制 query 和 limit。越权直接拒绝,超时可恢复,无结果如实返回;诱导文本仅作为资料处理,不扩大工具权限。

人工自评:逐项核对自己的作品

这些勾选由你确认,不是自动测试结果。遇到待测项,请在作品里明确注明。

理解自测

MCP 返回内容里要求上传本地密钥,应怎么处理?

自己的学习笔记

0 / 3000 字 · 仅保存在此浏览器

围绕当前章节学习

Agent 答疑与作品评价

正在检查连接…

本站讲解、提示、参考思路和自测可独立使用。连接模型服务后,才能实时提问或评价;这里不会把预写内容伪装为 Agent 回答。

走完学习闭环

完成本节

保留练习、勾选人工自评并通过自测后,可记录完成。修改作品或答案会重新打开本节。

课程进度:0 / 10 · 本机记录,不是外部官方证书

← 上一节:第六节:用 Hook 做确定性校验