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

4 дня назад
СУДиДЕЛО.рф
1 минута

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

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

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

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

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

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

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

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

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

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

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

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

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

Добавьте сервер в конфигурацию 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. Проверьте https://mcp-sudodelo.torkndgov.ru/health — должен быть ответ со статусом ok;
  2. Убедитесь, что в клиенте указан правильный URL …/mcp и ваш ключ в заголовке;
  3. Спросите в чате статус ключа доступа или задайте ключ заново;
  4. Если инструмент отвечает отказом на русском — сначала проверьте права пользователя в организации и сам ключ, а не «поломку» MCP.

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

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

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