Как подключить AI-агента к RentProg

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

Два способа подключения

Способ	Для каких агентов	Нужен ли ключ
Коннектор по OAuth	Claude в браузере и в приложении для компьютера, ChatGPT, Claude Code с плагином RentProg	Нет: вы входите в RentProg и выбираете доступ на экране согласия
Персональный ключ rpa_	CLI RentProg, Cursor, Codex и другие клиенты без OAuth	Да, выпускается в профиле

Оба способа настраиваются в профиле, в разделе «Ключи для AI-агентов». Там же показана подсказка, какой коннектор добавить, список «Подключённые приложения» и список ключей.

Где взять адрес коннектора

Название и адрес коннектора для вашей компании показаны в профиле, в подсказке раздела «Ключи для AI-агентов». Используйте именно их.

Как подключить коннектор в Claude

1. Откройте профиль, раздел «Ключи для AI-агентов», и посмотрите в подсказке название и адрес коннектора.
2. В настройках коннекторов Claude добавьте пользовательский коннектор с названием и адресом из подсказки. В командных тарифах Claude коннектор добавляет владелец организации.
3. Нажмите подключение — откроется вход в RentProg.
4. На экране согласия выберите доступ по областям и нажмите «Разрешить».
5. Включите RentProg в нужном разговоре через меню инструментов Claude.

Как подключить коннектор в ChatGPT

1. Включите в настройках приложений ChatGPT режим разработчика, если он ещё не включён.
2. Создайте новое приложение с названием и адресом коннектора из профиля. Если ChatGPT спрашивает способ авторизации, выберите OAuth.
3. Запустите поиск инструментов — откроется вход в RentProg.
4. На экране согласия выберите доступ по областям и нажмите «Разрешить».
5. Дождитесь загрузки инструментов и сохраните приложение.

В рабочей области ChatGPT администратору может понадобиться опубликовать приложение для участников.

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

1. Установите плагин RentProg 3.0.0 или новее:

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

2. На вопрос плагина укажите адрес коннектора из профиля. Ключ плагину не нужен.

3. Откройте /mcp, выберите сервер rentprog и пройдите вход и согласие в браузере.

4. Проверьте, что /mcp показывает сервер rentprog со списком инструментов.

Подсказка

Если у вас стоял плагин 2.x с ключом, обновите его. Ключ, который больше нигде не используется, отзовите в профиле.

Что выбирается на экране согласия

Доступ задаётся отдельно для каждой области: CRM, автопарк и бронирования, деньги, сотрудники. Те же ступени выбираются и при выпуске ключа.

Ступень	Что может агент
Нет доступа	Не видит область
Чтение	Только смотрит данные
Запись с одобрением	Готовит изменение, а выполняется оно после вашего одобрения в разделе «Ожидают одобрения»
Запись с предпросмотром	Сначала получает итог изменения, затем подтверждает его сам
Запись сразу	Вносит изменение без предпросмотра и подтверждения

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

Как проверить и одобрить операцию

При доступе «Запись с одобрением» агент сначала готовит изменение. Откройте «Ожидают одобрения» в меню RentProg или из уведомления о новой операции.

1. Проверьте название в колонке «Операция» и подключение в колонке «Ключ».
2. Прочитайте «Что будет сделано»: поля подписаны понятными названиями, например «Клиент», «Бронирование», «Касса». По ссылкам на связанные записи можно проверить исходные данные перед решением.
3. Сверьте суммы, даты и получателей, затем нажмите «Одобрить» или «Отклонить» в строке. Одобрение запускает выполнение операции от вашего имени.
4. Для нескольких операций отметьте нужные строки, нажмите «Одобрить выбранные» или «Отклонить выбранные» (в скобках на кнопке — число отмеченных) и подтвердите решение. За один раз можно обработать до 50 операций.
5. Проверьте статус и пояснение в каждой строке: отказ по одной операции не отменяет остальные решения.

Пункт меню доступен ролям «Сотрудник», «Менеджер», «Управляющий филиалом» и «Главный администратор». Каждый видит и решает только операции, подготовленные от его имени в текущей группе компаний. Возможность главного администратора отзывать чужие ключи не даёт ему права одобрять чужие операции. При выполнении повторно проверяются права пользователя и подключения.

Важно

На решение даётся 24 часа; срок виден в колонке «Истекает». После этого операция получает статус «Истекла» и не выполняется. Если с момента подготовки изменился результат, статус будет «Устарела»: ничего не выполнено, попросите агента подготовить операцию заново.

«Выполнена» означает успешное завершение, «Отклонена» — отказ пользователя, «Не выполнена» — ошибку выполнения; прочитайте пояснение в строке. Статусы «Принята» и «Выполняется» ещё не подтверждают завершение: дождитесь итогового статуса.

Обновление списка без перезагрузки

Статусы меняются автоматически, в том числе если решение принято с другого устройства. Обработанные строки остаются на экране до обновления списка, чтобы вы успели проверить результат.

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

Как распознать действие агента

Значок робота «Через AI-агента» рядом с записью означает, что её меняли через AI-агента. Наведите на значок: подсказка покажет инструмент и время действия. Такие метки записей доступны штатным сотрудникам; у сообщения CRM подсказка может сообщать только «Отправлено через AI-агента».

Метка не называет сотрудника. Чтобы проверить, от чьего имени выполнено действие, сопоставьте время с журналом операций, если он доступен вашей роли и тарифу; у исходящего сообщения CRM также показывается известный системе автор.

Как выпустить персональный ключ

1. Откройте профиль, раздел «Ключи для AI-агентов», и нажмите «Создать ключ».
2. Задайте название ключа и доступ по областям.
3. Скопируйте ключ сразу: после закрытия окна он не показывается.
4. Скопируйте из того же окна адрес MCP-сервера, а для агентов с терминалом — готовую команду CLI.

Важно

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

С ключом агент подключается к адресу MCP-сервера из профиля и передаёт заголовок Authorization: Bearer rpa_…. Например, в Claude Code без плагина:

claude mcp add --transport http rentprog адрес_из_профиля --header "Authorization: Bearer rpa_ваш_ключ"

Как отозвать доступ агента

1. Откройте профиль, раздел «Ключи для AI-агентов».
2. Найдите приложение в списке «Подключённые приложения» или ключ в списке ключей.
3. Нажмите «Отозвать доступ» у приложения или «Отозвать» у ключа и подтвердите.
4. При необходимости удалите коннектор и в настройках Claude или ChatGPT.

Отозванное приложение или ключ теряет доступ на следующем же обращении агента к RentProg. Главный администратор видит в обоих списках доступы всех сотрудников группы компаний и может отозвать любой из них.

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

Всё, что видит подключение, включая персональные данные клиентов, агент передаёт выбранному AI-сервису. Сервис выбирает ваша компания, и она отвечает за то, чтобы такая передача была допустима по законам страны и договорам с клиентами.