浏览 MCP与Skills教程与资源
Notion MCP 知识库检索：连接、读取原页与处理冲突版本
用 Notion 官方托管 MCP 查询一套教学退款规则，先读取原页再形成答案，处理权限、搜索降级、正文截断与草稿冲突。
只问一件事：订单取消期限究竟是 7 天还是 14 天
本页只使用 Notion 官方托管地址 https://mcp.notion.com/mcp，通过 OAuth 授权；客户端采用 Claude Code。不要混用旧版自托管 notion-mcp-server 的 integration token 教程。托管服务和旧开源 Server 的认证与工具并不相同。
下面的订单规则是纯教学数据，不代表任何公司的真实退款政策。练习目标是从明确的原页得出一个可追溯结论，遇到未批准草稿时保持不确定，而不是把搜索结果拼成看起来完整的政策。
让版本冲突在原文中就能核对
在你拥有的教学工作区手动新建父页 MCP 练习，再建以下两页。保存各自真实 URL；本例不让 Agent 创建页面，以免把读测试和写授权混在一起。
| 页面标题 | 写入页面的教学正文 | 为何需要这一页 |
|---|---|---|
| 退款规则 v1｜已生效 | 状态：已生效。适用：教学订单。取消期限：下单后 7 天内。责任人：教学管理员。 | 为答案提供明确范围和生效状态 |
| 退款规则 v2｜未批准草稿 | 状态：未批准草稿。拟议取消期限：下单后 14 天内。尚未替代 v1。 | 验证系统是否会把较新页面误当有效规则 |
不要使用真实客户订单、支付凭证或商业条款。若只想复习已有知识库，跳过造样本，但必须由业务负责人指出正式页和草稿页，不能从标题猜。
Claude Code 添加远程地址，再完成 OAuth
授权页确认工作区和账户。连接后的可访问内容取决于这个身份，不会因为提示词写了‘只查 MCP 练习’就自动缩窄服务端权限。仅给测试账号分享练习页，更容易验证范围。
添加 Notion MCP
claude mcp add --transport http notion https://mcp.notion.com/mcp
选择 notion 并按提示授权
/mcp
Notion MCP 也有内容修改工具；本例只允许检索与读取。若账户能访问整个公司工作区，客户端获得的内容访问范围可能远大于本次练习。
先找候选，再读取两份原文，最后回答
先找候选，再读取两份原文，最后回答
只使用 notion 的检索和读取工具，不创建或修改页面。 范围：我的 Notion 工作区中“MCP 练习”下面的两份退款规则。 问题：教学订单现在允许在下单后多少天内取消？ 先搜索“退款规则”，列出候选标题与真实 URL。 再读取“退款规则 v1｜已生效”和“退款规则 v2｜未批准草稿”的原文。 根据原文的状态与适用范围回答，不按最后编辑时间直接选新版。 输出：当前规则、支持它的原句与页面 URL、另一版本为什么不适用。 如果任何原页读不到、正文被截断或状态矛盾，请明确缺口，暂不给确定结论。
预期答案是教学订单 7 天；v2 明确未批准且未替代 v1。只有实际原页含这些信息才能这样回答，不能把本段预期硬套到真实工作区。
有来源链接还不够，要确认真正读到了支持结论的段落
搜索能力可能按账户或套餐变化
官方托管 MCP 的 notion-search 可以提供 AI 搜索或关键词检索；应读当前工具描述和返回的 notices。若某个筛选条件被降级或忽略，结果可能比所请求的范围宽。少搜到一页不等于该页不存在，也不该立即升级权限。对教学样本可直接提供已经保存的页面 URL，再用读取工具核对。
正文截断不能静默忽略
notion-fetch 用 URL 或 ID 读取原页。返回 truncated 或缺失子树提示时，先补读相关子树，再判断是否覆盖规则段落。页面级最后编辑时间只是线索，不能替代‘已生效’‘废止’‘尚未批准’这些实际状态。OpenAI 客户端中工具名称可能显示为 search/fetch，应按当前工具列表识别。
原页文字与模型推论分开
‘v1 写着 7 天’是可引用事实；‘v2 更新更晚所以已替代 v1’是没有批准依据的推论。本例的 v2 明确未生效，因此容易判断；真实文档若都标为有效且适用范围相同，就并列冲突并交责任人确认，不让模型凭日期裁定。
搜索不到、读不到与不能引用分别处理
搜索不返回 v1，但直接 URL 能读
- 原因
- 可能是搜索词、索引或当前检索能力问题；基础页面授权未必有错。
- 怎么改
- 用准确标题重搜，保留 notices 和实际搜索范围；直接读取目标 URL 完成这次窄任务，不声称全知识库已检索。
浏览器能读，MCP 不能读
- 原因
- 授权账户或工作区不同，连接权限、套餐限制或原页访问状态也可能变化。
- 怎么改
- 比对 OAuth 身份、工作区和同一 URL，保留具体错误；不要用另一人的宽权限账号替代来证明成功。
两页链接都有，但答案选择了 14 天
- 原因
- 把新草稿当成当前规则，或只用搜索摘要而未读正文状态。
- 怎么改
- 把答案拆成逐条主张，逐项对照原句；删除没有生效依据的结论。
准备把摘要转发给其他团队
- 原因
- 你能读到的页面不代表收件人也被授权；摘要本身可能泄露原文。
- 怎么改
- 先核对共享对象是否有权获取结论及引用内容，必要时只发送公共版本或由负责人发布的摘要。