Skip to main content

MCP 接入指南

选择法睿 MCP 服务,配置客户端,并检查工具发现、调用结果与错误

什么是 MCP 服务

MCP(Model Context Protocol)是由 Anthropic 推出的开放协议,用于连接 AI 应用与外部工具和数据源。法睿通过云端 MCP 服务提供法规、案例和知识库检索工具,供 AI 客户端发现和调用。 本页先介绍客户端配置与验证,再提供原始 HTTP 请求的协议约定和报文示例。客户端是否调用工具、选择哪个工具以及如何组合调用,取决于客户端功能、配置与当前任务。

接入前准备

准备项要求
API Key 与权限按接入认证准备已启用的个人 API Key,并确认目标服务的访问权限
客户端确认所用版本支持 Streamable HTTP 和自定义 HTTP 请求头;服务配置页提供 Codex、Claude Code、Cursor 和 QoderWork 的配置示例
服务地址在服务地址核对基础地址,从目标服务配置页获取完整路径,并遵循控制台提供的网络访问要求

安装与客户端配置

选择要连接的服务,打开对应配置页的「添加到客户端」。可以在「手动配置」中逐项填写,也可以使用对应客户端的配置示例。示例已填好该服务的配置名和路径。
服务配置文档
法规检索法规检索 MCP 服务配置
案例检索案例检索 MCP 服务配置
知识库检索知识库 MCP 服务配置
添加服务时,重点核对以下配置:
配置项填写内容
传输方式Streamable HTTP
服务 URL服务基础地址与所选 Server 路径组成的完整 URL
实际 Key 通过客户端的环境变量或个人配置填写,避免进入共享配置、命令历史和日志。

请求头

在 MCP 客户端中配置以下两个请求头:
请求头填写说明
Authorization填写个人 API Key 原文,省略 Bearer 前缀
x-acs-version填写 2026-10-19,这是 POP API 版本
自行发送 MCP HTTP 请求时,还需配置下方的请求体格式和协议头。

验证连接

  1. 检查工具发现:保存并启用配置,在客户端查看工具列表,核对目标工具是否出现。工具列表用于检查发现结果,不代表已完成业务检索。
  2. 检查一次工具调用:按工具的输入要求发起调用,查看客户端记录中的工具名称、参数、返回结果或错误。业务调用可能产生用量,详见计费与用量。
使用原始 HTTP 接入时,按下方调用流程发送协议报文。

HTTP 请求约定

法睿 MCP 使用 JSON-RPC 2.0 和无状态 Streamable HTTP。直接发送请求时,除上述认证与 POP API 版本请求头外,还需配置以下内容:
项目说明
HTTP 方法使用 POST 发起协议调用;通过认证的 GET 请求返回 405
Content-Typeapplication/json
Acceptapplication/json, text/event-stream
MCP 协议版本在 initialize 请求体中提出 protocolVersion,后续请求通过 MCP-Protocol-Version 发送协商结果;本页示例使用 2025-06-18
会话接口不持有会话,也不返回 Mcp-Session-Id
MCP 协议版本与 x-acs-version 是两项不同配置。旧版 HTTP+SSE 传输需要独立的 SSE 连接,请核对客户端实际使用的传输方式。
MCP 协议输入上限为 64 KiB。自行开发 HTTP 客户端时,请从服务端发起调用。

调用流程

1

初始化并确认服务端能力

发送 initialize,协商协议版本、客户端与服务端能力:
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "initialize",
  "params": {
    "protocolVersion": "2025-06-18",
    "capabilities": {},
    "clientInfo": {
      "name": "example-client",
      "version": "1.0.0"
    }
  }
}
响应结构示例:
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "protocolVersion": "2025-06-18",
    "capabilities": {
      "tools": {
        "listChanged": false
      }
    },
    "serverInfo": {
      "name": "<服务端名称>",
      "version": "1.0.0"
    }
  }
}
2

发送初始化通知并发现工具

初始化成功后发送通知。该通知没有 id,成功时返回 HTTP 202 和空正文:
{
  "jsonrpc": "2.0",
  "method": "notifications/initialized"
}
再调用 tools/list:
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}
从 result.tools 中读取工具名称和 inputSchema。工具提供 outputSchema 时,按该 Schema 解析结构化结果。
3

调用工具并读取结果

将 params.name 替换为 tools/list 返回的工具名,按该工具的 inputSchema 填写 params.arguments。Server 标识用于选择连接,工具名用于发起调用。
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "<tool-name>",
    "arguments": {}
  }
}
工具结果通过 result.content 返回。工具同时返回 result.structuredContent 时,可按返回的 Schema 读取结构化数据。
initialize、notifications/initialized 和 tools/list 用于初始化与工具发现,不执行检索。每次 tools/call 都会发起新的工具执行,重复使用 JSON-RPC id 不会去重。积分使用与用量核对见计费与用量。

错误处理

返回形态检查方向
JSON-RPC error认证或访问权限失败会以此形式返回;按错误内容检查配置与权限
result.isError=true通常表示工具参数或业务失败;检查输入参数和业务错误内容
客户端需检查两种形态,不能只检查 HTTP 状态或 result 是否存在。完整示例见错误与排障。