配置知识库检索 MCP Server,并查看知识库查询与读取工具
在当前身份有权访问的知识库中查找释义、实务口径和操作指引。
可先列出知识库,再检索相关内容并读取命中文件正文。
客户端的 URL 字段填写下表中的完整请求地址。API Key 的创建与管理见接入认证。
服务标识对应
接入后使用
示例已填写服务地址和对应的服务路径。复制配置或命令时,Codex、Claude Code 和 Cursor 从客户端进程的
适用场景
可先列出知识库,再检索相关内容并读取命中文件正文。
- 要点检索:需要条文之外的释义、实务口径与操作指引时,检索知识库命中对应条目。例如:「离职经济补偿的『月工资』基数怎么算,库里有没有实务口径?」
- 全文读取:检索命中后按文件标识读取正文,供引用与留档时核对。例如:「把刚才那条关于商业秘密秘点认定的条目全文给我。」
- 库目录盘点:接入前或排查覆盖范围时,列出当前身份可访问的知识库。例如:「现在挂了哪些知识库?有没有劳动争议方向的?」
引用知识库内容前,请核对来源信息,并检查
chunkTruncated 和 contentTruncated 判断正文是否被截断。接入信息
客户端的 URL 字段填写下表中的完整请求地址。API Key 的创建与管理见接入认证。
| 配置项 | 配置值 |
|---|---|
| 服务名称 | 通义法睿-法律知识库MCP |
| 服务标识 | KnowledgeFaruiOpenMcp |
| 客户端配置名称(示例) | KnowledgeFaruiOpenMcp |
| 服务基础地址 | https://farui.cn-beijing.aliyuncs.com |
| 请求路径 | /open/v1/knowledge/mcp |
| 请求地址(完整 URL) | https://farui.cn-beijing.aliyuncs.com/open/v1/knowledge/mcp |
| 请求方法 | POST |
| 传输方式 | Streamable HTTP |
| 认证方式 | 通过请求头 Authorization 传入个人 API Key 原文,省略 Bearer 前缀 |
| 接口版本 | 2026-10-19,通过请求头 x-acs-version 传入 |
| 工具调用方法 | JSON-RPC 2.0 tools/call |
initialize 响应中的 serverInfo.name。下方示例使用同一标识作为客户端配置名称。调用时请使用具有目标服务访问权限的身份。
工具清单
| 工具名称 | 用途 | 使用要点 |
|---|---|---|
kb_list | 列出当前身份可访问的知识库 | 返回可用于检索的 kbId。可选 pageNumber 默认 1,pageSize 默认 10、最大 10。 |
kb_search | 在指定知识库中检索相关内容 | 传入一个 kbId 和 query。返回相关片段和 fileId。 |
kb_page_read | 读取命中文件的正文及来源信息 | 把命中的 fileId 放入请求数组 fileIds。每次传入 1~5 个不同 ID。通过 chunkTruncated 和 contentTruncated 判断正文是否完整。 |
tools/list 获取工具清单、inputSchema 及工具提供的 outputSchema。调用 tools/call 时,在 params.name 中填写工具名,在 params.arguments 中按该工具的 Schema 填写参数。调用失败时,分别检查 JSON-RPC error 与 result.isError,处理方法见错误与排障。
使用说明按「
kb_list 选库 → kb_search 检索 → kb_page_read 读全文」的顺序调用。知识库和文件均受当前身份的资源权限限制。排障记录只保留必要的请求标识,避免记录知识正文。添加到客户端
示例已填写服务地址和对应的服务路径。复制配置或命令时,Codex、Claude Code 和 Cursor 从客户端进程的 FARUI_API_KEY 环境变量读取个人 API Key。QoderWork 在导入配置时填写个人 API Key。
- 手动配置
- Codex
- Claude Code
- Cursor
- QoderWork
在支持自定义 HTTP 请求头的客户端中选择「添加 MCP 服务」,填写以下字段。
保存并启用服务后,在客户端查看工具清单。
| 配置项 | 填写内容 |
|---|---|
| 客户端配置名称 | KnowledgeFaruiOpenMcp |
| 传输方式 | Streamable HTTP |
| 服务 URL | https://farui.cn-beijing.aliyuncs.com/open/v1/knowledge/mcp |
请求头 Authorization | 已关联的个人 API Key |
请求头 x-acs-version | 2026-10-19 |
验证调用
- 保存并启用客户端配置,通过
tools/list核对实际工具名称、inputSchema和可选的outputSchema。 - 按目标工具的 Schema 填写
params.arguments,在params.name中使用实际工具名发起tools/call,检查返回内容以及 JSON-RPCerror、result.isError。