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"
}
}
}
- Сохраните настройки и включите интеграцию
mcp/sudodelo-arbitr. - Начните авторизацию, если клиент предложит её. В открывшемся браузере войдите в свой аккаунт СУДиДЕЛО и выполните дополнительное подтверждение, если оно запрошено.
- Проверьте название приложения и нажмите «Подключить».
- После успешной авторизации вернитесь в клиент и проверьте появление инструментов сервера.
Копировать 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. Включите инструменты в чате
- Загрузите модель с поддержкой вызова инструментов.
- Включите интеграцию
mcp/sudodelo-arbitrдля текущего чата. - Проверьте наличие десяти инструментов из списка ниже. Если клиент показывает старый каталог, переподключите сервер.
- Если клиент запрашивает подтверждение вызова, проверьте инструмент и передаваемый номер дела или ИНН, затем подтвердите действие.
Успешное подключение само по себе не подтверждает доступ к данным: для выполнения запросов нужны действующая авторизация и право арбитражного раздела.
Примеры запросов в чате
- «Найди арбитражные дела по ИНН 7707083893 через sudodelo-arbitr. Укажи номера дел, суды и участников из полученного ответа».
- «Получи карточку дела А50-21049/2026 и перечисли доступные события и ссылки на документы».
- «Найди судебные акты по делу А15-12052/2025 и покажи даты, названия и ссылки».
- «Проверь расписание заседаний по делу А66-5354/2026. Укажи дату обновления данных».
- «Проверь перерывы по делу А40-12345/2026. Сообщи, полный ли кеш и нет ли устаревших записей».
- «Найди Арбитражный суд Пермского края, покажи контакты и список судей».
Это примеры формулировок: подставьте нужный ИНН или номер дела. Наличие и полнота сведений зависят от источника. Проверяйте фактический вызов инструмента и его результат; текстовое сообщение модели само по себе не подтверждает выполнение запроса.
Инструменты сервера
arbitr_pdf_skachat(url)— kad.arbitr.ru и ras.arbitr.ru — получение конкретного PDF по исходной HTTPS-ссылке. Подробнее — в отдельной инструкции.arbitr_dela_po_inn_poluchit(inn)— kad.arbitr.ru — поиск дел КАД по ИНН. Аргументы:{"inn":"7707083893"}.arbitr_kartochka_dela_poluchit(case_number)— kad.arbitr.ru — сведения карточки КАД. Аргументы:{"case_number":"А50-21049/2026"}.arbitr_sudebnye_akty_poisk(search_query)— ras.arbitr.ru — поиск актов РАС. Аргументы:{"search_query":"А15-12052/2025"}. Допускается и другая непустая поисковая строка.arbitr_raspisanie_po_delu_poluchit(case_number)— rad.arbitr.ru — расписание по делу. Аргументы:{"case_number":"А66-5354/2026"}.arbitr_pereryvy_po_delu_poluchit(case_number)— recess.arbitr.ru — перерывы по делу. Аргументы:{"case_number":"А40-12345/2026"}.arbitr_gruppy_poluchit()— arbitr.ru — группы арбитражных судов. Аргументы:{}.arbitr_sudy_poluchit(group_code)— arbitr.ru — все суды или суды выбранной группы. Аргументы:{}либо{"group_code":"t3"}; допустимые коды —t2,t3,t4,t5.arbitr_sudi_poluchit(court_id)— официальные сайты арбитражных судов — судьи выбранного суда.arbitr_kontakty_poluchit(court_id)— официальные сайты арбитражных судов — контакты выбранного суда.
Для судей и контактов сначала получите список судов и возьмите из него числовой 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-сервера СУДиДЕЛО.