3.5.7 知识库 MCP
MCP（Model Context Protocol）是 AI 客户端调用外部工具的标准协议。知识库内置了一个 MCP 服务器：Claude Desktop、Cursor 等任何支持 MCP 的客户端，都能用一段配置接进来，直接检索这个知识库——不需要把文档导出、也不需要做一个专门的应用。
每个知识库的 MCP 页展示它专属的接入信息：
服务地址与鉴权
- 服务地址：
{平台对外地址}/api/external/wiki/{知识库ID}/mcp，Streamable HTTP 传输、无状态，可直接放进任何 MCP 客户端配置； - 鉴权：请求必须携带勾选了「知识库 MCP」范围的应用接入 key，两种头皆可：
Authorization: Bearer <key>或x-api-key: <key>； - key 的创建与范围勾选见 3.10 应用接入。范围随时可收窄，立即生效；key 归属团队决定可访问的知识库边界（团队隔离同样适用于 MCP 通道）。
工具清单
接入后客户端拿到三个只读工具：
| 工具 | 作用 |
|---|---|
| 知识库列表 | 列出 key 可访问的知识库 |
| 文件搜索 | 按关键词检索知识库内的文档与片段 |
| 向量召回 | 输入问题做语义检索，返回带序号的片段；相邻片段自动做上下文合并去重，片段带序号便于追问「第 3 段再展开讲讲」 |
所有工具只读——MCP 通道无法修改或删除知识库内容。
客户端接入示例
以支持 MCP 的 AI 客户端为例，把服务地址与 key 填进配置：
{
"mcpServers": {
"yuntu-help": {
"type": "http",
"url": "https://你的平台地址/api/external/wiki/351/mcp",
"headers": {
"Authorization": "Bearer moai-ac-xxxxxxxx"
}
}
}
}
保存后客户端即可列出该知识库的三个工具，对话中按需调用。
案例：让研发在 IDE 里直接查产品文档
研发同事写代码时要频繁核对「云途网盘」的接口规范，但不想离开 IDE：
- 管理员创建一个只勾选「知识库 MCP」范围的接入 key，交给研发团队；
- 研发在 Cursor 的 MCP 配置里加入上面的服务地址与 key；
- 之后在 IDE 对话里直接问「云途网盘分享链接的有效期有哪几种」，模型通过向量召回拿到帮助中心原文并引用作答——文档更新后（见 3.5.5 飞书同步、3.5.6 网页抓取）答案自动跟着更新。
常见问题
客户端连接报 401？
key 未勾选「知识库 MCP」范围、key 已吊销，或鉴权头格式不对（两种支持的写法见上）。范围调整实时生效，补勾后立即重试即可。
检索一直返回空？
该知识库可能尚未完成向量化（见 3.5.1）；另外 key 只能看到其归属团队的知识库，跨团队的库连列表都不会出现。
MCP 检索和应用内的知识库检索有什么区别？
底层同一条检索链路，参数与排序一致；区别在入口——MCP 面向外部客户端的即席查询，应用内检索面向绑定知识库的应用对话（有对话上下文与提示词加持）。
一个 key 能接多个知识库吗？
可以。key 可访问其团队的全部知识库；客户端里每个知识库有各自的服务地址，按需配置多条即可。