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

https://krokul.com/uk/blog/yak-pidklyuchyty-claude-do-crm-cherez-mcp/ · Команда Krokul · Оновлено 2026-11-06

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

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

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

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

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

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

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

Підключення Claude до Krokul складається з шести кроків, а вхід у кроці 3 — єдиний момент, коли людина дає права. Сторінка Krokul про [API, вебхуки й MCP](https://krokul.com/uk/solutions/api/) перелічує, що пропонує сервер.

### 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. Обидва читають один роут, тож розбіжність вказує на роль чи дозволи вашого акаунта.

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

### 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](https://krokul.com/uk/integrations/claude/) описує шлях через вхід.

Особисте підключення й ключ API компанії в порівнянні:

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

Секрет ключа показується один раз, тож скопіюйте його під час створення. Покрокове створення ключа описує [довідка «Маркетплейс»](https://krokul.com/uk/help/integratsii-crm/), а посібник про [безпечний доступ AI до даних CRM](https://krokul.com/uk/blog/bezpechnyi-dostup-ai-do-danykh-crm/) пояснює, як підібрати права й роль для кожного виду агента.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

---

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