Directum RX

rxmcp: Directum RX MCP server

Directum RX MCP server. Connects an AI assistant (Claude, Cursor and any MCP host) to Directum RX: assignments, tasks, documents and their text, knowledge base, agile boards, project plans, any entity via OData, and search over the system help of your own RX version. Single binary, read-only by default. The rest of this page is in Russian; the tool list and settings are in server.json.

MCP-сервер для Directum RX. Подключает ИИ-ассистента (Claude Desktop, Claude Code, Cursor и любой другой хост с поддержкой Model Context Protocol) к вашей системе: задания, задачи, документы, база знаний, agile-доски, проекты и планы.

Работает от имени пользователя RX через штатный сервис интеграции (OData). Прав сверх ваших не получает, схему не меняет, в базу и логи RX не заглядывает.

Один бинарник без зависимостей: Linux, Windows, macOS (Intel и Apple Silicon).

Установка за две команды

curl -fsSL https://drxinfra.ru/dl/rxmcp/install.sh | sh   # или скачайте бинарник вручную

rxmcp setup

setup спросит адрес RX, логин и способ входа, проверит подключение только чтением и сам пропишет сервер в Claude Desktop, Claude Code и Cursor. Перезапустите клиент — в списке инструментов появится rx.

Без интернета и без скриптов: возьмите архив со страницы Releases, распакуйте, положите бинарник в PATH и запустите rxmcp setup. На macOS, если файл скачан браузером, система попросит снять карантин: xattr -d com.apple.quarantine rxmcp.

Где лежат настройки

В профиле ~/.config/rxmcp/config.json (Windows: %AppData%\rxmcp\config.json), права 0600. В конфиге ИИ-клиента остаётся только путь к бинарнику:

{ "mcpServers": { "rx": { "command": "/usr/local/bin/rxmcp" } } }

Так сделано, чтобы менять настройки одной командой, а не искать JSON клиента:

rxmcp config                                 # что настроено (секреты не печатаются)

rxmcp config set RXMCP_ALLOW_WRITE=1 # включить запись rxmcp config set RXMCP_TZ=Europe/Moscow # часовой пояс для дат rxmcp check # проверить связь с RX, только чтение

Переменные окружения имеют приоритет над профилем — в контейнере и в CI удобнее передавать их напрямую. Имена те же, полный список: rxmcp help.

Секреты в связке ключей ОС

Пароль, cookie, токены и сессию провайдера входа можно хранить не в файлах каталога настроек, а в связке ключей: Keychain на macOS, диспетчер учётных данных на Windows, Secret Service (GNOME Keyring, KWallet) на Linux. setup предлагает это сам, если связка доступна.

rxmcp secrets            # где лежат секреты и доступна ли связка ключей

rxmcp secrets keyring # перенести в связку ключей; перезапускать клиента не нужно rxmcp secrets file # вернуть в файлы 0600

В config.json после переноса остаются только несекретные настройки. На сервере Linux и в WSL без графического сеанса связки ключей нет, там секреты остаются в файлах. Что это защищает и что нет: docs/security.md.

Несколько систем RX

Один процесс rxmcp работает с одной системой. Для второй (тестовый стенд, другой заказчик) заведите отдельный каталог настроек:

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

setup пропишет второй сервер в клиенты под своим именем, например rx-test-company, и передаст ему RXMCP_HOME. Запись rx для основной системы останется как была. Профиль, cookie и сессия провайдера у каждой системы свои, в названии и описании сервера указан хост, поэтому помощник понимает, какую систему спрашивать. Остальные команды для второй системы запускаются с тем же RXMCP_HOME: RXMCP_HOME=~/.config/rxmcp-test rxmcp login.

Обновление

Раз в сутки rxmcp узнаёт, не вышла ли новая версия: спрашивает файл drxinfra.ru/dl/rxmcp/latest.txt, а если он недоступен, GitHub. Кроме номера своей версии в User-Agent ничего не отправляет. Если вышла, помощник скажет об этом один раз за сеанс, а rxmcp version и rxmcp check напишут строкой.

rxmcp update                              # скачать, сверить с SHA256SUMS, заменить бинарник

rxmcp config set RXMCP_UPDATE_CHECK=0 # не узнавать о новых версиях

После обновления перезапустите ИИ-клиент. Если rxmcp лежит в /usr/local/bin и ставился через sudo, обновлять тоже через sudo rxmcp update. В образе Docker проверка выключена: там версию меняют вместе с образом.

Вход в RX

Вход через провайдера без администратора: login --sso

Если RX пускает через Keycloak (или другой OIDC-провайдер), протокол OIDC выполняет сам сервер RX: браузер уходит к провайдеру, тот по живой сессии сразу возвращает код, RX выдаёт cookie sungero_client. rxmcp повторяет ту же цепочку со своей копией сессии провайдера. Пароль он не видит, отдельный клиент в провайдере не нужен.

rxmcp login --sso

Команда сама узнает адрес провайдера и попросит скопировать заголовок cookie со страницы личного кабинета провайдера (вы там уже вошли, пароль не спросят). Дальше, когда RX отвечает 401, rxmcp получает новую cookie и повторяет запрос сам. Входить в браузере заново нужно, только когда истекает сессия провайдера: это срок, который задал его администратор, обычно от нескольких часов до нескольких дней.

Сессия провайдера лежит в ~/.config/rxmcp/sso-<адрес RX>.json с правами 0600. Она открывает вход во все приложения этого провайдера, а не только в RX: храните её как пароль. Удалить: rxmcp logout. Если RX просит второй фактор, такой вход rxmcp не пройдёт и скажет об этом.

Cookie вручную

Cookie — обходной путь, зато без участия администратора. Сессия RX живёт недолго, поэтому обновление сделано в одну команду:

rxmcp login --paste    # взять cookie из буфера обмена

rxmcp login # вставить cookie в терминал и нажать Enter, или просто Enter, если она в буфере rxmcp login --stdin < cookie.txt # из файла или конвейера

Длинную cookie можно вставлять прямо в терминал: на время ввода rxmcp снимает предел длины строки (1024 символа в macOS, 4096 в Linux). В WSL --paste и Enter берут cookie из буфера обмена Windows через powershell.exe, так что копировать в браузере Windows можно как обычно.

Cookie лежит отдельным файлом и перечитывается на каждом запросе: перезапускать ИИ-клиент после обновления не нужно. Если сессия истекла, сервер так и скажет в ответе вместо непонятной ошибки.

Про oidc: rxmcp умеет и вход в браузере (authorization code + PKCE, локальный redirect), и device flow (код на экране, без открытого порта). Для этого администратору нужно один раз завести в вашем провайдере публичный клиент — без этого остаётся login --sso, cookie или password.

Что умеет

Чтение (всегда):

• rx_whoami — кто я в RX и кого сейчас замещаю (справочник «Замещения»).
• rx_my_assignments — задания в работе, просроченные, непрочитанные, выполненные; уведомления. С include_substituted=true добавляет задания тех, кого вы замещаете: это нужно помощнику руководителя и тому, кто подменяет коллегу в отпуске. Чужие строки помечены «за <ФИО>».
• rx_get_assignment, rx_get_task, rx_list_tasks — карточки с перепиской, вложениями и заданиями.
• rx_whats_new — что нового с прошлого раза: пришедшие задания и уведомления, что горит сегодня, какие мои задачи завершились. include_substituted=true добавляет задания и уведомления тех, кого вы замещаете.
• rx_find_documents, rx_get_document, rx_get_document_text — поиск, карточка, текст версии (docx, xlsx, pptx, pdf, txt, md, csv, json, xml, html, rtf). Сканы и документы-картинки приходят изображениями страниц, текст с них читает сам помощник.
• rx_find_employees — найти сотрудника, чтобы адресовать задачу.
• База знаний: rx_kb_areas, rx_kb_search, rx_kb_article (статья в markdown).
• Agile-доски: rx_boards, rx_board, rx_tickets, rx_ticket (карточка со связями и комментариями; скриншоты из описания, комментариев и вложений приходят картинками), rx_ticket_file (вложение по номеру: docx, xlsx, pdf, txt, json, логи; список и файлы внутри zip и tar.gz, поиск строк по grep), rx_ticket_relations (связи нескольких карточек: родитель и дочерние, «зависит от», дубли, «связана с»), rx_ticket_history (история карточки: кто и когда создал, двигал по колонкам, менял срок, план и факт, исполнителей, теги, закрыл).
• Проекты: rx_projects, rx_project (карточка с контрольными точками и числом рисков), rx_project_risks (реестр рисков проекта), rx_project_plans, rx_project_plan (дерево работ, ответственные, просрочки).
• Справка системы: rx_help_search, rx_help_topic, rx_help_toc. Помощник отвечает на «как настроить» и «что значит это поле» по справке вашей версии RX и называет статью.
• Любая сущность: rx_find_entity (поиск по русскому или английскому названию), rx_describe_entity (поля и ссылки), rx_query (чтение по условию). Для данных, под которые нет готового инструмента: договоры, контрагенты, справочники, доработки заказчика.

Запись (только при RXMCP_ALLOW_WRITE=1, иначе инструменты не видны модели):

• rx_create_ticket — карточка на доске: колонка, срок, приоритет, план и факт в часах, теги, исполнители, вложения.
• rx_update_ticket — изменить карточку (в том числе план и факт в часах), перенести её в другую колонку, добавить вложения: ссылку, документ RX по Id или файл с диска (до 20 МБ). Поля, которые не передали, остаются как были, карточка остаётся на своём месте в колонке.
• rx_comment_ticket — добавить комментарий к карточке. Существующие комментарии с Id, авторами и временем показывает rx_ticket.
• rx_edit_comment, rx_delete_comment — исправить или удалить свой комментарий. Чужие не трогает.
• rx_delete_tickets — удалить карточки с доски, как удаление в интерфейсе доски: карточка получает статус Deleted (до 100 за раз).
• rx_create_column — колонка на доске: название, место, финальная, лимит карточек. Без места встаёт перед «Выполнено».
• rx_create_risks, rx_update_risk — занести риски в реестр рисков проекта пачкой (до 30 за вызов) и править их: статус, описание, планы предотвращения и устранения последствий, вероятность, влияние, категория, ответственный. Импорта рисков в RX нет, так сгенерированный реестр не переносится руками.
• rx_create_gates, rx_update_gate — контрольные точки (цели проекта): создать пачкой и добавить в карточку проекта, поменять даты и прогноз, отметить достижение.
• rx_complete_assignment — выполнить задание: завершить, принять работы, согласовать (в том числе с замечаниями) или вернуть на доработку, отметить ознакомление. Результат подбирается по типу задания. Задание, пришедшее по замещению, выполняется за исполнителя, и подтверждение об этом говорит. Задания на подписание не выполняет: подпись ставится только в RX.
• rx_send_for_acquaintance — отправить документ на ознакомление сотрудникам.
• rx_send_for_approval — отправить документ на согласование: свободное с указанными людьми или по регламенту, по правилу RX.
• rx_create_article, rx_update_article — создать статью базы знаний в markdown или изменить её; новый текст ложится новой версией.
• rx_create_simple_task — создать и о