AI-агенты (MCP и CLI)

RentProg открывает данные вашей компании AI-агентам (Claude, ChatGPT, Claude Code, Cursor, Codex и любым MCP-клиентам) через протокол MCP. Агент работает от вашего имени и подключается одним из двух способов:

  • Коннектор по OAuth — для claude.ai, Claude Desktop, Claude Code с плагином RentProg и ChatGPT. Ключ не нужен: вы входите в RentProg и на экране согласия выбираете доступ по областям. Пошагово — в статье «Подключение коннектора RentProg в Claude и ChatGPT (OAuth)» в этом же разделе.
  • Персональный ключ — для CLI RentProg, Cursor, Codex и других клиентов, которые не умеют OAuth. Об этом способе — разделы 1, 4 и 5 этой статьи.

Что агенту доступно, вы выбираете отдельно по каждой области — при выпуске ключа или на экране согласия. Агент никогда не получает больше ваших прав: те же филиалы, те же записи, те же поля, что вы видите в интерфейсе.

1. Ключ агента

Услуга «MCP для AI-агентов» должна быть включена в тарифе вашей компании. Если на вкладке ключей написано, что услуга не включена, напишите в поддержку RentProg.

  1. Откройте Профиль → вкладка «Ключи для AI-агентов».
  2. Нажмите «Создать ключ» и задайте название (например, «Claude Code — ноутбук»).
  3. Выберите доступ по областям (раздел 2) и нажмите «Создать».
  4. Скопируйте ключ: он начинается с rpa_ и показывается один раз. На той же вкладке указан адрес MCP-сервера для вашей компании — он понадобится при подключении.

Одновременно активно не более 5 ключей на сотрудника, срок действия — 1 год. Отозвать ключ можно на той же вкладке в любой момент, отозванный перестаёт работать сразу. Партнёрам и агентам (внешним ролям) ключи не выпускаются. Каждый вызов инструмента записывается в журнал: кто, какой инструмент, когда, результат.

На той же вкладке есть подсказка, какой коннектор добавить в Claude и ChatGPT, и два списка: «Подключённые приложения» (подключения по OAuth) и ваши ключи. Отозванное приложение или ключ теряет доступ на следующем обращении к RentProg. Superadmin видит в обоих списках доступы всех сотрудников группы компаний.

Куда уходят данные. Всё, что видит ключ или подключённое приложение, включая персональные данные клиентов, агент передаёт AI-сервису, который вы подключаете (Claude, ChatGPT и другие). Сервис выбирает ваша компания, и за передачу ему данных она отвечает как оператор персональных данных: проверьте, что такая передача допустима по законам вашей страны и вашим договорам с клиентами. Если персональные данные клиентов агенту не нужны, выпустите ключ сотруднику с ролью guest и выберите для CRM «Нет доступа»: guest не видит ФИО, телефоны и другие данные клиентов-физлиц, а лиды и переписка CRM содержат контакты клиентов для любой роли.

2. Доступ по областям

Ключ получает доступ к четырём областям, для каждой — своя ступень:

ОбластьЧто в неё входит
CRMлиды, воронка, переписка с клиентами (в том числе Teletype), задачи CRM
Автопарк и бронированиябронирования, машины, клиенты, расписание, штрафы, документы бронирований, склад и допы, выкуп, телематика, маркетплейсы, такси, задачи, личные дела и чек-листы
Деньгиплатежи и кассы, переводы, долги, счета, депозиты, инвесторы, контрагенты, деньги за период, экономика парка, работа сотрудников, подозрительные операции
Сотрудникисотрудники и агенты, их балансы, смены и шаблоны смен, оценки
СтупеньЧто может агент
Нет доступане видит область
Чтениетолько смотрит данные
Запись с одобрениемготовит изменение, а выполняется оно только после вашего одобрения (раздел 7)
Запись с предпросмотромсначала получает итог изменения (например, текст ответа клиенту) и затем подтверждает его сам; итог действует 10 минут
Запись сразувносит изменение сразу, без предпросмотра и подтверждения

Те же области и ступени выбираются на экране согласия при подключении коннектора. По умолчанию новый ключ только читает: CRM, автопарк и деньги — «Чтение», сотрудники — «Нет доступа». Ступени выше разрешённых вашей роли в окне не показываются. Если вашу роль или права потом урежут, ключ сразу работает в пределах новых прав. Для денег рекомендуем «Запись с одобрением», для CRM — «Запись с предпросмотром». Сочетание «CRM — чтение» и «Деньги — запись сразу» опасно: сообщение клиента может подтолкнуть агента к платежу, окно выпуска об этом предупредит.

Ключи, выпущенные до появления выбора по областям, помечены «Только чтение, прежний формат»: они видят прежние 16 инструментов без CRM. Чтобы получить новые инструменты, перевыпустите ключ.

3. Установка плагина в Claude Code

В Claude Code выполните:

/plugin marketplace add RentProg/rentprog-claude-plugin
/plugin install rentprog@rentprog

Плагин версии 3.0.0 и новее спрашивает только адрес MCP (возьмите его в профиле RentProg на вкладке «Ключи для AI-агентов»). Ключ плагину не нужен: откройте /mcp, выберите сервер rentprog и пройдите вход и согласие RentProg в браузере. Проверка: /mcp показывает сервер rentprog со списком инструментов. Если у вас стоял плагин 2.x с ключом, обновите плагин; ключ, который больше нигде не используется, отзовите на вкладке.

Подключить Claude Code без плагина можно и ключом: claude mcp add --transport http rentprog адрес_MCP_из_профиля --header "Authorization: Bearer rpa_ваш_ключ".

Готовые сценарии (skills): утренний бриф, должники, загрузка парка, досье клиента, сводка за период — например, /rentprog:morning-brief. Можно спрашивать и своими словами: «что у меня сегодня на выдачу», «кто должен больше пяти дней», «какие лиды ждут ответа». Каждая запись в ответе содержит ссылку на карточку в RentProg. Репозиторий плагина: github.com/RentProg/rentprog-claude-plugin.

4. Другие MCP-клиенты

Сам сервер — обычный MCP поверх HTTP: подойдёт любой клиент, который позволяет задать заголовок запроса. Отдельная учётная запись и настройка на нашей стороне не нужны, ключ тот же.

Cursor. Создайте в проекте файл .cursor/mcp.json (или ~/.cursor/mcp.json — для всех проектов):

{
  "mcpServers": {
    "rentprog": {
      "url": "адрес_MCP_из_профиля",
      "headers": { "Authorization": "Bearer rpa_ваш_ключ" }
    }
  }
}

Перезагрузите список MCP-серверов в настройках Cursor — сервер rentprog появится с теми же инструментами, что и в Claude Code. Готовые сценарии (skills) — это команды Claude Code, в Cursor их нет: спрашивайте своими словами, описания инструментов самодостаточны. Файл с ключом не кладите в репозиторий; если он всё же утёк, отзовите ключ на вкладке.

ChatGPT в чате подключается коннектором по OAuth (статья «Подключение коннектора RentProg в Claude и ChatGPT (OAuth)»). ChatGPT в режиме агента с терминалом работает через CLI RentProg с ключом (раздел 5). Codex подключает сервер так же, как Cursor: codex mcp add rentprog --url адрес_MCP_из_профиля --bearer-token-env-var RENTPROG_API_KEY, ключ — в переменной окружения RENTPROG_API_KEY; можно и через CLI.

Для любого клиента: адрес MCP — из профиля (вкладка «Ключи для AI-агентов»), заголовок Authorization: Bearer rpa_… (Streamable HTTP). Лимиты на ключ считаются раздельно: чтение — 60 вызовов в минуту и 1000 в час, изменения — 20 в минуту и 300 в час.

5. CLI для агентов с терминалом

Агентам, которые выполняют команды в терминале (ChatGPT в режиме агента, Codex и похожие), RentProg даёт CLI — программу командной строки @rentprog/cli. CLI работает по персональному ключу. Каждый инструмент из разделов 6 и 7 — это команда CLI; доступ тот же, что у ключа.

  1. Выпустите ключ (раздел 1). В окне с ключом скопируйте команду для агентов с терминалом: в ней уже есть ключ и адрес MCP вашей компании.
  2. Передайте команду агенту или выполните её в его терминале. Нужен Node.js 20.18 или новее — в ChatGPT он уже есть. Команда проверяет ключ, показывает владельца ключа и его уровни и сохраняет настройки.
  3. Дальше агент работает командами: npx -y @rentprog/cli@0 tools — что умеет ключ, npx -y @rentprog/cli@0 help list_bookings — аргументы инструмента, npx -y @rentprog/cli@0 list_bookings --active — вызов.

Для агента CLI отвечает в JSON, для человека в терминале — таблицей; --format csv — выгрузка, --all — все страницы списка. Изменения идут по ступеням ключа: при предпросмотре CLI показывает итог и применяет его только после подтверждения — флагом --yes, ответом «y» в терминале или командой продолжения, которую CLI печатает; при одобрении --wait ждёт вашего решения в RentProg. Код завершения подсказывает агенту следующий шаг: 0 — готово, 10 — ждёт одобрения, 11 — показан предпросмотр, 3 — отказ, 4 — повторить позже.

Codex по умолчанию запускает команды без сети: выполните вход вне его песочницы и разрешите сеть для команд CLI. Ключ CLI хранит в файле настроек, доступном только вам; если ключ мог утечь, отзовите его на вкладке. Описание и исходный код: github.com/RentProg/rentprog-cli.

6. Что агент умеет смотреть

Чтение повторяет экраны RentProg: агент видит то же, что вы на этих экранах, в пределах вашей роли и уровней ключа. В скобках — названия инструментов: они пригодятся, если вы подключаете агента вручную или хотите попросить о чём-то конкретном.

  • Общее: филиалы с их временем и справочники компании (company_reference); владелец ключа и уровни ключа по областям (whoami); результат операции, которая ждёт одобрения или выполняется в фоне (operation_status).
  • Бронирования: списки экрана бронирований и календарь занятости (list_bookings, occupancy); поиск по номеру, машине, клиенту и телефону (search_bookings); карточка, история изменений, фото выдачи и возврата (get_card, booking_history, booking_photos); выдачи и возвраты на даты, просроченные возвраты (schedule); бронирования агента (agent_bookings).
  • Автопарк: список машин и поиск по каталогу (list_cars, search_cars); свободные машины на даты с ценой (availability_quote); состояние парка сейчас, простой и регламенты (fleet_status); карточка машины, осмотры, ремонты и файлы (get_card, car_details, car_files); сервисные платежи (service_payments); телематика (telematics); склад и допы (store); такси Яндекс Про (taxi).
  • Клиенты: поиск и карточка (search_clients, get_card); сводка перед звонком — история аренд, долги, штрафы, истекающие документы (client_dossier); файлы клиента (client_file_download); проверка надёжности (client_checks); онлайн-платежи клиента (provider_payments).
  • Штрафы, дела и журнал: штрафы экрана и за период (list_fines, fines); задачи, личные дела и чек-листы (tasks, todos, check_lists); журнал действий сотрудников с поиском по тексту (action_log); лента изменений (recent_changes); выкуп (rent_to_own_contracts); шаблоны сообщений (message_templates).
  • Деньги: журнал платежей и касса сотрудника (payments, cashboxes); долги по бронированиям и экран долгов (receivables, list_debts); счета и печатная форма счёта (list_invoices, invoice_print); деньги за период, экономика парка, работа сотрудников, подозрительные операции (money_report, fleet_economics, staff_performance, anomalies); инвесторы и их аналитика (list_investors, investor_analytics); контрагенты (contractors).
  • CRM: лиды списком, воронкой и непрочитанные (crm_leads); карточка лида, переписка, задачи и история (crm_lead, crm_messages, crm_tasks); чаты Teletype (teletype_messages).
  • Сотрудники: сотрудники и агенты филиала (list_employees); график смен и виды работ (shifts, shift_templates).

Бронирования, автопарк, клиенты, штрафы, дела и журнал относятся к области «Автопарк и бронирования», остальные пункты — к одноимённым областям из раздела 2. Списки отдаются страницами до 50 строк, с общим количеством и признаком следующей страницы; поиск и фильтры — те же, что на экранах. Инструментов, недоступных вашей роли или уровням ключа, агент просто не видит.

7. Изменения через агента и одобрение

Агент может вносить изменения во всех четырёх областях — то же, что сотрудник делает на экранах RentProg:

  • CRM: ответить клиенту (в том числе в Teletype), создать и изменить лид, перевести его по воронке, привязать бронирование или контакт, сохранить файл из переписки, добавить заметку и задачу, отметить прочитанным, архивировать, преобразовать в клиента, добавить в чёрный список Avito.
  • Автопарк и бронирования: создать и изменить бронирование, сменить статус, выдать, принять, продлить; допы, повреждения, фото выдачи и приёмки, подарки; клиенты и их файлы; машины, цены, регламенты и страховки, осмотры, ремонты, файлы машины; штрафы; склад; договор выкупа; сообщение клиенту по шаблону; решения по бронированиям маркетплейса; телематика и такси; задачи, личные дела и чек-листы.
  • Деньги: платежи (создать, провести, отменить), оплата бронирования, переводы между сотрудниками, долги, счета, оплата штрафов, инвесторы, контрагенты.
  • Сотрудники: создать и изменить сотрудника или агента, баланс сотрудника, смены, оценки.

Изменения идут через те же проверки, что и в интерфейсе: чего не даёт сделать экран вашей роли, не сделает и агент. Документы агент не создаёт — договор собирается в интерфейсе. Агент работает с уже готовыми документами бронирования: отправляет их клиенту и запрашивает подпись через DocuSeal или OkiDoki.

При ступени «Запись с одобрением» подготовленное изменение попадает в раздел «Ожидают одобрения» (пункт меню и уведомление в колокольчике). Там видно, что агент собирается сделать; одобренное выполняется сразу, отклонённое — нет. Без решения операция истекает через 24 часа. Подпись клиента, которую передаёт агент, всегда ждёт одобрения: вы видите её изображение. Агент узнаёт итог своим инструментом статуса операции.

Часть действий уходит во внешний мир, и отменить их нельзя: сообщения клиентам (CRM, Teletype, по шаблону), чёрный список Avito, отправка документов, команды машине через телематику, решения по бронированиям маркетплейса, операции такси, платные проверки клиента. Некоторые из них агент выполняет в фоне: сначала получает ответ «принято», а итог узнаёт инструментом статуса операции. Для денег рекомендуем одобрение, для сообщений клиентам — предпросмотр или одобрение.

Всё, что изменил агент, помечено в карточках, платежах и истории бронирования меткой «через агента»: при наведении видно, каким инструментом и когда.

8. Что видит агент по ролям

Ступени ключа или подключённого приложения ограничивают агента сверху, а роль сотрудника — ещё и область данных и поля:

РольОбласть данныхСтупени ключаПоля и инструменты
superadminвся группа филиаловдо «Запись сразу» во всех областяхвсё, включая себестоимость машин и отчёт по деньгам
adminсвой филиал — вся группа только при праве «смена филиала»до «Запись сразу» во всех областяхвсё, включая себестоимость машин и отчёт по деньгам
managerсвой филиал — вся группа только при праве «смена филиала»до «Запись сразу» во всех областяхоперационные суммы бронирований; без себестоимости машин и отчёта по деньгам
userсвой филиал — вся группа только при праве «смена филиала»до «Запись сразу», кроме области «Сотрудники»операционные суммы бронирований; без себестоимости машин, отчёта по деньгам, экономики парка, работы сотрудников и подозрительных операций
guestвся группа филиаловтолько «Чтение», кроме области «Сотрудники»деньги — полностью; без персональных данных клиентов-физлиц (ФИО, телефон, email, дата рождения, ИНН, баланс); юрлица — полностью; лиды и переписка CRM — как на экране CRM, с контактами
partner, agent—ключ не выпускается, приложение не подключается—

Область CRM доступна, только если в компании подключена CRM и сотруднику открыт к ней доступ — так же, как экран CRM в интерфейсе. Иначе в окне выпуска она помечена «Недоступно для вашей роли или тарифа».

Описание API RentProg для разработчиков: Swagger. Тарифы: rentprog.ru/tariffs.