MCP сервер для юристов и адвокатов

MCP-сервер СУДиДЕЛО позволяет работать с вашей юридической CRM через нейросети и ИИ-агенты (например, Cursor, Claude Desktop и другие клиенты с поддержкой MCP). Вы общаетесь обычным языком — «покажи мои дела», «добавь заседание», «найди клиента» — а помощник выполняет действия в программе от вашего имени.

Отдельные REST-запросы и технические адреса писать не нужно: сервер понимает термины СУДиДЕЛО (реестр дел, карточка, клиенты, договоры, претензии и т.д.).

Для получения PDF-выписок по ИНН используйте отдельный MCP-сервер для ЕГРЮЛ и ЕГРИП — egrul.nalog.ru. В инструкции описаны подключение, передача ключа доступа и скачивание выписок для юридических лиц и ИП без добавления в мониторинг.

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

На рабочем сервере доступен полный набор разделов программы. Через чат с ИИ можно, в частности:

• Судебные дела — реестр, карточка дела, стадии, заседания, участники, контакты, чат по делу, процессуальные документы, доказательства, прикреплённые файлы, создание дела;
• Клиенты и договоры — списки, карточки, создание и изменение;
• Контрагенты — физические лица, юридические лица, ИП;
• Претензии, исполнительные производства, доверенности;
• Моя организация — сотрудники, организации, подразделения;
• Календарь, задачи, уведомления, проекты, бюджеты;
• Документооборот;
• Бухгалтерия и биллинг;
• Мониторинг компаний и поиск в ФССП;
• Справочники организации.

Набор инструментов большой (сотни операций по разделам СУДиДЕЛО). Конкретный список в клиенте зависит от того, какие разделы включены на сервере. На публичном рабочем endpoint сейчас включены все основные домены.

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

• Учётная запись в СУДиДЕЛО.рф;
• Ключ доступа (API KEY) вашего пользователя — его можно посмотреть в программе в разделе «Интеграция — API»;
• MCP-клиент с поддержкой протокола Streamable HTTP (например, Cursor).

Ключ доступа привязан к вашему пользователю и организации: ИИ видит и меняет только те данные, к которым у вас есть права в системе.

Адрес рабочего сервера

• MCP endpoint: https://mcp-sudodelo.torkndgov.ru/mcp
• Проверка «сервер жив»: https://mcp-sudodelo.torkndgov.ru/health

Endpoint публичный: отдельный пароль шлюза не нужен. Без вашего ключа доступа данные CRM недоступны — это ожидаемое поведение.

Подключение из России

Для работы из России используйте запасной адрес, если основной сервер не открывается или доступен только через VPN: https://mcp-sudodelo-ru.torkndgov.ru/mcp.

Это тот же MCP-сервер СУДиДЕЛО с теми же инструментами и правами доступа. В настройках MCP-клиента замените только значение url на запасной адрес. Заголовок X-Sudodelo-Api-Key и ваш ключ доступа оставьте прежними; новый ключ получать не нужно. Основной адрес сохраняется.

После замены адреса переподключите сервер или перезапустите MCP-клиент. Для проверки соединения откройте https://mcp-sudodelo-ru.torkndgov.ru/health: при доступном сервере он возвращает статус ok. Адрес /health предназначен только для проверки; в настройках MCP указывайте адрес, заканчивающийся на /mcp.

Подключение в агенте ИИ

Добавьте сервер в конфигурацию MCP клиента (файл mcp.json). Подставьте свой ключ вместо плейсхолдера:

{
  "mcpServers": {
    "sudodelo": {
      "url": "https://mcp-sudodelo.torkndgov.ru/mcp",
      "headers": {
        "X-Sudodelo-Api-Key": "<ваш ключ доступа СУДиДЕЛО>"
      }
    }
  }
}

После сохранения перезапустите MCP / клиент и убедитесь, что сервер «sudodelo» отображается в списке подключённых.

Как передать ключ доступа

Доступны несколько способов (достаточно одного):

1. Заголовок X-Sudodelo-Api-Key в настройках MCP-клиента — предпочтительный вариант;
2. Фраза в чате: «Мой ключ доступа СУДиДЕЛО: …» — помощник сохранит ключ в текущей сессии (в ответах ключ показывается только в маске);
3. Инструмент получения ключа по email и паролю (логин как при входе в систему) — пароль не сохраняется.

Не публикуйте ключ в открытых чатах и не передавайте его третьим лицам. При компрометации обратитесь в поддержку для перевыпуска.

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

• «Покажи список моих судебных дел»;
• «Открой карточку дела А40-12345/2024 и перечисли ближайшие заседания»;
• «Найди клиента по названию … и покажи связанные договоры»;
• «Добавь в дело заметку в чат: …»;
• «Какие задачи на этой неделе?»;
• «Найди исполнительные производства по ИНН … в ФССП».

Формулируйте запросы так же, как объясняли бы коллеге в офисе: названия разделов и полей — как в интерфейсе СУДиДЕЛО.

Как устроена работа

1. Вы пишете запрос в чате ИИ-клиента;
2. Клиент вызывает инструменты MCP-сервера СУДиДЕЛО;
3. Сервер обращается к вашим данным в системе от имени вашего ключа доступа;
4. Ответ приходит на языке программы (без лишнего технического жаргона).

Внутри MCP также есть встроенная краткая справка по разделам (ресурсы sudodelo://spravka/…) — агент может опираться на неё, чтобы отвечать терминами продукта.

Важные ограничения

• Нужен ключ доступа пользователя; без него операции с данными не выполняются;
• Права те же, что у вас в веб-интерфейсе — лишнего ИИ не «откроет»;
• Длинные списки возвращаются постранично (размер страницы ограничен);
• Ключ, введённый только в чате, хранится в сессии сервера и сбрасывается при перезапуске сервиса — надёжнее держать ключ в настройках клиента;
• Сервер рассчитан на устойчивую сессию одного процесса; это облачный сервис СУДиДЕЛО, отдельно разворачивать его не требуется.

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

1. Проверьте адрес /health выбранного сервера: основного или запасного для подключения из России. Должен быть ответ со статусом ok;
2. Убедитесь, что в клиенте указан правильный URL …/mcp и ваш ключ в заголовке;
3. Спросите в чате статус ключа доступа или задайте ключ заново;
4. Если инструмент отвечает отказом на русском — сначала проверьте права пользователя в организации и сам ключ, а не «поломку» MCP.

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

Если нужна прямая интеграция без ИИ-агента — используйте открытое API системы. Описание для разработчиков: Открытое API системы СУДиДЕЛО. Ключ доступа тот же, что для MCP.

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