UK
Подивитися демо

AI-агенти й інтеграції

Як підключити Claude до CRM через MCP

Krokul CRM — B2B CRM для компаній, що працюють за договорами: угоди, проєкти й прибуток кожного клієнта в одній системі; впроваджують партнери-інтегратори. Цей посібник показує співробітнику, як дати Claude доступ до угод, контактів і звітів у межах його ролі й як цей доступ забрати.

Коротка відповідь

Щоб підключити Claude до CRM через MCP, додайте адресу MCP-сервера CRM у Claude як власний конектор, увійдіть у CRM, оберіть компанію й дозвольте лише ті права, яких Claude потребує. Далі Claude працює з вашою роллю й дозволами. Перевірте пробним запитом на читання, а коли робота закінчиться, відкличте доступ у профілі.

  • Адреса сервера: https://app.krokul.com/mcp
  • Вхід: власний акаунт Krokul
  • Руйнівні інструменти: не віддаються
На цій сторінці
  1. Коротка відповідь
  2. Коли підключати
  3. Шість кроків
  4. Що може Claude
  5. Вхід чи ключ API
  6. Типові помилки
  7. Чек-лист
  8. Питання й відповіді

Коли підключати Claude до CRM#

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

  • Щопонеділка ви ставите те саме запитання про прострочені рахунки й хочете, щоб Claude приносив перелік.
  • Після дзвінка ви хочете записати домовлений наступний крок задачею в потрібній угоді, не відкриваючи CRM.
  • Вам потрібне зведення про конверсію й про дні, які угоди проводять на кожному етапі воронки, за числами, що порахувала CRM.
  • Розробник хоче випробувати агента на справжніх роутах із підключенням, що має обмежені права.
MCP
MCP — Model Context Protocol, протокол, за яким AI-клієнт, як-от Claude, викликає інструменти, які пропонує інша система. Сам протокол описує посібник про що MCP змінює для даних CRM.
Підключення
Підключення в Krokul — це доступ, який людина дає AI-клієнтові: одна компанія, набір прав і роль цієї людини. Воно діє, поки ним користуються, бо кожне поновлення дає ще 30 днів, і закінчується, коли його відкликано, коли воно 30 днів не використовувалось або коли людина втратила доступ до компанії.

Як підключити Claude до Krokul за шість кроків#

Підключення Claude до Krokul складається з шести кроків, а вхід у кроці 3 — єдиний момент, коли людина дає права. Сторінка Krokul про API, вебхуки й MCP перелічує, що пропонує сервер.

  1. Перевірте, що ваш акаунт може підключатись

    Потрібен акаунт Krokul із внутрішньою роллю у вашій компанії, наприклад адміністратор чи менеджер. Демо-компанії й кабінети партнера підключити не можна, і Krokul каже про це, коли жодна компанія не підходить. З боку Claude потрібен застосунок, що підтримує власні конектори: Claude у браузері, Claude Desktop або Claude Code.

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

  2. Додайте адресу Krokul як власний конектор

    У Claude відкрийте налаштування конекторів, додайте власний конектор і впишіть https://app.krokul.com/mcp. Натисніть «Connect», і Krokul відкриє у браузері сторінку входу.

    У Claude Code виконайте claude mcp add --transport http krokul https://app.krokul.com/mcp. Потім у Claude Code виконайте /mcp, оберіть krokul і почніть автентифікацію.

    Порада. Адреса, відкрита в звичайній вкладці браузера, показує коротку сторінку з тими самими інструкціями, бо сама адреса призначена для AI-клієнтів.

  3. Увійдіть і прочитайте екран згоди

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

    Оберіть компанію й позначте дозволи. Вони йдуть двома групами: «Читання» і «Зміни», що дають право створювати й змінювати записи. Для першої проби зніміть позначки групи «Зміни», і Claude лише читатиме. Хоча б один дозвіл лишається позначеним. Натисніть «Дозволити», і браузер поверне вас у Claude.

  4. Спершу поставте запитання на читання

    Почніть розмову з увімкненим конектором Krokul і спитайте, які контрагенти мають прострочені рахунки. Claude викличе інструмент client_company_read_debtors і відповість зі списку, який поверне Krokul.

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

    Екран «Боржники»: чотири плитки за строками й таблиця із сумою боргу, авансом, сальдо, прострочення й обіцянкою оплати
    Порівняйте відповідь з екраном «Боржники» в демо-компанії Krokul; Claude читає той самий список інструментом client_company_read_debtors.
  5. Перегляньте зміну до того, як Claude її виконає

    Попросіть Claude створити задачу чи перенести угоду на інший етап і спершу викликати інструмент із dryRun, виставленим у true. Krokul відповість роутом і точним тілом, яке надіслав би, і нічого не запише.

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

  6. Перегляньте підключення й відкличте його, коли робота закінчена

    Відкрийте «Мій профіль» у Krokul і знайдіть блок «Підключені застосунки». Кожен рядок показує застосунок, дату підключення й дату останнього використання. «Відкликати» припиняє доступ одразу, і Claude мусить попросити вас увійти знову.

    Адміністратор бачить підключення всіх людей компанії на «Маркетплейсі», під ключами API, і може відкликати будь-яке.

Що Claude може робити через підключення#

Claude може викликати кожен інструмент Krokul, який дозволяють погоджені вами права й ваша роль, і жодного руйнівного. Перелік інструментів будується зі специфікації публічного API, тож кожен інструмент є роутом API, а кожен виклик іде тим самим шлюзом, що й API: перевірка прав, стеля частоти й журнал викликів. Назва card_read_list походить від роута card/api-readList.

Що пропонує особисте підключення, за видом інструмента
Вид інструментаПрикладиЧи віддається Claude
Читанняcard_read_list, contact_find, client_company_read_debtors, report_dsoТак, для погоджених прав на читання
Записtask_create, activity_create, card_update_statusТак, коли ви погодили права на зміну записів; доступні dryRun і ключ ідемпотентності
Руйнівніінструменти, що видаляють, скасовують, зливають, архівують чи повертають коштиНіколи; це робить людина в інтерфейсі Krokul
Поза будь-яким дозволомтранскрипти зустрічей, керування ключами APIНіколи не віддаються

Списки приймають зсув і кількість, а кількість до 50 тримає контекст Claude малим. Результат довший за 100 000 знаків обрізається, і до обрізання додається повідомлення, яке радить Claude звузити запит.

Що обрати: особистий вхід чи ключ API компанії#

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

Особисте підключення й ключ API компанії в порівнянні
ОзнакаОсобисте підключенняКлюч API компанії
Хто починаєЛюдина, що входить із ClaudeАдміністратор на «Маркетплейсі»
РольЖива роль цієї людини на кожен викликРоль, обрана для ключа; типово менеджер
Руйнівні інструментиНе віддаютьсяАдміністратор вирішує перемикачем під час створення ключа, і потім це не змінюється
Як закінчуєтьсяВідкликається в «Моєму профілі» або людина залишає компаніюВідкликається на «Маркетплейсі» або спливає: без строку, 30 днів, 90 днів чи рік
Як входитьЧерез OAuth у клієнтіЗаголовок Authorization: Bearer krokul_… на ту саму адресу

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

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

  • Позначені всі дозволи на екрані згоди дають Claude право запису, яким він може ніколи не скористатись, тож тримайте права на зміну записів знятими, доки їх не потребує задача.
  • Підключення, яке почали не ви, може здаватися безпечним. Екран згоди позначає назву, вказану самим застосунком, як неперевірену, тож дозволяйте лише запит, який почали ви.
  • Підключення, залишене після разової роботи, поновлюється, доки Claude ним користується, тож відкличте його в «Моєму профілі», коли робота закінчиться.
  • Повтор невдалого запису без змін повторює невдачу. Помилка приходить із повідомленням сервера, і Claude має прочитати його й виправити виклик.
  • Відсутній інструмент зазвичай означає, що роль не має права на його роут. Інструмент зʼявляється, лише коли його дозволяють і погоджене право, і роль, тож спитайте адміністратора, коли він потрібен.

Чек-лист перед підключенням Claude до компанії#

  • Ви знаєте, в якій компанії Krokul має працювати Claude і що ваша роль у ній відповідає задачі.
  • Екран згоди показує застосунок і адресу повернення, яких ви очікуєте.
  • Позначено лише права, потрібні для першої задачі.
  • Запит на читання повертає тих самих контрагентів, що й екран «Боржники».
  • Кожен запис починається з перегляду dryRun.
  • Ви знаєте, коли робота закінчиться і підключення буде відкликано.

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

Чи бачить Claude все в моїй компанії Krokul?

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

Чи може Claude видаляти або зливати записи в Krokul?

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

Скільки діє підключення?

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

Що робити, якщо екран згоди каже, що запит застарів?

Почніть підключення в Claude заново. Запит на згоду чинний 15 хвилин і спрацьовує один раз.

Чи може одне підключення діяти в кількох компаніях?

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

Команда Krokul

Люди, які створюють Krokul CRM

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

Уперше опубліковано

Подивитися демо