Коннектор 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.

Объём

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

Время

Поиск — около 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. Тарификация

Оплачивается каждый успешный запрос, который отдаёт вам содержание: поиск, полный текст акта, похожие акты, перечень, выгрузка и комментарий «Глосса», 5,00 ₽ за запрос, полный текст акта — 3,00 ₽. Справочные и служебные вызовы бесплатны.

• Цена не зависит от базы: высшие суды, СИП, КАС, КУД и кассационные округа тарифицируются одинаково, префикс инструмента роли не играет.
• Каждая страница browse_practice и каждый вызов export_cases оплачиваются как один запрос, независимо от числа актов в них.
• Поиск и перечень по всем округам сразу (okrug_search_practice, okrug_find_term, okrug_browse_practice без параметра corpus) выполняются в каждом открытом вам округе отдельно и учитываются как запрос в каждом из них. Чтобы оплатить один запрос, указывайте округ.
• Вызов, завершившийся ошибкой на нашей стороне, не оплачивается. Служебные сообщения протокола (initialize, tools/list) вызовами не считаются.
• Если вашей интеграции открыт комментарий «Глосса», его поиск и чтение (glossa_search, glossa_support, glossa_get_point, glossa_get_article, glossa_find_by_act, glossa_find_similar) оплачиваются по той же цене; glossa_stats бесплатен.
• Сутки и расчётные периоды считаются по московскому времени.

Число вызовов, платных и бесплатных, с разбивкой по инструментам, базам, округам и дням, вместе с суммой к оплате вы видите в кабинете партнёра lk.casus.legal/pcab. Там же вы сами выпускаете ключ и включаете или выключаете открытые вам базы: выключенная база отвечает отказом и не тарифицируется. Ссылку для первого входа присылает ваш менеджер в CasusLegal, пароль вы задаёте сами. Бесплатный тестовый период там отмечен отдельно: сумма за него показана для справки и к оплате не выставляется.

Порядок расчётов

Кабинет партнёра рассчитан на самообслуживание. При первом входе вы задаёте пароль, email для обмена документами и реквизиты организации: без них кабинет не открывается. Реквизиты сразу подставляются в договор, акты и счета; договор уже подписан с нашей стороны (факсимиле). Скачайте его в разделе «Документы и расчёты», подпишите и загрузите скан кнопкой «Загрузить подписанный договор». Договор также считается заключённым с оплаты первого счёта. Все документы хранятся в кабинете и скачиваются в любое время.

• Расчётный период — 30 календарных дней. Первый период начинается на следующий день после бесплатного теста (или в дату, которую назовёт менеджер), каждый следующий — сразу после предыдущего. Стоимость услуг за период = платные запросы × 5,00 ₽ (полные тексты актов × 3,00 ₽).
• Услуги оказываются по предоплате. Первый аванс определяет менеджер CasusLegal и выставляет счётом на первый период.
• На следующий день после окончания периода в кабинете автоматически появляются три документа: акт с расчётом (услуги минус аванс минус зачёт переплаты), счёт на доплату, если услуг было больше аванса, и счёт на аванс следующего периода — 80% стоимости услуг истекшего периода, до рубля. Те же документы приходят на ваш email. Переплата не возвращается, а зачитывается в следующий период.
• Счета оплачиваются банковским переводом в течение 3 рабочих дней после окончания периода. Оплатив, нажмите у счёта «Сообщить об оплате» и приложите платёжное поручение. Подписанный акт загрузите в строке периода.
• Если к сроку счёт не оплачен и платёжный документ не загружен, доступ по ключу приостанавливается автоматически; загруженная платёжка возвращает доступ сразу, до проверки. Если оплата не подтвердилась, менеджер напишет в разделе «Сообщения» кабинета, и доступ снова приостанавливается до поступления оплаты.
• Остаток предоплаты (аванс, зачёт, израсходовано с начала периода) виден в кабинете в реальном времени. НДС не облагается (ИП на УСН).

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

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