Коннектор CasusLegal в вашем продукте

1. Подключение

Стандартный MCP-сервер: подключается как любой другой коннектор в вашем чате.

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.

Объём

Один поиск — порядка 110 тысяч знаков, около 40 тысяч токенов на входе вашей модели. Это осознанный формат: полнота выдачи и есть продукт. Заложите объём в выбор модели, которая обрабатывает ответ, — на таких размерах разница в стоимости между моделями достигает двенадцати раз.

Время

Поиск — около 30 секунд. Таймаут вызова инструмента ставьте от 120 секунд, иначе будете рвать нормально идущие запросы.

Ссылки на акты

У каждого акта есть поле url — страница с полным текстом. Передавайте её пользователю как есть и не обрезайте параметр ?t=: без него ссылка недействительна. Срок жизни ссылки — 30 дней. Если планируете запекать ссылки в документы клиента, скажите нам — сделаем бессрочные.

Полный текст

Поиск отдаёт реквизиты и ключевые фрагменты; целиком акт — отдельным вызовом casuslegal_get_case_details(case_id, corpus). case_id действителен только внутри своего корпуса.

5. Ошибки и лимиты

Отказы приходят успешным ответом инструмента с полем error — так ваша модель объяснит ситуацию пользователю, вместо того чтобы считать коннектор сломанным.

401 возвращается только на уровне подключения: ключ не тот, отозван или истёк срок. Это конфигурационная ошибка, повторами она не лечится.

Пределы по умолчанию

• 20 000 вызовов в час на интеграцию;
• 400 вызовов в час на одного конечного пользователя;
• 24 одновременных поиска на интеграцию, 4 — на пользователя;
• суточный потолок числа разных актов — защита корпуса от массовой выгрузки.

Пределы настраиваются: если упираетесь при нормальной работе — сообщите, поднимем.

6. Чек-лист перед запуском

• Транспорт — streamable HTTP, не SSE.
• tools/list возвращает шесть инструментов.
• Таймаут вызова инструмента — от 120 секунд.
• Заголовок X-Partner-User-Id проставляется на каждом вызове.
• corpus выбирается по теме вопроса, один корпус на запрос.
• Ссылки url доходят до пользователя целиком, вместе с ?t=.
• Модель, обрабатывающая выдачу, выбрана с учётом 40 тысяч токенов на поиск.
• Поле error в ответе инструмента обрабатывается и показывается пользователю.