# Claude + Krokul CRM

Так. У Krokul CRM є вбудований MCP-сервер за адресою `https://app.krokul.com/mcp`, і Claude підключається до нього як власний конектор. Ви входите в Krokul, вибираєте компанію й дозволи, а далі Claude читає й записує угоди, контакти, задачі та звіти з вашою роллю в цій компанії.

**Статус:** Вбудована. **Платформи автоматизації:** Zapier, Make, n8n.

## Що отримує команда

### Хто винен гроші, і чернетки нагадувань

Claude викликає інструмент `client_company_read_debtors` і отримує прострочені рахунки за контрагентами. Ви просите коротке нагадування кожному клієнту своїми словами, переглядаєте чернетки в чаті й надсилаєте їх зі своєї пошти.

### Дзвінок у журнал одним реченням

Після дзвінка ви розповідаєте Claude, про що домовились. Він знаходить угоду через `card_read_list`, додає коментар через `activity_create` і ставить наступний крок через `task_create`. Перед кожним викликом інструмента Claude просить підтвердження, якщо ви не вибрали для нього Allow always.

### Воронка без окремого звіту

Інструменти `report_conversion` і `report_stage_duration` повертають конверсію між етапами й середню кількість днів, які угоди проводять на кожному. Claude ставить ці числа поруч і показує етап, де угоди застрягають. Рахує їх сервер Krokul.

### Спробувати зміну до того, як вона станеться

Кожен інструмент запису приймає прапорець `dryRun`. Сервер Krokul відповідає роутом і тілом, яке він надіслав би, і нічого не записує. Так масове оновлення через `card_bulk_update` можна перевірити до справжнього запуску.

## Що передається між системами

| Claude | Krokul | Напрям | Коли |
|---|---|---|---|
| Виклик інструмента читання (`card_read_list`, `contact_find`, `client_company_read_debtors`) | Угоди, контакти, боржники | Krokul → Claude | Коли ви питаєте про свої дані |
| Виклик інструмента запису (`task_create`, `activity_create`, `card_update_status`) | Задачі, коментарі, етапи угод | Claude → Krokul | Після того як ви підтвердили виклик у Claude |
| Виклик інструмента звіту (`report_dso`, `report_conversion`) | Звіти, пораховані Krokul | Krokul → Claude | Коли ви просите аналіз |
| Вхід власного конектора (OAuth) | Ваш користувач, компанія й підтверджені дозволи | Claude → Krokul | Один раз, далі токен оновлюється сам |
| Перелік інструментів | Роути публічного API, дозволені правами й вашою роллю | Krokul → Claude | Щоразу, коли Claude підключається |

## Як підключити сьогодні

### Claude у браузері та Claude Desktop

1. Відкрийте Customize → Connectors, натисніть + Add і виберіть Add custom connector.
2. Введіть адресу `https://app.krokul.com/mcp` і натисніть Add.
3. Натисніть Connect. Krokul відкриє свою сторінку входу. Увійдіть, перевірте назву застосунку й адресу повернення, виберіть компанію й зніміть дозволи, які Claude не потрібні.
4. Підтвердіть. У чаті через + → Connectors увімкніть Krokul для цієї розмови.
5. На планах Team і Enterprise власник спершу додає конектор в Organization settings → Connectors, а потім кожен учасник натискає Connect і входить зі своїм обліковим записом Krokul.

### Claude Code

1. Виконайте `claude mcp add --transport http krokul https://app.krokul.com/mcp`.
2. У Claude Code виконайте `/mcp`, виберіть krokul і завершіть вхід у браузері.

**Дії:** Send Message; Upload File; List Files.

### Для інтеграторів

MCP-сервер працює через той самий шлюз, що й публічний API, тому кожен виклик інструмента проходить перевірку прав, ліміт запитів і журнал викликів. OAuth-сервер Krokul підтримує PKCE з S256, документи метаданих клієнта (client ID metadata) і динамічну реєстрацію. Токен доступу живе одну годину, токен оновлення 30 днів і ротується. Для агентів без інтерфейсу ключ API компанії в заголовку `Authorization` працює з тією самою адресою `/mcp`.

[Документація API](https://app.krokul.com/api/v1/docs)

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

### Чи бачить Claude усе, що є в Krokul?

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

### На яких планах Claude можна додати Krokul?

Anthropic дає власні конектори на планах Free, Pro, Max, Team і Enterprise. Обліковий запис Free може додати один власний конектор.

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

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

### Як відкликати доступ?

У Krokul відкрийте свій профіль і відкличте застосунок у блоці підключених застосунків. Доступ припиняється одразу, і Claude доведеться знову попросити вас увійти.

## Обмеження

Руйнівні інструменти (видалення, злиття, скасування, архівування й повернення коштів) для підключення Claude закриті. Ці дії виконує людина в інтерфейсі Krokul. Одне підключення Claude працює з однією компанією Krokul.

## Пов’язані сервіси

- [ChatGPT](https://krokul.com/uk/integrations/chatgpt/index.md)
- [Zapier](https://krokul.com/uk/integrations/zapier/index.md)
- [n8n](https://krokul.com/uk/integrations/n8n/index.md)
- [Gmail](https://krokul.com/uk/integrations/gmail/index.md)
- [Google Sheets](https://krokul.com/uk/integrations/google-sheets/index.md)

[ШІ-асистенти](https://krokul.com/uk/integrations/category/ai-assistants/index.md)

Claude є торговою маркою Anthropic, PBC. Krokul не афілійований з Anthropic.

Оновлено: 2026-10-15

---

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