让 Claude 基于知识库回答并给每个说法附出处：osFoundry MCP 接入实操

这篇教程演示如何把 osFoundry 知识库通过 MCP 连接到 claude.ai 或 Claude Code，让 Claude 回答客服问题时每个说法都带上文章 ID 和最后更新时间。第二天还能通过事件轮询检查哪些回答已过时，并在版本校验和权限确认的保护下直接修正文章。

接入前的分工

• Claude 侧负责登录、附出处、询问变更、写入前请求权限；osFoundry 侧负责单 workspace 连线、返回文章 ID 与更新时间、维护事件记录、校验版本和编辑权限
• 每次工具调用都会记录在连线的 Recent activity 中，可追溯 Claude 回答前读了哪些文章

五步完成配置

• 在 osFoundry 建立连线（钥匙图标 → Connected → Assistant: Claude），复制服务器地址；claude.ai 中加为自定义连接器，Claude Code 用 claude mcp add --transport http 命令添加，再在 session 内用 /mcp 认证
• 把连线加入知识库所在的项目：钥匙图标 → Connected → 选中连线 → Add to project；知识库不在项目里的话，在其 Settings 的 Project 字段选择项目
• 文章必须在右侧面板 Publishing 分页手动 Publish，草稿不会被 Claude 读到；已发布文章仅供 workspace 内的 AI 助理和搜索使用
• 工具默认全开：search_knowledge_base、read_knowledge_article、poll_resource_events 和 edit_knowledge_article；只要回答不要改内容，就取消勾选编辑工具
• 在 prompt 里明确要求出处格式，例如每个说法后附 [article_id · updated_at]，没有覆盖的文章就直说而不是猜

实际跑一遍的效果

• Claude 先列出项目资源找到知识库，再搜索并读取相关文章，回答中每个说法都带文章 ID 和精确到秒的更新时间
• 第二天在同一对话里问哪些回答过时，Claude 只需记住昨天的事件序号，一次 poll_resource_events 就拿到全部变更，只重读有变动的文章
• 要求修正 FAQ 时，Claude 先重读文章拿到当前版本，再以 expected_version 匹配写入，Claude Code 会弹出权限确认

三个设计细节

• 出处带时间不只是 ID：更新时间说明引用时文章的状态，Claude 才能回答「这还对吗」而无需重读所有旧引用
• 轮询省资源：事件记录是有序的，一次调用返回之后的所有变更
• 编辑指定版本：内容是整份替换，若写入前有人改过文章，expected_version 不符会被拒绝，Claude 需重读后重做；沿用旧出处里的版本是最常见的拒绝原因

权限边界

• 只有已发布文章可被搜索，取消发布后引用它的回答在检查时会找不到内容——什么算答案由 workspace 决定，不是模型
• 未加入连线的知识库无法访问，移除项目或 Revoke connection 后旧 token 也不能继续访问
• 编辑工具被标记为会改动共用内容的写入（destructiveHint: true），Claude Code 会停下来询问；osFoundry 侧每次编辑调用都按核准者的编辑权限执行，且核准不能扩展到整个 session