Подключение AI-агентов (Claude Code) через MCP

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

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

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

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

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

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

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

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

Область	Что в неё входит
CRM	лиды, воронка, переписка с клиентами, задачи CRM
Автопарк и бронирования	бронирования, машины, клиенты, расписание, штрафы
Деньги	долги и депозиты, деньги за период, экономика парка, работа сотрудников, подозрительные операции
Сотрудники	пока без инструментов

Ступень	Что может агент
Нет доступа	не видит область
Чтение	только смотрит данные
Запись с одобрением	готовит изменение, а выполняется оно только после вашего одобрения (раздел 5)
Запись с предпросмотром	сначала получает итог изменения (например, текст ответа клиенту) и затем подтверждает его сам; итог действует 10 минут
Запись сразу	вносит изменение сразу, без предпросмотра и подтверждения

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

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

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

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

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

Claude Code спросит два значения: ключ (ваш rpa_…) и адрес MCP (оставьте значение по умолчанию https://rentprog.net/mcp). Проверка: команда /mcp показывает сервер rentprog со списком инструментов. Новый ключ задаётся командой /plugin configure rentprog, после неё переподключите сервер в /mcp.

Готовые сценарии (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": "https://rentprog.net/mcp",
      "headers": { "Authorization": "Bearer rpa_ваш_ключ" }
    }
  }
}

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

ChatGPT. Пока не поддерживается: там свои коннекторы принимают либо доступ без авторизации, либо OAuth, и вписать персональный ключ нельзя. Поддержка OAuth — отдельная работа.

Общий адрес для любых клиентов: https://rentprog.net/mcp, заголовок Authorization: Bearer rpa_… (Streamable HTTP). Лимиты на ключ считаются раздельно: чтение — 60 вызовов в минуту и 1000 в час, изменения — 20 в минуту и 300 в час.

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

Сейчас агент может вносить изменения в CRM: ответить клиенту, создать и изменить лид, перевести его по воронке, привязать бронирование или контакт, сохранить файл из переписки, добавить заметку и задачу, отметить прочитанным, архивировать лид, преобразовать его в клиента, добавить в чёрный список Avito. Изменения идут через те же проверки, что и в интерфейсе: чего не даёт сделать экран, не сделает и агент.

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

Ответ клиенту и чёрный список Avito уходят во внешний мир: отправленное сообщение уже не отозвать. Для CRM поэтому рекомендуем предпросмотр или одобрение.

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

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

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

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

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