选择法睿 MCP 服务,配置客户端,并检查工具发现、调用结果与错误
什么是 MCP 服务
MCP(Model Context Protocol)是由 Anthropic 推出的开放协议,用于连接 AI 应用与外部工具和数据源。法睿通过云端 MCP 服务提供法规、案例和知识库检索工具,供 AI 客户端发现和调用。
本页先介绍客户端配置与验证,再提供原始 HTTP 请求的协议约定和报文示例。客户端是否调用工具、选择哪个工具以及如何组合调用,取决于客户端功能、配置与当前任务。
接入前准备
安装与客户端配置
选择要连接的服务,打开对应配置页的「添加到客户端」。可以在「手动配置」中逐项填写,也可以使用对应客户端的配置示例。示例已填好该服务的配置名和路径。
| 服务 | 配置文档 |
|---|---|
| 法规检索 | 法规检索 MCP 服务配置 |
| 案例检索 | 案例检索 MCP 服务配置 |
| 知识库检索 | 知识库 MCP 服务配置 |
| 配置项 | 填写内容 |
|---|---|
| 传输方式 | Streamable HTTP |
| 服务 URL | 服务基础地址与所选 Server 路径组成的完整 URL |
请求头
在 MCP 客户端中配置以下两个请求头:
| 请求头 | 填写说明 |
|---|---|
Authorization | 填写个人 API Key 原文,省略 Bearer 前缀 |
x-acs-version | 填写 2026-10-19,这是 POP API 版本 |
自行发送 MCP HTTP 请求时,还需配置下方的请求体格式和协议头。
验证连接
- 检查工具发现:保存并启用配置,在客户端查看工具列表,核对目标工具是否出现。工具列表用于检查发现结果,不代表已完成业务检索。
- 检查一次工具调用:按工具的输入要求发起调用,查看客户端记录中的工具名称、参数、返回结果或错误。业务调用可能产生用量,详见计费与用量。
HTTP 请求约定
法睿 MCP 使用 JSON-RPC 2.0 和无状态 Streamable HTTP。直接发送请求时,除上述认证与 POP API 版本请求头外,还需配置以下内容:
| 项目 | 说明 |
|---|---|
| HTTP 方法 | 使用 POST 发起协议调用;通过认证的 GET 请求返回 405 |
Content-Type | application/json |
Accept | application/json, text/event-stream |
| MCP 协议版本 | 在 initialize 请求体中提出 protocolVersion,后续请求通过 MCP-Protocol-Version 发送协商结果;本页示例使用 2025-06-18 |
| 会话 | 接口不持有会话,也不返回 Mcp-Session-Id |
x-acs-version 是两项不同配置。旧版 HTTP+SSE 传输需要独立的 SSE 连接,请核对客户端实际使用的传输方式。
MCP 协议输入上限为 64 KiB。自行开发 HTTP 客户端时,请从服务端发起调用。
调用流程
1
初始化并确认服务端能力
发送 响应结构示例:
initialize,协商协议版本、客户端与服务端能力:2
发送初始化通知并发现工具
初始化成功后发送通知。该通知没有 再调用 从
id,成功时返回 HTTP 202 和空正文:tools/list:result.tools 中读取工具名称和 inputSchema。工具提供 outputSchema 时,按该 Schema 解析结构化结果。3
调用工具并读取结果
将 工具结果通过
params.name 替换为 tools/list 返回的工具名,按该工具的 inputSchema 填写 params.arguments。Server 标识用于选择连接,工具名用于发起调用。result.content 返回。工具同时返回 result.structuredContent 时,可按返回的 Schema 读取结构化数据。initialize、notifications/initialized 和 tools/list 用于初始化与工具发现,不执行检索。每次 tools/call 都会发起新的工具执行,重复使用 JSON-RPC id 不会去重。积分使用与用量核对见计费与用量。错误处理
| 返回形态 | 检查方向 |
|---|---|
JSON-RPC error | 认证或访问权限失败会以此形式返回;按错误内容检查配置与权限 |
result.isError=true | 通常表示工具参数或业务失败;检查输入参数和业务错误内容 |
result 是否存在。完整示例见错误与排障。