企业知识库 MCP 接入对照清单:只读检索、草稿审核与可审计写入
企业知识库的 MCP 接入,是把知识库通过 Model Context Protocol 向 AI 助手和 Agent 开放结构化检索、读取,并在权限允许时开放创建、更新与发布的一类接口能力。它不同于面向爬虫的 llms.txt / GEO,也不同于知识库内置的 AI 问答窗口。本文对照 2026 年秋季 GitBook、Document360、XWiki、Mintlify 与 Microsoft 的公开说明,给出只读、草稿审核与可审计写入的验收清单。
浏览 5
巴克励步
导语:先分清「能被模型读到」和「能被 Agent 调用」
企业知识库的 MCP 接入,是把知识库通过 Model Context Protocol 向 AI 助手和 Agent 开放结构化检索、读取,并在权限允许时开放创建、更新与发布的一类接口能力。它要回答的不是「站点里有没有一个问答框」,而是:外部助手能否按协议取到该取的那一版内容、写入会不会绕过原有审核,以及这些动作能不能追溯到具体身份。
Model Context Protocol 把自己定义成连接 AI 应用与外部系统的开放标准,官方比喻是 AI 应用的 USB-C:一次接入,可供 Claude、ChatGPT、Cursor 等客户端调用数据源和工具。这和产品手册与 Docs 的 AI 可见性不是同一篇文章——那一篇讨论 llms.txt / GEO,解决的是公开文档能否被爬取和引用;本文假定文档已经发布,要验收的是协议层的检索、权限继承和写入门禁。它也和AI 问答可验证指标、权限模型不同:前者讨论站点内问答的忠实度与拒答,后者讨论给人用的空间 / 页级 / 属性权限。本文讨论的是权限被 Agent 继承之后,还缺哪些门禁。产品定位见支柱文 Baklib Wiki 是什么。
立项里最常见的误会有三个:一是把「已经做了 llms.txt」当成 Agent 已经能结构化调用知识库,爬虫可见性和协议接入不是同一条能力;二是把「Agent 可以改文档」写成效率指标,却没有写清改完默认进入草稿、变更请求还是直接发布;三是给服务账号开了管理员权限,再把 MCP 接到所有同事的助手上,等于把发布权交给了无法逐条审计的共享身份。对照的目的不是给某一家 MCP 打分,而是先写清只读、草稿审核和可审计写入分别要保住什么,再决定对哪些站点、哪些身份开放。
为什么现在要谈:知识库正在被做成 Agent 的工作界面
第一,文档和 Wiki 厂商已经把 MCP 写成正式产品能力,而不只是实验性插件。GitBook 把面向团队的 GitBook MCP 和面向读者的「已发布文档 MCP」拆开:前者让 Claude、ChatGPT、Cursor 等工具创建站点、起草页面和调整结构,默认把改动送进 change request;后者随每个已发布站点自动生成,且只读。Document360 的 MCP 概述(文档更新于 2026 年 11 月 13 日)则把搜索、读取、创建、更新、发布和工作流都做成明确的工具列表,并写明这些操作仍遵循项目既有的版本、语言、可见性和审核规则。
第二,开源与自托管路线把「权限和基础设施仍由你控制」写成卖点。XWiki 在 2026 年 10 月 29 日的 Tech Thursday 上介绍了开源扩展 XWiki MCP Server,11 月 5 日发布培训纪要:Agent 可以检索、阅读页面、取附件、查看历史并处理结构化数据,在相应权限下也可以创建和更新内容;扩展可选、可自托管,不绑定特定模型供应商。纪要建议先从只读和选定文档开始,并写明写入工具默认关闭。
第三,内部知识也被重新包装成「给人看、也给 Agent 用」的同一层。Mintlify 在 2026 年 10 月 29 日宣布 Mintlify Base 进入测试:它与对外的 Mintlify Docs 共用同一套平台、编辑器和 MCP;内置 MCP 供 Claude、ChatGPT、Cursor 或自建 Agent 读取同一知识源,另有 Admin MCP 可编辑页面、调整导航、开 Pull Request 并管理设置。Microsoft 则在 2026 年 10 月 14 日介绍 SharePoint 团队知识库 的 Frontier 预览:Copilot 与 Agent 可以把团队内容编译成互相关联、面向 Agent 的 Markdown 库。这些公告并不构成市场份额,但说明选型问题已经从「要不要接 AI」变成「只读怎么接、写入走哪条审核、身份如何审计」。
先把三种接入面拆开,再谈工具清单
对外只读 MCP、对内可写 MCP,以及站点内置问答,经常被写在同一页「AI 能力」里,验收标准却完全不同。
对外只读面向的是读者侧的助手和编码 Agent:它们查询的应是已经发布、按站点权限可公开或可登录访问的内容。GitBook 明确区分「团队用的 GitBook MCP」和「每个已发布站点自动生成的只读 MCP」,并写大多数团队两者都会用。这一层要和 llms.txt、结构化 Markdown 交付一起看,因为目标都是让外部模型读到正确、当前的公开文档,而不是进入草稿区。
对内可写面向的是文档团队和内部助手:创建页面、改术语、调整目录、推进工作流。GitBook 的默认路径是在分支上工作,先给预览链接,团队审批并合并后才上线;只有当你直接要求且本人拥有发布权限时,Agent 才能直接发布。Document360 把创建、更新、发布、工作流、术语表和评审提醒都做成工具,同时强调 MCP 不会覆盖既有工作流、发布规则和治理控制。XWiki 把写入工具默认关掉,并建议生产环境使用权限受限的专用账号,避免授予脚本、编程或管理员权限。
第三种是站点内的 AI 问答或「由 Copilot 代为整理知识库」。它可能根本不走 MCP。Microsoft 的团队知识库是把邮件、文件和站点内容编译成 Agent 可引用的 Markdown 库,目前面向 Frontier 预览租户,且仅对启用按用量计费的用户开放,预览期计费条款可能在正式发布前调整。它解决的是团队上下文是否被整理,而不是你是否向 Cursor 暴露了一组标准工具。把三种接入面写进同一张需求表,再分别规定:谁可以连、能看到哪一版、能不能写、写完去哪、日志记在谁头上。
对照清单:身份、只读范围、写入门禁与审计
1. 身份是「登录人」还是「共享服务账号」
GitBook 写明:无论 OAuth 还是个人访问令牌,MCP 都以你的 GitBook 身份行事,Agent 不能读写或发布你本人做不到的事,也没有另一套权限模型要单独配置。Document360 使用 OAuth,连接绑定完成授权的那个用户账号,所有交互遵循原有 RBAC;受限或未发布内容仍受原有可见性规则约束,读者账号可以提交文章反馈,但不能使用其他写入工具。它还写明目前不支持机器对机器(M2M)的 client credentials,因此不适合「一个中心服务账号代表一群没有个人账号的读者去取数」;这类场景它建议改用 Ask Eddy AI Public API。
XWiki 的说明更值得单独记一笔:MCP 端点依赖 XWiki 用户权限,并不直接走 Collections 权限体系或外部 JWT 认证路径。若组织原本用 JWT 把外部身份映射到用户和组,不能假定 MCP 自动继承同一条路径,要在接入前用目标账号复验。验收题是:低权限用户连接后,能否读到草稿、隐藏空间或未发布页?管理员令牌有没有被写进共享的桌面助手配置?
2. 只读要先保住「版本、语言和站点范围」
Document360 指出,知识库的结构存在于项目版本、多语言、类目层级和基于角色的可见性中;只通过渲染后的网页消费时,这些结构对程序并不总是显式的。它的搜索工具默认可跨版本,也可以指定版本;取文章时支持多语言,并可读取已发布或草稿版本——因此「只读」本身仍可能读到草稿,关键是账号权限和工具参数,而不是协议名称。检索结果必须遵守已配置的可见性和权限规则。
对外只读 MCP 还应与发布面一致。一源多站时,帮助中心、产品手册和内部门户的可访问范围通常不同;如果 Agent 连到的是未按站点裁剪的整库,就可能把内部流程写进给客户或合作伙伴用的回答。Baklib Wiki 把同一知识按站点发布、按权限交付,这一层决定了 Agent 读到的是哪一个发布面,而不是只决定「接不接协议」。和Wiki-first 与 Search-first 的选型连起来看:先确定知识源和权限边界,再把协议接上去。
3. 写入必须写清默认落点:草稿、变更请求还是正式页
这是 2026 年秋季文档里分歧最大、也最不该含糊的一点。GitBook 把「Agent 做事、团队拍板」写成产品逻辑:Agent 默认在分支上工作,改动进入可预览的 change request,团队审查并手动合并之前不会上线。Document360 允许在同一段对话里搜索、更新、推进审核并发布,但前提是这些步骤仍走项目已配置的审核阶段和角色权限,版本行为与编辑器中一致。XWiki 允许在授权后创建和更新页面、修改结构化对象并管理附件,同时提醒管理员应仔细配置权限,以确保变更能进入审批流程;写入工具默认是关闭的。
Mintlify Base 提供了一个需要单独标注的对照点:Teamspace 以 Git 为后端,因而每笔修改都有历史,但「编辑会自动合并,没有人必须为了更新一页而去开或审 Pull Request」。对习惯文档即代码评审的团队,这与 GitBook 的默认门禁不同。若你的风险控制要求「Agent 不能直接改正式页」,不要只看「有没有 Git」或「有没有 MCP」,要看默认合并策略,以及能否强制把 Agent 写入限制在草稿或变更请求。
4. 审计、专用账号和工具开关
能写,就要能回溯。GitBook 强调 Agent 通过同一套 API 工作,动作会像团队成员的改动一样出现在 GitBook 里,审查可走并排 diff。Document360 提供 MCP 访问的分析看板,用于观察知识库如何被协议访问。XWiki 目前还在探索专门的审计界面,便于管理员查看 Agent 在 Wiki 中的活动——这意味着「正在规划审计界面」不能写成「已经具备完整审计台」;验收时应改问:现有页面历史、权限日志和服务器日志能否回答「谁在何时用哪个工具改了哪一页」。
XWiki 对生产环境的建议可以直接写成检查项:使用权限受限的专用账号;不要把脚本、编程或管理员权限交给 Agent;先关闭写入工具,再按需打开。GitBook 和 Document360 都把能力绑在登录人权限上,因此共享管理员授权等同于共享发布权。对照内容治理里的责任人和审核流:Agent 只是又一个需要被纳入同一条治理链的操作者,而不是治理的替代。
把厂商信号写成对照,而不是功能总分
| 验收项 | 公开文档里已经写清的做法 |
|---|---|
| 协议定位 | MCP 是连接 AI 应用与外部系统的开放标准,见 modelcontextprotocol.io |
| 对外只读 vs 对内可写 | GitBook 把已发布站点的只读 MCP 与团队用 GitBook MCP 拆成两项;Document360 在同一套工具里同时提供检索、写入与发布,但受计划和权限约束 |
| 身份模型 | GitBook、Document360 绑定登录人(OAuth 或个人令牌)并继承原有角色;Document360 目前不支持 M2M;XWiki MCP 依赖 XWiki 用户权限 |
| 默认写入门禁 | GitBook 默认进 change request;Document360 走既有工作流与发布权限;XWiki 写入工具默认关闭;Mintlify Base 的 Teamspace 可自动合并编辑 |
| 部署与计划 | Document360 MCP 用于 Business / Enterprise,且仅项目 Owner 或 Admin 可开关;XWiki 扩展可选、可自托管;Mintlify Base 与 SharePoint 知识库仍为测试或预览 |
| 与可见性、问答的关系 | 只读 MCP 常与公开文档交付一起使用;站点内问答和「由 Copilot 编译知识库」可以不走 MCP,应分开验收 |
上表只记录各厂商已经公开的表述,不代表功能完整性评分,也不推断未在文档中出现的能力。SharePoint 团队知识库还给出了一组内部测试数据:Microsoft 写明,在 2026 年 10 月的内部测试中,使用该知识库检索和执行团队任务时,Agent 的响应最快可达约 4 倍、token 效率提高约 30%。这是厂商内部结果,不能当成跨产品基准。Mintlify 则称,在其所托管的文档上,Agent 已占超过四分之三的流量;并在一项与大型工程团队、使用 Claude Code 处理单体仓库的对照实验中称,结构化 Markdown 大约只用一半 token,且使 Agent 精确度提高 64%。这些数字可以说明「文档正在变成 Agent 流量入口」,但选型仍应回到你自己的发布面、权限模型和审核门禁。
落地时先验收五件事
第一,画一张接入图,而不是先挑客户端。标明哪些 Agent 只查询对外手册,哪些助手为内部团队改稿,哪些场景其实只需要站点内问答。需要公开可发现性的,继续走llms.txt / GEO 清单;需要外部工具按协议取数或改稿的,再开 MCP。
第二,用三个身份做一次越权复现:读者或只读成员、普通编辑、管理员。检查草稿、未发布版本、内部空间和已发布页分别能否被检索和读取。这一步直接复用权限模型对照里的空间 / 页级 / 外部共享口径,只是操作者换成了连着 MCP 的助手。
第三,若开放写入,先规定默认落点。能接受的最低标准是:Agent 的修改进入草稿或变更请求,正式发布仍要由有权限的人确认;页面历史里能看到这次修改。不允许的是:共享管理员令牌、写入工具对所有客户端默认打开、以及「有 Git 后端」被误写成已经有人工评审。
第四,把日志问句写进验收单。至少要能回答:哪个账号、在什么时间、用了哪一类工具、读了或改了哪篇、是否进入审核、是否最终发布。如果厂商还没有专门的 Agent 审计台,就明确退回到页面历史、工作流记录和访问日志,不要把「即将提供」写成已经具备。
第五,让发布面决定 Agent 的上下文边界。产品手册、帮助中心和内部门户不应当共享一个未加裁剪的「全能知识源」。Baklib Wiki 的一源多站、权限交付和 AI 检索,适合作为这道边界的实现方式:同一知识按站点发布,Agent 只看到该站点允许它看到的那一版,而不是把内部讨论和对外说明混在一次检索里。
MCP 不会自动提高文档质量,它只会放大当前发布和权限设计的结果。源是准的、权限是清楚的、审核是关着的,Agent 才能成为可管理的接口;源是过期的、权限是共享管理员的,协议只会让错误答案和错误发布来得更快。
想要了解更多?
数字内容新基建白皮书
常见问题
MCP 和 llms.txt / GEO 是一回事吗?
不是。llms.txt 和 GEO 解决的是公开文档能否被模型爬取、引用和摘要,验收重点在可发现性;MCP 是 AI 应用连接外部系统的开放协议,验收重点在检索、读取,以及写入是否仍走原有权限与审核。面向对外文档站,两者常常要一起做,但不能互相替代。公开文档的可见性清单见产品手册与 Docs AI 可见性。
给 Agent 打开写入,是不是就可以绕过审核直接发布?
不一定,而且这正是要先验收的门禁。GitBook 写明:默认改动落在 change request,团队预览并手动合并之前不会上线,只有当你明确要求且本人有发布权限时,Agent 才能直接发布。Document360 则强调 MCP 不会覆盖既有工作流、发布规则和治理控制。选型时不要只问「能不能写」,要问「写完默认去哪、谁能合并、发布是否仍要权限」。
Agent 能不能看到比当前登录人更多的内容?
按目前几家公开文档,不应该。GitBook MCP 以登录人的身份行事,Agent 不能读写或发布你本人做不到的事;Document360 的连接绑定完成 OAuth 的那个账号,并遵循原有 RBAC 与可见性规则;XWiki 的 MCP 端点也依赖 XWiki 用户权限。验收时要用低权限账号复现:草稿、受限空间和未发布页不应被越权读出。
应该先开只读,还是直接开读写?
更稳妥的是先开只读。XWiki 在培训纪要里建议先对选定文档给只读权限,试检索、看历史和摘要,再逐步打开更多工具;它还写明写入工具默认关闭,生产环境应使用权限受限的专用账号,避免把脚本、编程或管理员权限交给 Agent。内部知识若允许 Agent 直接改正式页,还要单独验收版本历史和回滚。
知识库里已经有 AI 问答了,还需要 MCP 吗?
要看 Agent 在哪里工作。内置问答解决的是读者在站点里提问,验收看忠实度、引用覆盖和拒答,见AI 问答可验证指标。MCP 解决的是 Cursor、Claude、ChatGPT 等外部助手能否按协议检索同一知识,以及改稿是否仍受权限与审核约束。两个入口服务的是不同工作流,指标也不应混用。
相关产品
术语
相关阅读
- Baklib Wiki 是什么:企业知识资产发布、权限交付与 AI 检索平台选型指南
- 产品手册与 Docs AI 可见性:协作 Wiki 到可发布文档站的 llms.txt / GEO 清单
- 企业知识库 AI 问答可验证指标:忠实度、引用覆盖与拒答对照清单
- 企业知识库权限模型:空间 / 页级 / 属性权限、SSO/SCIM 与外部共享对照清单
- Wiki-first vs Search-first:企业知识库 AI 选型与权限可验清单
- 企业知识库内容治理:责任人、审核流、过期策略与新鲜度指标对照清单
- 如何优化知识库以适配AI:最佳实践与建议
- 大语言模型代理:知识管理的下一波浪潮
- Wiki 知识库
- Wiki 对外发布 · 知识库内容分发