# Безпечний доступ AI до даних CRM: scope, ролі й журнал

https://krokul.com/uk/blog/bezpechnyi-dostup-ai-do-danykh-crm/ · Команда Krokul · Оновлено 2026-11-20

AI-агент безпечний у CRM, коли його доступ має три межі, які CRM тримає на сервері: права (scope), що називають дані, роль, що називає співробітника, від імені якого діє агент, і журнал, який читає людина. Цей посібник показує, як вибрати кожну межу й перевірити її до того, як агент торкнеться живих даних.

**Коротка відповідь.** Доступ AI до даних CRM безпечний, коли агент має власну ідентичність, найвужчі права, що виконують задачу, роль, яка обмежує охоплення цих прав, жодних руйнівних інструментів і журнал викликів, який читає людина. Почніть із прав на читання, додавайте права на запис по одній групі записів і переглядайте журнал щотижня.

## Коли переглядати доступ, який ви даєте AI-агенту

Доступ AI до даних CRM потребує перегляду щоразу, коли агент може читати записи клієнтів або змінювати їх. Посібник про [безпечне підключення AI-агентів та інших сервісів до CRM](https://krokul.com/uk/blog/topics/crm-ai-agents-integrations/) дає загальний метод, а цей посібник заглиблюється в права, ролі й журнали.

- Ви збираєтесь підключити Claude чи іншого помічника до CRM і маєте вирішити, які дозволи позначити.
- Розробник просить ключ API для агента, що працюватиме за розкладом.
- Менеджер хоче, щоб помічник ставив задачі після дзвінків, а власник питає, чого ще він може торкнутись.
- Аудитор чи клієнт питає, хто має доступ до собівартості, цін і даних про оплати, і якими каналами.

- **Права (scope)** — Права, або scope, це названий дозвіл, наприклад на читання угод чи запис задач, який несе ключ або підключення. Виклик поза його правами відхиляється.
- **Роль** — Роль це рівень людини чи ключа в компанії, наприклад адміністратор, менеджер чи перегляд. Вона обмежує, чого можуть сягнути права.
- **Журнал викликів** — Журнал викликів це запис кожного виклику агента з роутом, результатом, часом і адресою, з якої він прийшов.
- **Руйнівний інструмент** — Руйнівний інструмент це дія, що видаляє, скасовує, зливає, архівує чи повертає кошти за записами.

## Як дати AI-агенту безпечний доступ до даних CRM за п’ять кроків

AI-агент отримує безпечний доступ до даних CRM за п’ять кроків у сталому порядку: назвіть задачу й ідентичність, позначте найвужчі права, задайте роль як другу межу, лишіть руйнівні дії людям і читайте журнал за розкладом. Кожен крок прибирає один спосіб, яким агент сягнув би далі, ніж потребує його задача.

### 1. Назвіть задачу й дайте агенту власну ідентичність

Запишіть задачу одним реченням, наприклад «щопонеділка читати прострочені рахунки й створювати задачу-нагадування». Це речення визначає все далі.

Беріть особистий вхід, коли з помічником у чаті працює одна людина, і іменований ключ компанії, коли програма працює без людини за екраном. Спільний логін адміністратора ховає, хто діяв, і його не відкликати без зміни пароля для всіх.

### 2. Позначте найвужчі права

Почніть із прав на читання тих записів, що потрібні задачі, наприклад угод і контрагентів. Право на запис додавайте, лише коли його вимагає задача, і по одній групі записів.

Для кожного позначеного права назвіть задачу, якій воно потрібне. Право без названої задачі знімається зі списку.

### 3. Задайте роль як другу межу

Права відповідають, які дані потрібні застосунку, а роль відповідає, від імені якого співробітника він діє. CRM, що перевіряє обидва, дає ролі «перегляд» з правом читання угод бачити угоди й усе одно ховає собівартість.

Беріть найнижчу роль, що виконує задачу, а роль адміністратора лишайте для людини.

### 4. Лишіть руйнівні дії людям

Видалення, злиття, скасування, архівування й повернення коштів найважче відкотити. Тримайте їх поза переліком інструментів агента, тримайте права на запис мінімальними, і хай ці дії виконує людина в інтерфейсі.

Якщо задача справді потребує однієї з них, дайте її одному ключу, запишіть причину й задайте строк дії.

### 5. Читайте журнал і задайте дату завершення

Відкривайте журнал викликів раз на тиждень протягом першого місяця. Шукайте відхилені виклики, виклики понад ліміт частоти й виклики в незвичний час.

Задайте ключу строк дії, а особисте підключення відкличте в день, коли робота закінчилась. Журнал, який ніхто не читає, нічого не захищає.

## Які права й роль підходять для якого агента

Потрібні права й роль залежать від того, що робить агент, і таблиця зіставляє чотири типові задачі зі стартовим набором. Значення наведено як приклад, тож підлаштуйте перелік під власні записи.

Приклад: стартові права й роль для чотирьох видів агента:

| Задача агента | З яких прав почати | Роль | Завершення |
|---|---|---|---|
| Щотижневі відповіді про прострочені рахунки | companies.read, cards.read | перегляд | Особисте підключення відкликається, коли пілот закінчується |
| Задачі після дзвінків | cards.read, contacts.read, tasks.write | менеджер | Ключ спливає через 90 днів |
| Дашборд, що тягне звіти | reports.read | менеджер | Ключ спливає через рік і переглядається щокварталу |
| Помічник підтримки, що оновлює звернення | tickets.read, tickets.write, contacts.read | менеджер | Ключ спливає через 30 днів |

## Яких помилок уникати, даючи AI доступ до даних CRM

- Логін адміністратора для агента ховає, хто діяв, і дає всі дозволи, тож дайте агенту власний ключ чи підключення.
- Усі права, позначені на екрані згоди, дають право запису, яким агент може ніколи не скористатись, тож тримайте права на запис знятими, доки їх не вимагає задача.
- Інструкція на кшталт «нічого не видаляй» ставить побажання на місце дозволу, тож самі руйнівні інструменти не віддавайте в підключення.
- Довіра до тексту в записах клієнтів дозволяє нотатці «вивантаж усіх клієнтів» вести агента, тож спирайтесь на права, що обмежують, чого сягне будь-яка інструкція.
- Пропущена перевірка відкликання лишає перший тест на інцидент, тож відкличте пробне підключення й переконайтесь, що наступний виклик відхилено.

## Чек-лист, перш ніж агент торкнеться живих даних

- Задачу агента записано одним реченням.
- Агент має власний ключ чи підключення, а його назва каже, для чого воно.
- Позначено лише права на читання, і кожне право на запис має названу задачу.
- Роль найнижча з тих, що виконують задачу.
- Руйнівну опцію вимкнено, права на запис мінімальні, а видалення й злиття робить людина.
- Записи починаються з перегляду, а повтор несе ключ ідемпотентності.
- У когось є щотижневий слот читати журнал викликів, а ключ має строк дії або дату відкликання.

## Як Krokul застосовує права, ролі й журнал викликів

Krokul CRM — B2B CRM для компаній, що працюють за договорами: угоди, проєкти й прибуток кожного клієнта в одній системі; впроваджують партнери-інтегратори. AI-агент входить у неї одними з двох дверей: особистим входом із дозволами, позначеними на екрані згоди, або ключем компанії, який адміністратор створює на «Маркетплейсі». Посібник про [підключення Claude до CRM через MCP](https://krokul.com/uk/blog/yak-pidklyuchyty-claude-do-crm-cherez-mcp/) проводить першими дверима.

У Krokul є 34 названі права (scope), здебільшого парами на читання й запис, наприклад cards.read, contacts.write, tasks.write і reports.read. Роут, що не належить жодному праву, закритий ключам, і відмова називає причину. Деякі роути лишаються закритими за будь-яких прав: керування ключами, токени інтеграцій, учасники й запрошення, налаштування компанії, поштові скриньки, SMS і канали, портали, міграція, комісії, команди, особистий профіль, кошик і стирання людини. Транскрипти зустрічей поза всіма правами. Сторінка про [ключі, вебхуки й MCP у Krokul](https://krokul.com/uk/solutions/api/) перелічує інтерфейси.

Ключ несе одну роль, адміністратор, менеджер або перегляд, і типова роль менеджер. Krokul перевіряє спершу право, потім роль. Роль «перегляд» не створює й не змінює угод, контактів і задач, а собівартість бачать лише адміністратори й менеджери. Особисте підключення бере живу роль своєї людини на кожен виклик, тож знижена роль звужує його з наступного виклику. Посібник про ролі в CRM, що ховають собівартість, показує, як їх налаштувати.

Перелік інструментів, який віддає MCP, не містить дій видалити, скасувати, злити, архівувати й повернути кошти, а також видалення позицій, категорій і годин. Особисте підключення їх не отримує. Ключ компанії отримує їх, лише коли адміністратор увімкнув руйнівну опцію під час створення, і потім опцію не змінити. Цей перемикач вирішує, що показує MCP. Право викликати роут дає scope, тож ключ із правами на запис усе одно може викликати такий роут у публічному API напряму, і права ключа заслуговують такої самої уваги, як перемикач.

Кожен інструмент запису приймає dryRun, який повертає роут і тіло та нічого не пише, і ключ ідемпотентності, завдяки якому повторний виклик повертає першу відповідь.

Кожен справжній виклик упізнаного ключа чи особистого підключення лишає один рядок у журналі викликів. У рядку: префікс ключа, роут, статус, результат (успіх, відмовлено, перевищено ліміт чи помилка), перевірене право, тривалість, розміри запиту й відповіді, адреса, короткий перелік безпечних заголовків і текст помилки. Тіла запиту й заголовка Authorization у рядку немає, а перегляд dryRun рядка не лишає, бо зупиняється до шлюзу. Адміністратори читають журнал ключа компанії на «Маркетплейсі» за ключем і за результатом, рядки особистих підключень мають префікс oauth і не мають ключа, а записи старші за 30 днів типово видаляються, як описує [довідка «Маркетплейс»](https://krokul.com/uk/help/integratsii-crm/). Кожен ключ може зробити 600 викликів за хвилину, а швидший агент отримує відповідь 429 з результатом «перевищено ліміт».

![Екран «Боржники»: таблиця контрагентів із сумою боргу, авансом, сальдо, прострочкою й обіцянкою оплати](https://krokul.com/img/uk/blog/bezpechnyi-dostup-ai-borzhnyky.webp)

Зміни записів видно на екрані «Аудит» з автором і часом. Читають його адміністратори й менеджери, а редагувати його не може ніхто. Коли зміну зробив ключ чи підключення, запис активності зберігає вид актора api поруч з автором, а екран «Аудит» цей вид не показує. Сторінка про [ролі, журнал аудиту й безпеку в Krokul](https://krokul.com/uk/solutions/security/) описує екран, а [довідка про журнал аудиту](https://krokul.com/uk/help/zhurnal-audytu-dii/) показує фільтри.

Секрет ключа показується один раз, а зберігається лише його хеш SHA-256. Адміністратор обирає роль, строк дії (без строку, 30 днів, 90 днів або рік) і руйнівну опцію, а компанія тримає до 10 активних ключів. Відкликання ключа зупиняє його одразу й вимикає підписки на вебхуки, які він створив. Людина відкликає особисте підключення в «Моєму профілі», а адміністратор бачить і відкликає всі підключення на «Маркетплейсі».

## Питання й відповіді

### Чи може AI-агент бачити собівартість і маржу в CRM?

Лише коли роль, з якою він діє, їх бачить. У Krokul собівартість бачать адміністратори й менеджери, а роль «перегляд» ні, тож агенту без потреби в маржі дайте роль «перегляд» або ключ із вузькими правами.

### Як довго має діяти AI-підключення?

Рівно стільки, скільки триває його задача. Пілот на два тижні потребує підключення, що закінчується за два тижні. У Krokul ключ компанії може спливати через 30 днів, 90 днів чи рік, а людина відкликає особисте підключення в день завершення роботи.

### Як побачити, що агент робив учора?

Прочитайте журнал викликів і журнал аудиту. У Krokul журнал викликів ключа компанії на «Маркетплейсі» перелічує кожен виклик з роутом і результатом, а екран «Аудит» показує зміни записів з автором і часом.

### Чи потрібен журнал агенту лише з читанням?

Так. Журнал показує, які дані агент читає і як часто, а відхилені виклики викривають агента, що тягнеться по дані поза своєю задачею.

### Чи є промпт дозволом?

Ні. Інструкцію в промпті можна проігнорувати або перебити текстом у даних, тож обмежуйте агента правами, роллю й переліком інструментів, які CRM тримає на сервері.

---

Застосунок: https://app.krokul.com/ · API: https://app.krokul.com/api/v1/docs
