通用大模型最致命的法律短板,是它会"一本正经地编判例"——案号像模像样,引用的法条却对不上,你根本不敢拿去办案。解决办法不是换一个更大的模型,而是给它接一个能查真实判决的数据源。本文用最短的路径演示:如何用 MCP(Model Context Protocol)把文书查的 1.6 亿+ 裁判文书接进 Claude Desktop,让 AI 在对话里直接检索、返回带案号可核验的真实判例。全程改一个配置文件,不到 5 分钟。
一、先搞清楚:MCP 到底解决什么问题
MCP 是一种让 AI 助手调用外部工具和数据的开放协议。你可以把它理解成"给大模型装的标准化数据接口"——装上之后,Claude / Cursor 这类客户端就能在回答前先去外部数据源查一遍,再基于查到的真实内容作答。
对法律场景,这个区别是决定性的:
| 不接数据源(裸用大模型) | 接入文书查 MCP 之后 | |
|---|---|---|
| 判例来源 | 凭训练记忆生成,可能是编的 | 实时检索 1.6 亿+ 真实裁判文书 |
| 可溯源 | 无法核对,案号常对不上 | 每条结果附案号、法院、裁判日期,可回中国裁判文书网核对 |
| 时效 | 停在训练截止日 | 数据每日同步,新判决约 24 小时内可查 |
| 能不能办案用 | 不敢 | 可作为类案检索与初判的起点 |
一句话:MCP 把"会说法言法语的模型"变成"能引用真实判决的助手"。这也是法律 AI 防幻觉最实在的一招——不是靠 prompt 求它别编,而是直接喂给它可查的数据。
二、准备:一把 Key,现在就能用
接入前你只需要一样东西:一把 x-api-key。文书查把一把公开测试 Key直接印在了网页上,不用注册、不用申请:
- 端点:
https://mcp.wenshucha.com/mcp(远程 MCP Streamable HTTP；Claude Desktop 的本机配置需通过 mcp-remote 转接) - 公开测试 Key:
wsc_demo_public,每个 IP 每天 20 次,四个工具全开 - 要独享额度:加微信 131-6872-7779(备注「MCP」)当场开通——免费版 1,000 次/月不收费,开发者 Pro ¥99/月 50,000 次 + 5,000 篇判决全文。完整价目与同行对比见 定价页,接入细节见 接入指南。
为什么先测再谈量? 先用公开 Key 在你真实的几个问题上跑一遍,确认检索召回与返回的案号、法院、裁判日期确实能用,再决定走云端 Pro 扩量还是私有化离线部署。别一上来就签大单——先验证数据质量。
三、接入 Claude Desktop:改一个配置文件
Claude Desktop 通过一个 JSON 配置文件管理 MCP 服务,接入文书查就是往里加一段。
1. 找到配置文件
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
也可以在 Claude Desktop 的设置(Settings → Developer → Edit Config)里直接打开它。文件不存在就新建一个。
2. 加入文书查 MCP 配置
先安装 Node.js LTS（推荐 22 或更新版本），确认终端能运行 npx --version。下面是 macOS 配置；Windows 使用接入指南里的 cmd 配置。mcpServers 里已有别的服务就并列加一项，公开 Key 可以直接用，拿到专属 Key 后把它换掉即可：
{
"mcpServers": {
"wenshucha": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://mcp.wenshucha.com/mcp",
"--transport", "http-only",
"--header", "x-api-key:wsc_demo_public"
]
}
}
}说明：Claude Desktop 的本机配置使用 command/args，由 mcp-remote 把 stdio 转接到远程服务。Cursor 与 Claude Code 使用各自的 HTTP 配置，不能把这几种客户端的配置混用。完整配置、下载文件与常见报错见接入指南。
3. 重启 Claude Desktop,验证连接
完全退出并重新打开 Claude Desktop。连接成功后,输入框旁会出现 MCP 工具图标,展开能看到 wenshucha 提供的检索工具。验证一句最简单的:
用文书查检索:近三年 劳动合同 违法解除 二倍赔偿 的二审改判案例,
列 3 个,给案号、法院和裁判日期。如果 Claude 调起了文书查工具、返回了带案号、法院、裁判日期的结果,就说明接通了。看到真实案号 + 法院 + 裁判日期 = 成功。本库不提供原文链接,溯源请拿这三元组回中国裁判文书网核对。
四、接进自己的应用:用 REST API
MCP 适合在 AI 客户端里"让 AI 自己查";如果你要把检索接进自己的产品后端(做 RAG、批量检索、评测),用 REST API 更可控。基本调用示意:
# Python 示例(结构示意,字段以接口文档为准)
import requests
resp = requests.post(
"https://tob.wenshucha.com/api/v1/search",
headers={"Authorization": "Bearer <你的 key>"},
json={"query": "民间借贷 担保 连带责任", "size": 10},
)
for hit in resp.json().get("data", []):
print(hit["case_no"], hit["court"], hit["url"])返回的每条记录都带结构化字段(案号、法院、审级、案由、当事人脱敏、裁判结果)和案号、法院、裁判日期,直接可以喂进你的检索/重排/grounding 流程。完整字段与端点见开发者文档与 API/MCP 定价页。
五、MCP vs REST API:怎么选
| MCP 接入 | REST API | |
|---|---|---|
| 适合谁 | 用 Claude/Cursor 办公的律师、KM 团队、想零代码验证的人 | 要把检索接进自己产品的开发团队 |
| 要写代码吗 | 不用,改配置即可 | 要,但可控性最高 |
| 典型用法 | 对话里随手查类案、要素 | RAG、批量检索、评测、Agent 工具 |
| 上手时间 | ~5 分钟 | ~半天接通 |
实践里的常见路径是:先用 MCP 跑通、让团队直观看到效果,再用 REST API 接进生产。两者数据同源,切换不返工。
六、三个让效果立竿见影的用法
- 类案检索起点:把当事人情况写成一句话,让 AI 检索相似判决并归纳裁判倾向——比关键词搜更贴合语义,且每条可回原文核对。
- 要素与结果抽取:对一批判决批量抽"争议焦点 / 裁判理由 / 赔偿区间",做实证分析或给客户出报告。
- 初判参考:结合类案的赔偿区间和改判情况,给出一个有判例支撑的初步预判区间(强调:供参考,不替代律师判断)。
一句话提醒:MCP 接入解决的是"让 AI 用真实判决说话",但它是云端调用,适合验证与中小用量。对数据不能出内网的律所、法院、检察院、政府,正确路径是先用 MCP 验证检索质量,再上私有化离线部署(全量数据 + 模型都跑在内网)。
七、常见问题
Q:接入要不要懂 MCP 协议本身?
A:不用。Claude Desktop 已经把协议封装好了,你只是在配置文件里登记一个服务。会改 JSON、会复制粘贴 key 就够。
Q:公开 Key 和各档位有什么限制?
A:公开测试 Key 每个 IP 每天 20 次;免费版 1,000 次/月含 100 篇全文;开发者 Pro ¥99/月 50,000 次含 5,000 篇全文;团队版 ¥4,800/年。所有档位四个工具全开,只差次数、全文篇数和速率。开通加微信 131-6872-7779,当场发 Key。
Q:Cursor / Cline / 自研助手能接吗?
A:能。任何支持 MCP 的客户端配置方式都类似(登记服务 + 填 key);自研后端则走 REST API。
Q:返回的判决会不会有当事人隐私问题?
A:数据均来自人民法院公开渠道,个人敏感信息已按公开口径脱敏;返回案号、法院、裁判日期,可回中国裁判文书网自行核对。
5 分钟把判例库接进你的 AI:公开 Key 现在就能用
不用申请,粘一段配置就能测;要更多额度加微信 131-6872-7779 当场开通。需要私有化离线部署的律所/政府,可直接约方案与 demo。
📞 联系商务 Jack · 131 6872 7779相关阅读:法律 AI 数据底座选型:文书查 vs 北大法宝 vs 无讼 vs Alpha · 律师工作台:案件胜算量化 · 裁判文书 API / MCP 定价