MCP-сервер для арбитражных судов — дела КАД, судебные акты, заседания и перерывы

MCP-сервер СУДиДЕЛО для арбитражных судов позволяет получать сведения о делах, судебных актах, заседаниях и перерывах через ИИ-помощника. Подключите сервер к совместимому клиенту и задавайте вопросы обычным языком.

Сервер получает данные через API СУДиДЕЛО: сведения КАД Арбитр, результаты поиска судебных актов РАС, расписание заседаний, перерывы и справочник арбитражных судов. Для поиска достаточно номера дела или ИНН; предварительно добавлять дело в реестр СУДиДЕЛО не требуется.

Что можно делать

  • Находить арбитражные дела организации или индивидуального предпринимателя по ИНН.
  • Получать сведения карточки дела КАД по его номеру, включая доступные события и ссылки на документы.
  • Искать судебные акты РАС по номеру дела или другой поисковой строке.
  • Получать исходные PDF КАД и РАС по ссылкам на документы и передавать их клиенту для сохранения.
  • Проверять сохранённое расписание заседаний и сведения об объявленных перерывах по номеру дела.
  • Получать группы судов, список арбитражных судов, сведения о судьях и контакты суда.

В версии 0.7.0 — десять инструментов. В чате их названия вводить не обязательно: опишите задачу своими словами. Сервер не изменяет данные CRM и не импортирует найденные дела. Поиск по ИНН, получение карточки КАД, поиск актов РАС и получение PDF могут запускать сбор или загрузку источника.

Что нужно для начала

  • Учётная запись СУДиДЕЛО с доступом к разделу арбитражных дел.
  • MCP-клиент с поддержкой удалённого Streamable HTTP, например LM Studio, и модель с поддержкой вызова инструментов.
  • Для входа через браузер — клиент с поддержкой такого способа авторизации.
  • Для ручного подключения — API KEY пользователя из раздела «Интеграция → API». См. как получить API KEY.
  • Доступ в Интернет. Сам MCP-сервер устанавливать на компьютер не требуется.

Какой адрес выбрать

Оба адреса предоставляют одинаковые инструменты и поддерживают вход через браузер и подключение по API KEY.

  • Для работы из России: https://mcp-arbitr-ru.torkndgov.ru/mcp-oauth — вход через браузер; https://mcp-arbitr-ru.torkndgov.ru/mcp — подключение по API KEY.
  • Для зарубежных сервисов: https://mcp-arbitr.torkndgov.ru/mcp-oauth — вход через браузер; https://mcp-arbitr.torkndgov.ru/mcp — подключение по API KEY.

Учитывайте место работы клиента, который обращается к MCP: для LM Studio на компьютере в России выбирайте адрес с -ru. Если выбранный адрес недоступен, попробуйте второй. При подключении по ключу API KEY остаётся прежним. После смены домена переподключите сервер; при браузерной авторизации выполните подключение заново.

Подключение в LM Studio

1. Откройте конфигурацию MCP

Откройте панель Integrations или Program справа и выберите Install → Edit mcp.json. Названия и расположение элементов зависят от версии приложения. В Windows файл обычно находится в %USERPROFILE%\.lmstudio\mcp.json. Перед изменением сохраните его копию.

Расположение элементов показано в инструкции LM Studio со скриншотами на примере ЕГРЮЛ. Для арбитражных судов используйте имя сервера и адреса из настоящей статьи. Также доступна официальная инструкция LM Studio.

2. Выберите способ подключения

Вход через браузер. Добавьте сервер с окончанием /mcp-oauth. Пример для работы из России:

{
  "mcpServers": {
    "sudodelo-arbitr": {
      "url": "https://mcp-arbitr-ru.torkndgov.ru/mcp-oauth"
    }
  }
}
  1. Сохраните настройки и включите интеграцию mcp/sudodelo-arbitr.
  2. Начните авторизацию, если клиент предложит её. В открывшемся браузере войдите в свой аккаунт СУДиДЕЛО и выполните дополнительное подтверждение, если оно запрошено.
  3. Проверьте название приложения и нажмите «Подключить».
  4. После успешной авторизации вернитесь в клиент и проверьте появление инструментов сервера.

Копировать API KEY при этом способе не требуется. Пароль вводится на странице СУДиДЕЛО в браузере; передавать его или API KEY сообщением в чат не нужно.

Ручное подключение по API KEY. Используйте адрес с окончанием /mcp и заголовок X-Sudodelo-Api-Key:

{
  "mcpServers": {
    "sudodelo-arbitr": {
      "url": "https://mcp-arbitr-ru.torkndgov.ru/mcp",
      "headers": {
        "X-Sudodelo-Api-Key": "YOUR_SUDODELO_API_KEY"
      }
    }
  }
}

Замените YOUR_SUDODELO_API_KEY ключом пользователя, сохранив двойные кавычки. Если другие серверы уже настроены, добавьте только запись sudodelo-arbitr внутрь существующего mcpServers, отделив её запятой. Для зарубежного клиента замените домен на mcp-arbitr.torkndgov.ru, сохранив окончание выбранного способа подключения.

Сохраните файл и переподключите интеграцию. При замене или отзыве API KEY обновите ручные настройки либо подключитесь через браузер заново. Замена общего ключа затрагивает другие приложения, которые использовали старый ключ.

3. Включите инструменты в чате

  1. Загрузите модель с поддержкой вызова инструментов.
  2. Включите интеграцию mcp/sudodelo-arbitr для текущего чата.
  3. Проверьте наличие десяти инструментов из списка ниже. Если клиент показывает старый каталог, переподключите сервер.
  4. Если клиент запрашивает подтверждение вызова, проверьте инструмент и передаваемый номер дела или ИНН, затем подтвердите действие.

Успешное подключение само по себе не подтверждает доступ к данным: для выполнения запросов нужны действующая авторизация и право арбитражного раздела.

Примеры запросов в чате

  • «Найди арбитражные дела по ИНН 7707083893 через sudodelo-arbitr. Укажи номера дел, суды и участников из полученного ответа».
  • «Получи карточку дела А50-21049/2026 и перечисли доступные события и ссылки на документы».
  • «Найди судебные акты по делу А15-12052/2025 и покажи даты, названия и ссылки».
  • «Проверь расписание заседаний по делу А66-5354/2026. Укажи дату обновления данных».
  • «Проверь перерывы по делу А40-12345/2026. Сообщи, полный ли кеш и нет ли устаревших записей».
  • «Найди Арбитражный суд Пермского края, покажи контакты и список судей».

Это примеры формулировок: подставьте нужный ИНН или номер дела. Наличие и полнота сведений зависят от источника. Проверяйте фактический вызов инструмента и его результат; текстовое сообщение модели само по себе не подтверждает выполнение запроса.

Инструменты сервера

Для судей и контактов сначала получите список судов и возьмите из него числовой id. Например, {"court_id":64} показывает только форму аргумента: используйте ID нужного суда из фактического ответа. Номер дела передавайте обычной строкой с символом /, без самостоятельного URL-кодирования. ИНН передаётся строкой из 10 или 12 цифр.

Получение PDF КАД и РАС

В версии 0.7.0 добавлен arbitr_pdf_skachat — PDF КАД и РАС. Передайте исходную HTTPS-ссылку на PDF целиком, включая query-параметры, без дополнительного кодирования. Карточка КАД и поиск актов возвращают ссылки; PDF получает отдельный инструмент. При успехе клиент получает имя, размер, SHA-256 и содержимое файла в base64. Сохранение на компьютер выполняет клиент; нужен полный, необрезанный результат.

По умолчанию MCP передаёт PDF до 5 МиБ. Public API может ждать загрузку до 15 минут; тайм-аут MCP — 960 секунд, рекомендуемое ожидание клиента — от 1100 секунд. После 504, сетевого тайм-аута или отмены задание может продолжаться. MCP не запускает повтор и не опрашивает статус автоматически; порядок проверки состояния и сохранения файла описан в инструкции инструмента.

Сколько ждать результат

  • Дела по ИНН: источник может вернуть кеш за 24 часа либо запустить сбор с ожиданием до 15 минут. Для MCP-клиента рекомендуется ожидание вызова от 1100 секунд; меньший лимит клиента или промежуточного сервиса может прервать запрос раньше.
  • Карточка КАД: при отсутствии готовых данных получение может занять несколько минут. Рекомендуемое ожидание клиента — от 300 секунд.
  • Акты РАС: источник ждёт около 30 секунд и возвращает имеющиеся данные, в том числе кеш или последний успешный результат.
  • Расписание, перерывы и справочник: читаются сохранённые данные; эти инструменты не запускают обновление источника.

Автоматических повторов нет. Отмена или тайм-аут вызова не гарантируют остановку сбора на стороне источника. Не запускайте подряд одинаковые длительные запросы, принимая тайм-аут за подтверждение отсутствия данных.

Как понимать результат

Успешный результат инструмента содержит разрешено: true и поле данные. При отказе возвращаются разрешено: false и пояснение в поле итог. Проверяйте эти поля: транспортное сообщение об успешном вызове не заменяет проверку результата.

  • Пустой ответ по ИНН, карточке дела или актам РАС не доказывает отсутствия дел или документов. Даже непустой ответ не гарантирует завершения сбора, полноты и свежести данных.
  • Пустое расписание означает отсутствие записей в доступном кеше. Проверяйте время обновления; в сохранённых данных могут быть повторы. Даты и часовые пояса сервер не преобразует.
  • Для перерывов found=true означает наличие записей. При meta.is_complete=false результат может быть неполным; status=cache_incomplete не позволяет подтвердить отсутствие перерывов. Поле matches[].is_stale=true отмечает устаревшую запись.
  • Названия истца и ответчика в найденных делах сами по себе не подтверждают совпадение их ИНН с поисковым запросом.
  • Контакты суда могут быть ещё не заполнены; отдельные поля могут иметь значение null.

Инструменты поиска и карточки возвращают сведения и ссылки; HTML источника остаётся данными. Для получения PDF по исходной ссылке используйте arbitr_pdf_skachat — PDF КАД и РАС. Передача файла инструментом не означает, что клиент уже сохранил его на компьютер.

Если что-то не работает

  • Сервер не подключается: проверьте URL и JSON, попробуйте второй адрес и переподключите интеграцию.
  • Не начинается вход через браузер: нужен адрес /mcp-oauth и клиент с поддержкой браузерной авторизации. Завершите вход и нажмите «Подключить».
  • Нет доступа к данным: проверьте право пользователя на арбитражный раздел. При ручной настройке замените плейсхолдер ключом и проверьте заголовок X-Sudodelo-Api-Key.
  • Модель не вызывает инструменты: включите интеграцию в текущем чате и выберите модель с поддержкой tool use.
  • Поиск прерывается по времени: учитывайте длительность поиска по ИНН и карточки КАД. Проверьте, допускает ли клиент рекомендованное ожидание.
  • Пустой или неполный ответ: проверьте номер дела, ИНН и метаданные кеша. Не делайте вывод об отсутствии дела, заседания или акта только по пустому результату.
  • Ошибка кеша перерывов: код 409 означает, что кеш ещё не готов. Ошибки 429, 502, 503 и 504 могут означать ограничение запросов, недоступность или тайм-аут сервиса.

Для диагностики доступны проверка основного адреса и проверка адреса для России. Ответ status: ok подтверждает работу процесса сервера, но не проверяет пользовательский ключ и получение данных.

Для программистов

Транспорт — stateful Streamable HTTP. Клиент инициализирует MCP-сессию и вызывает инструменты с авторизацией каждого запроса. При ручном подключении ключ передаётся в заголовке X-Sudodelo-Api-Key, а не в аргументах инструмента. Требуемое право — menu.monitoringresultlistarbitrcases.

Для прямой интеграции без MCP см. Swagger API СУДиДЕЛО: группы Arbitr, KadArbitr, RasArbitr, RadArbitr и RecessArbitr. Основные методы:

GET /api/KadArbitr/pdf?url={ИСХОДНЫЙ_URL_PDF}
GET /api/KadArbitr/cases-by-inn?inn={ИНН}
GET /api/KadArbitr/case-details?caseNumber={НОМЕР_ДЕЛА}
GET /api/RasArbitr/search?searchQuery={ПОИСКОВАЯ_СТРОКА}
GET /api/RadArbitr/data?caseNumber={НОМЕР_ДЕЛА}
GET /api/RecessArbitr/recesses/by-case?caseNumber={НОМЕР_ДЕЛА}
GET /api/Arbitr/groups
GET /api/Arbitr/courts
GET /api/Arbitr/courts/{courtId}/judges
GET /api/Arbitr/courts/{courtId}/contacts

Для прямых запросов Public API требуется параметр apiKey; параметры кодирует HTTP-клиент. Поиск по ИНН, карточка КАД и поиск РАС могут запускать сбор, несмотря на метод GET. Для Python MCP SDK при поиске по ИНН также задайте ClientSession(read_timeout_seconds=timedelta(seconds=1100)) и соответствующий тайм-аут вызова.

Если нужны операции с реестром дел, клиентами, договорами и другими данными CRM, смотрите описание основного MCP-сервера СУДиДЕЛО.