Коротка відповідь
Доступ AI до даних CRM безпечний, коли агент має власну ідентичність, найвужчі права, що виконують задачу, роль, яка обмежує охоплення цих прав, жодних руйнівних інструментів і журнал викликів, який читає людина. Почніть із прав на читання, додавайте права на запис по одній групі записів і переглядайте журнал щотижня.
- Ідентичність: один ключ або підключення на агента
- Перші права: лише читання
- Перегляд: журнал викликів, щотижня
На цій сторінці
Коли переглядати доступ, який ви даєте AI-агенту#
Доступ AI до даних CRM потребує перегляду щоразу, коли агент може читати записи клієнтів або змінювати їх. Посібник про безпечне підключення AI-агентів та інших сервісів до CRM дає загальний метод, а цей посібник заглиблюється в права, ролі й журнали.
- Ви збираєтесь підключити Claude чи іншого помічника до CRM і маєте вирішити, які дозволи позначити.
- Розробник просить ключ API для агента, що працюватиме за розкладом.
- Менеджер хоче, щоб помічник ставив задачі після дзвінків, а власник питає, чого ще він може торкнутись.
- Аудитор чи клієнт питає, хто має доступ до собівартості, цін і даних про оплати, і якими каналами.
- Права (scope)
- Права, або scope, це названий дозвіл, наприклад на читання угод чи запис задач, який несе ключ або підключення. Виклик поза його правами відхиляється.
- Роль
- Роль це рівень людини чи ключа в компанії, наприклад адміністратор, менеджер чи перегляд. Вона обмежує, чого можуть сягнути права.
- Журнал викликів
- Журнал викликів це запис кожного виклику агента з роутом, результатом, часом і адресою, з якої він прийшов.
- Руйнівний інструмент
- Руйнівний інструмент це дія, що видаляє, скасовує, зливає, архівує чи повертає кошти за записами.
Як дати AI-агенту безпечний доступ до даних CRM за п’ять кроків#
AI-агент отримує безпечний доступ до даних CRM за п’ять кроків у сталому порядку: назвіть задачу й ідентичність, позначте найвужчі права, задайте роль як другу межу, лишіть руйнівні дії людям і читайте журнал за розкладом. Кожен крок прибирає один спосіб, яким агент сягнув би далі, ніж потребує його задача.
Назвіть задачу й дайте агенту власну ідентичність
Запишіть задачу одним реченням, наприклад «щопонеділка читати прострочені рахунки й створювати задачу-нагадування». Це речення визначає все далі.
Беріть особистий вхід, коли з помічником у чаті працює одна людина, і іменований ключ компанії, коли програма працює без людини за екраном. Спільний логін адміністратора ховає, хто діяв, і його не відкликати без зміни пароля для всіх.
Позначте найвужчі права
Почніть із прав на читання тих записів, що потрібні задачі, наприклад угод і контрагентів. Право на запис додавайте, лише коли його вимагає задача, і по одній групі записів.
Для кожного позначеного права назвіть задачу, якій воно потрібне. Право без названої задачі знімається зі списку.
Задайте роль як другу межу
Права відповідають, які дані потрібні застосунку, а роль відповідає, від імені якого співробітника він діє. CRM, що перевіряє обидва, дає ролі «перегляд» з правом читання угод бачити угоди й усе одно ховає собівартість.
Беріть найнижчу роль, що виконує задачу, а роль адміністратора лишайте для людини.
Лишіть руйнівні дії людям
Видалення, злиття, скасування, архівування й повернення коштів найважче відкотити. Тримайте їх поза переліком інструментів агента, тримайте права на запис мінімальними, і хай ці дії виконує людина в інтерфейсі.
Якщо задача справді потребує однієї з них, дайте її одному ключу, запишіть причину й задайте строк дії.
Читайте журнал і задайте дату завершення
Відкривайте журнал викликів раз на тиждень протягом першого місяця. Шукайте відхилені виклики, виклики понад ліміт частоти й виклики в незвичний час.
Задайте ключу строк дії, а особисте підключення відкличте в день, коли робота закінчилась. Журнал, який ніхто не читає, нічого не захищає.
Які права й роль підходять для якого агента#
Потрібні права й роль залежать від того, що робить агент, і таблиця зіставляє чотири типові задачі зі стартовим набором. Значення наведено як приклад, тож підлаштуйте перелік під власні записи.
| Задача агента | З яких прав почати | Роль | Завершення |
|---|---|---|---|
| Щотижневі відповіді про прострочені рахунки | 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 проводить першими дверима.
У Krokul є 34 названі права (scope), здебільшого парами на читання й запис, наприклад cards.read, contacts.write, tasks.write і reports.read. Роут, що не належить жодному праву, закритий ключам, і відмова називає причину. Деякі роути лишаються закритими за будь-яких прав: керування ключами, токени інтеграцій, учасники й запрошення, налаштування компанії, поштові скриньки, SMS і канали, портали, міграція, комісії, команди, особистий профіль, кошик і стирання людини. Транскрипти зустрічей поза всіма правами. Сторінка про ключі, вебхуки й MCP у Krokul перелічує інтерфейси.
Ключ несе одну роль, адміністратор, менеджер або перегляд, і типова роль менеджер. Krokul перевіряє спершу право, потім роль. Роль «перегляд» не створює й не змінює угод, контактів і задач, а собівартість бачать лише адміністратори й менеджери. Особисте підключення бере живу роль своєї людини на кожен виклик, тож знижена роль звужує його з наступного виклику. Посібник про ролі в CRM, що ховають собівартість, показує, як їх налаштувати.
Перелік інструментів, який віддає MCP, не містить дій видалити, скасувати, злити, архівувати й повернути кошти, а також видалення позицій, категорій і годин. Особисте підключення їх не отримує. Ключ компанії отримує їх, лише коли адміністратор увімкнув руйнівну опцію під час створення, і потім опцію не змінити. Цей перемикач вирішує, що показує MCP. Право викликати роут дає scope, тож ключ із правами на запис усе одно може викликати такий роут у публічному API напряму, і права ключа заслуговують такої самої уваги, як перемикач.
Кожен інструмент запису приймає dryRun, який повертає роут і тіло та нічого не пише, і ключ ідемпотентності, завдяки якому повторний виклик повертає першу відповідь.
Кожен справжній виклик упізнаного ключа чи особистого підключення лишає один рядок у журналі викликів. У рядку: префікс ключа, роут, статус, результат (успіх, відмовлено, перевищено ліміт чи помилка), перевірене право, тривалість, розміри запиту й відповіді, адреса, короткий перелік безпечних заголовків і текст помилки. Тіла запиту й заголовка Authorization у рядку немає, а перегляд dryRun рядка не лишає, бо зупиняється до шлюзу. Адміністратори читають журнал ключа компанії на «Маркетплейсі» за ключем і за результатом, рядки особистих підключень мають префікс oauth і не мають ключа, а записи старші за 30 днів типово видаляються, як описує довідка «Маркетплейс». Кожен ключ може зробити 600 викликів за хвилину, а швидший агент отримує відповідь 429 з результатом «перевищено ліміт».

Зміни записів видно на екрані «Аудит» з автором і часом. Читають його адміністратори й менеджери, а редагувати його не може ніхто. Коли зміну зробив ключ чи підключення, запис активності зберігає вид актора api поруч з автором, а екран «Аудит» цей вид не показує. Сторінка про ролі, журнал аудиту й безпеку в Krokul описує екран, а довідка про журнал аудиту показує фільтри.
Секрет ключа показується один раз, а зберігається лише його хеш SHA-256. Адміністратор обирає роль, строк дії (без строку, 30 днів, 90 днів або рік) і руйнівну опцію, а компанія тримає до 10 активних ключів. Відкликання ключа зупиняє його одразу й вимикає підписки на вебхуки, які він створив. Людина відкликає особисте підключення в «Моєму профілі», а адміністратор бачить і відкликає всі підключення на «Маркетплейсі».
Питання й відповіді#
Чи може AI-агент бачити собівартість і маржу в CRM?
Лише коли роль, з якою він діє, їх бачить. У Krokul собівартість бачать адміністратори й менеджери, а роль «перегляд» ні, тож агенту без потреби в маржі дайте роль «перегляд» або ключ із вузькими правами.
Як довго має діяти AI-підключення?
Рівно стільки, скільки триває його задача. Пілот на два тижні потребує підключення, що закінчується за два тижні. У Krokul ключ компанії може спливати через 30 днів, 90 днів чи рік, а людина відкликає особисте підключення в день завершення роботи.
Як побачити, що агент робив учора?
Прочитайте журнал викликів і журнал аудиту. У Krokul журнал викликів ключа компанії на «Маркетплейсі» перелічує кожен виклик з роутом і результатом, а екран «Аудит» показує зміни записів з автором і часом.
Чи потрібен журнал агенту лише з читанням?
Так. Журнал показує, які дані агент читає і як часто, а відхилені виклики викривають агента, що тягнеться по дані поза своєю задачею.
Чи є промпт дозволом?
Ні. Інструкцію в промпті можна проігнорувати або перебити текстом у даних, тож обмежуйте агента правами, роллю й переліком інструментів, які CRM тримає на сервері.