MCP-сервер для Directum RX: как подключить Claude или Cursor и что помощник увидит в системе
Что такое MCP-сервер для Directum, почему он работает с RX и не работает с Directum 5, как за две команды подключить Claude Desktop, Claude Code или Cursor, что помощник умеет (сканы, согласование, ознакомление, база знаний), под чьими правами действует и как дать ему задания руководителя.
Коротко. 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 держит его в своём файле, в конфиге клиента остаётся только путь к программе.
- Не отправлять конфиденциальные документы в облачный сервис без решения компании на этот счёт.
Похожая картина у вас?
Разберём ваш контур за 30 минут бесплатного созвона: версия RX, состав сервисов, что болит сильнее всего.
Написать