Коротко. MCP-сервер это переходник между ИИ-помощником и системой. Для Directum RX есть открытый rxmcp: он работает через штатный сервис интеграции RX, а с Directum 5 не работает. Подключается двумя командами к Claude Desktop, Claude Code и Cursor, по умолчанию только читает, в том числе сканы, и видит ровно то, что видит ваша учётная запись. С включённой записью отправляет документы на согласование и ознакомление, выполняет задания и ведёт базу знаний, но подписи не ставит. Задания руководителя помощник увидит, если работает под учёткой руководителя или ассистента с замещением.

Хочется, чтобы ИИ-помощник отвечал по вашей системе: что у меня просрочено, о чём этот договор, что горит на доске проекта. Для этого помощнику нужен доступ к Directum, и стандартный способ его дать называется MCP-сервер. Рассказываем, что это такое, с какими версиями Directum работает, как подключить его за две команды, что помощник умеет делать и как не выдать ему лишних прав.

Что такое MCP-сервер

MCP (Model Context Protocol) это открытый протокол, по которому ИИ-помощник подключается к внешним системам. Сам помощник ничего не знает о вашем Directum. MCP-сервер работает переходником: получает от помощника запрос вроде «найди мои просроченные задания», идёт в систему под вашей учётной записью и возвращает ответ.

Протокол поддерживают Claude Desktop, Claude Code, Cursor, VS Code и другие клиенты, так что один сервер подходит ко всем.

Для Directum RX такой сервер есть в открытом доступе, это rxmcp. Мы его сделали и отдаём бесплатно, код лежит на GitHub. Дальше рассказываем на его примере.

RX или Directum 5

Частый вопрос из поиска: есть ли MCP для Directum 5.7. rxmcp работает через штатный сервис интеграции Directum RX. Это OData-интерфейс, он есть в RX 4.x, 25.x и 26.x. У Directum 5 другая платформа и другой способ интеграции, поэтому с ним rxmcp не работает. Если вы на пятой версии и планируете переход на RX, подключение ИИ удобно закладывать уже в новую систему. Что можно сделать, пока система на пятой версии, разобрано в статье MCP для Directum 5.

Как подключить

Нужны адрес вашего Directum RX и ваш логин. Права администратора не нужны.

curl -fsSL https://drxinfra.ru/dl/rxmcp/install.sh | sh
rxmcp setup

Первая команда ставит программу на macOS или Linux, для Windows на странице rxmcp лежит архив. Вторая спрашивает адрес, логин и способ входа, проверяет связь с системой только чтением и сама прописывает сервер в Claude Desktop, Claude Code и Cursor. После перезапуска клиента в списке инструментов появится rx.

Вход в RX в разных компаниях устроен по-разному, и под каждый случай есть свой вариант:

  • Логин и пароль, если в RX включён вход по паролю. Пароль вводится один раз и хранится в файле настроек rxmcp с правами только для владельца. В конфиг помощника он не попадает.
  • Сессия Keycloak, если RX пускает через Keycloak или другой провайдер единого входа. Один раз выполняете rxmcp login --sso, дальше rxmcp сам получает новую сессию RX, пока жива сессия провайдера. Администратор для этого не нужен.
  • Cookie из браузера, если остальное не подходит. Входите в RX как обычно, копируете cookie и выполняете rxmcp login: значение можно вставить прямо в терминал или взять из буфера обмена. Перезапускать помощника после обновления cookie не нужно.
  • OIDC, если администратор завёл для rxmcp клиента в вашем провайдере. Вход идёт в браузере, и пароль rxmcp не видит.

Если клиент не показывает окно подтверждения действий и каждое действие заканчивается отменой, команда rxmcp config set RXMCP_CONFIRM=0 выключает это окно. Подтверждением тогда служит разрешение на вызов инструмента в самом клиенте. Мы встречали такое поведение в VS Code.

Что помощник умеет

Видит он ровно то, что видит учётная запись, под которой работает. rxmcp ходит в систему через тот же сервис интеграции, что и любые другие интеграции, и прав сверх ваших не получает.

По умолчанию помощник только читает:

  • задания и задачи с перепиской и вложениями, а ещё сводку «что нового с прошлого раза»: пришедшие задания, что горит сегодня, какие ваши задачи завершились;
  • документы и их текст: Word, Excel, PowerPoint, PDF;
  • сканы и документы-картинки: rxmcp отдаёт помощнику изображения страниц, текст с них читает сама модель;
  • сотрудников, базу знаний, agile-доски, проекты и планы;
  • справку системы той же версии, что у вас: на вопросы «как настроить» помощник отвечает по ней и называет статью;
  • любые справочники и доработки через каталог сущностей, тоже только чтением.

Запись включается отдельно командой rxmcp config set RXMCP_ALLOW_WRITE=1. Тогда помощник умеет:

  • выполнять задания: завершить, принять работы, согласовать (в том числе с замечаниями) или вернуть на доработку, отметить ознакомление;
  • отправлять документ на ознакомление сотрудникам и на согласование, свободное или по регламенту;
  • отправлять простые задачи и прекращать их;
  • создавать и править статьи базы знаний;
  • заводить и менять карточки на досках, прикладывать к ним файлы и документы, оставлять комментарии и править свои.

Перед каждым действием записи помощник пересказывает, что именно сделает, и спрашивает подтверждение. Удалять документы, менять права и ставить подписи он не умеет вообще. Задания на подписание остаются за человеком: подпись в RX бывает квалифицированной, и ставить её должен владелец сертификата.

Как дать помощнику задания руководителя

Ещё один вопрос из поиска: как дать помощнику доступ к задачам руководителя в Directum RX. Здесь бывают два разных помощника.

Если речь о человеке, например об ассистенте руководителя, доступ к его заданиям дают штатными средствами RX, обычно через замещение. Настраивает это администратор системы или ответственный за неё, сторонние программы для этого не нужны.

Если речь об ИИ-помощнике, правило то же, что для людей: он видит то, что видит учётная запись. Честных вариантов два. Руководитель подключает помощника под своей учётной записью на своём компьютере, и тот видит его задания. Или помощник работает под учётной записью ассистента, которому в RX уже выдано замещение или права на нужные задачи. В обоих случаях понятно, от чьего имени сделано каждое действие. Подробно, с настройкой замещения и запросом для заданий руководителя: ИИ-помощник для ассистента руководителя.

Заводить для ИИ отдельную сервисную учётную запись с полными правами «чтобы видел всё» или отдавать ему пароль руководителя не стоит. В первом случае помощнику открыта вся система без разбора, во втором уже не понять, кто что сделал.

Несколько систем и обновления

Если систем несколько, например рабочая и тестовая, каждой заводится свой каталог настроек:

RXMCP_HOME=~/.config/rxmcp-test rxmcp setup

Вторая система появится в клиенте отдельным сервером со своим именем, первая останется как была. В названии сервера виден адрес системы, поэтому помощник понимает, какую спрашивать.

Раз в сутки rxmcp проверяет, не вышла ли новая версия, и помощник один раз скажет об этом. Обновление одной командой rxmcp update: архив сверяется с контрольной суммой, после этого достаточно перезапустить клиент.

Куда уходят данные

rxmcp у себя хранит только настройки и данные для входа. Документы и задания он читает из RX и передаёт помощнику, а дальше текст и изображения страниц попадают в тот ИИ-сервис, к которому вы подключились. Для конфиденциальных документов это важно: либо работа с облачным сервисом согласуется на уровне компании, либо используется локальная модель внутри закрытого контура. rxmcp работает с любым клиентом, который поддерживает MCP, в том числе с локальными. Подробнее о том, что может утечь и как это закрыть настройками, в разборе ИИ-помощник и СЭД: что уходит наружу.

Чего не делать

  • Не включать запись всем сразу. Начните с чтения, а запись включайте тем, кому она действительно нужна.
  • Не давать помощнику сервисную учётку с полными правами. Он должен видеть то же, что человек, от чьего имени работает.
  • Не класть пароль в конфиг ИИ-клиента. rxmcp держит его в своём файле, в конфиге клиента остаётся только путь к программе.
  • Не отправлять конфиденциальные документы в облачный сервис без решения компании на этот счёт.