Skip to main content

知识库检索 MCP 服务配置

配置知识库检索 MCP Server,并查看知识库查询与读取工具

在当前身份有权访问的知识库中查找释义、实务口径和操作指引。

适用场景

可先列出知识库,再检索相关内容并读取命中文件正文。
  • 要点检索:需要条文之外的释义、实务口径与操作指引时,检索知识库命中对应条目。例如:「离职经济补偿的『月工资』基数怎么算,库里有没有实务口径?」
  • 全文读取:检索命中后按文件标识读取正文,供引用与留档时核对。例如:「把刚才那条关于商业秘密秘点认定的条目全文给我。」
  • 库目录盘点:接入前或排查覆盖范围时,列出当前身份可访问的知识库。例如:「现在挂了哪些知识库?有没有劳动争议方向的?」
引用知识库内容前,请核对来源信息,并检查 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
服务 URLhttps://farui.cn-beijing.aliyuncs.com/open/v1/knowledge/mcp
请求头 Authorization已关联的个人 API Key
请求头 x-acs-version2026-10-19
保存并启用服务后,在客户端查看工具清单。

验证调用

  1. 保存并启用客户端配置,通过 tools/list 核对实际工具名称、inputSchema 和可选的 outputSchema。
  2. 按目标工具的 Schema 填写 params.arguments,在 params.name 中使用实际工具名发起 tools/call,检查返回内容以及 JSON-RPC error、result.isError。