您产品中的 CasusLegal 连接器

1. 接入

标准 MCP 服务器：像其他连接器一样接入您的聊天工具。

如何获取密钥

合作伙伴密钥的形式为 clp_<名称>_…。共有两种方式，连接地址和工作规则相同。

• 密钥由我们直接发放给您。 例如，Doczilla 平台就是通过这种方式接入的：CasusLegal 经理通过安全渠道传递密钥，您将其保存在自己的服务器上，并填入请求头 Authorization。密钥换发由我们根据您的申请完成。 同时，包含您统计数据和数据库启用设置的控制台也可使用： 经理会发送邀请链接。
• 由您自行生成密钥。 例如，来自萨马拉的平台就是通过这种方式接入的：经理会发送合作伙伴控制台的邀请链接 lk.casus.legal/pcab （其中包含登录名和一次性代码）。您设置电子邮箱和密码，点击“生成密钥”并复制密钥：密钥只显示一次；丢失后可重新生成，原密钥届时将停止工作。

该密钥可访问向您启用的所有数据库。请仅将其保存在服务器上，不要传递至最终用户的浏览器。

curl -sS https://mcp.casus.legal/partner/mcp \
  -H "Authorization: Bearer $CASUS_PARTNER_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{
        "protocolVersion":"2025-06-18","capabilities":{},
        "clientInfo":{"name":"my-platform","version":"1.0"}}}'

响应中返回 serverInfo.name: "CasusLegal Partner"。随后 tools/list 应返回九个工具。

2. 请求头

X-Partner-User-Id — 任意稳定的字符串，但不得暴露个人身份：您方内部标识符或其哈希值。该字段用于按用户逐一统计：我们和您方据此核对数据（调用次数、调用类型以及实际到达连接器的用户人数）。它不影响访问权限：用户数量不受限制。

3. 工具

九种工具，每种工具都有一个参数 corpus.

参数 corpus

{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
  "name":"casuslegal_search_practice",
  "arguments":{
    "query":"взыскание неустойки, снижение по статье 333 ГК",
    "corpus":"main",
    "limit":10
  }}}

4. 返回内容

结构化对象。对于主语料库，该对象由以下区块组成 constitutional_context （俄罗斯联邦宪法法院的立场）， vs_guidance （俄罗斯联邦最高法院全体会议文件及综述）， latest_practice （审判庭最新裁定）， vas_history （俄罗斯联邦最高仲裁法院的司法实践）以及 results.

规模

一次检索约返回 11 万字符，即您的模型输入约 4 万个 token。这是有意设计的格式：结果的完整性本身就是产品。选择处理该响应的模型时，请将这一规模纳入考虑——在此规模下，不同模型之间的成本差异可达 12 倍。

时间

检索约需 30 秒。请将工具调用超时设置为至少 120 秒，否则会中断正常进行的请求。

裁判文书链接

每份裁判文书都有一个字段 url — 指向全文页面。请原样将其传递给用户，不要截短参数 ?t=：没有该参数，链接无效。链接有效期为 30 天。如果您计划将链接嵌入客户文件，请告知我们——我们可以制作永久链接。

全文

检索返回案号等基本信息及关键片段；裁判文书全文需通过单独调用获取 casuslegal_get_case_details(case_id, corpus)。 参数 case_id — 是字段中的数字 id 检索结果卡片。卡片还包含同名字段 case_id，但该字段中是案件编号（形如 “305-ЭС22-11906”），不得传递该编号。 id 仅在所属语料库内有效；同样适用于 casuslegal_find_similar.

5. 错误与负载

拒绝会以工具成功响应的形式返回，并包含字段 error — 这样您的模型可以向用户解释情况，而不是认为连接器发生故障。

401 仅在连接层级返回：密钥错误、已撤销或已过期。这是配置错误，重复尝试无法解决。

负载

用户数量、调用次数和并发请求数均不受限制：集成按每个成功返回结果的请求付费，我们不限制请求量。

请注意一个物理特性：对主语料库的并行检索会共享处理器时间。四个并行检索完成所需的时间，大致与四个串行检索相同，而且每个检索都会比单独运行时更慢。只有对不同语料库进行并行检索才能节省时间：它们由不同的服务分别处理。如果您预计会出现峰值负载，请提前告知——我们会据此增加容量。

6. 计费

每个向您返回内容的成功请求均需付费，包括检索、裁判文书全文、相似裁判文书、清单、导出以及“Glossa”评论， 每次请求 3,00 ₽，裁判文书全文— 2,00 ₽。参考性和服务性调用免费。

• 价格不取决于数据库：最高法院、知识产权法院、KAS、KUD 以及各上诉审辖区的计费标准相同，工具前缀不影响价格。
• 每个页面 browse_practice 以及每次调用 export_cases 均按一次请求计费，与其中包含的裁判文书数量无关。
• 同时检索和列出所有辖区（okrug_search_practice, okrug_find_term, okrug_browse_practice 不含辖区参数 corpus）时，会在向您开放的每个辖区中分别执行，并在每个辖区中计为一次请求。若要只支付一次请求，请指定辖区。
• 因我方原因以错误结束的调用不收费。协议的服务消息（initialize, tools/list）不计为调用。
• 如果您的集成已开放“Glossa”评论，则其检索和读取（glossa_search, glossa_support, glossa_get_point, glossa_get_article, glossa_find_by_act, glossa_find_similar）按相同价格计费； glossa_stats 免费。
• 日历日和计费周期均按莫斯科时间计算。

您可以在合作伙伴账户中查看调用次数（包括付费和免费调用），并按工具、数据库、辖区和日期进行细分，同时查看应付金额 lk.casus.legal/pcab。您也可以在那里自行生成密钥，并启用或停用已向您开放的数据库：停用的数据库会返回拒绝，且不计费。首次登录链接由 CasusLegal 的经理发送，密码由您自行设置。免费试用期会在那里单独标明：该期间的金额仅供参考，不会计入应付金额。

结算方式

合作伙伴后台按自助服务模式设计。首次登录时，您需要设置密码、用于交换文件的电子邮箱以及组织机构信息：缺少这些信息将无法开通后台。组织机构信息会立即自动填入合同、验收 акт 和账单；合同已由我方签署（传真签名）。请在“文件和结算”部分下载合同，签署后点击“上传已签署的合同”上传扫描件。支付第一张账单后，合同也视为已经订立。所有文件均保存在后台中，可随时下载。

• 结算周期为30个日历日。第一个周期从免费试用结束后的次日开始（或从经理指定的日期开始），其后每个周期均紧接上一个周期开始。 周期服务费 = 付费请求数 × 3,00 ₽（验收 акт 的完整文本 × 2,00 ₽）。
• 服务采用预付款方式提供。首笔预付款由 CasusLegal 经理确定，并以账单形式开具，用于第一个周期。
• 周期结束后的次日，后台将自动生成三份文件：结算验收 акт（服务费减去预付款，再减去多付款项抵扣额）、补款账单（如服务费超过预付款）以及下一周期的预付款账单——金额为上一周期服务费的80%，精确到卢布。相同文件也会发送到您的电子邮箱。 多付款项不予退还，而是抵扣下一周期的费用。
• 账单应在周期结束后的3个工作日内通过银行转账支付。付款后，请点击账单旁的“告知已付款”，并附上付款指令。请在周期所在行上传已签署的验收 акт。
• 如果在到期时账单尚未支付且未上传付款凭证，系统将自动暂停通过密钥的访问权限；上传付款凭证后，访问权限会立即恢复，直至完成核验。如果付款未获确认，经理会在后台的“消息”部分联系您，访问权限将再次暂停，直至收到付款。
• 预付款余额（预付款、抵扣额、自周期开始以来已使用金额）会在后台实时显示。不征收增值税（采用简化税制的个体企业家）。

7. 启动前检查清单

• 传输方式为 streamable HTTP，而非 SSE。
• tools/list 返回九个工具。
• 工具调用超时时间至少为120秒。
• 标题 X-Partner-User-Id 每次调用时均会设置。
• corpus 根据问题主题选择，每次请求使用一个语料库。
• 链接 url 完整传递给用户，并连同 ?t=.
• 处理搜索结果的模型是根据搜索所需的4万个令牌进行选择的。
• 字段 error 工具响应中的内容会经过处理并向用户显示。