# Microsoft Copilot + Krokul CRM

Так. Krokul CRM інтегрується з Microsoft Copilot через свій MCP-сервер за адресою `https://app.krokul.com/mcp`. Ви додаєте сервер до агента в Copilot Studio, і агент працює з інструментами Krokul для угод, контактів, задач і звітів. Коли агента опубліковано в Teams і Microsoft 365 Copilot, він просить кожного колегу увійти в Krokul і діє з роллю цієї людини.

**Статус:** Через API і вебхуки, На запит.

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

### Агент продажу в Teams відповідає на питання про гроші

Колега з фінансів питає агента Krokul у Teams, які клієнти прострочили оплату цього місяця. Copilot викликає інструмент Krokul `client_company_read_debtors` із входом цієї людини й перелічує прострочені рахунки за контрагентами. Наступним питає менеджер продажу. З роллю агента в Krokul його відповідь охоплює лише власних клієнтів менеджера.

### Нотатки після зустрічі в Teams потрапляють в угоду

Одразу після зустрічі з клієнтом ви розповідаєте агентові в Microsoft 365 Copilot, про що домовились. Агент знаходить угоду через `card_read_list`, зберігає підсумок коментарем через `activity_create` і ставить наступний крок через `task_create` на названу вами дату. Коментар зʼявляється у стрічці угоди.

### Огляд воронки перед понеділковою нарадою

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

### Масова зміна, перевірена до запуску

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

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

| Microsoft Copilot | Krokul | Напрям | Коли |
|---|---|---|---|
| Виклик інструмента читання (`card_read_list`, `contact_find`, `client_company_read_debtors`) | Угоди, контакти, боржники | Krokul → Copilot | Користувач питає про дані Krokul |
| Виклик інструмента запису (`task_create`, `activity_create`, `card_update_status`) | Задачі, коментарі, етапи угод | Copilot → Krokul | Користувач просить агента щось записати |
| Виклик інструмента звітів (`report_dso`, `report_conversion`, `report_stage_duration`) | Звіти, пораховані в Krokul | Krokul → Copilot | Користувач просить аналіз |
| Ресурси MCP (модулі, конектори, типи власних полів) | Реєстр налаштувань компанії в Krokul | Krokul → Copilot | Агентові потрібен контекст про налаштування |
| Вхід кожного користувача через OAuth 2.0 (Dynamic discovery) | Користувач Krokul, компанія й погоджені дозволи | Copilot → Krokul | Перше звернення до агента, далі оновлення токена |

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

### Krokul як MCP-сервер у Copilot Studio

1. Відкрийте свого агента в Copilot Studio, перейдіть у Tools, виберіть Add a tool, потім New tool і Model Context Protocol.
2. Введіть Krokul у полі Server name, короткий Server description, наприклад угоди, контакти, задачі й звіти вашої компанії, і `https://app.krokul.com/mcp` у полі Server URL.
3. Виберіть OAuth 2.0 з типом Dynamic discovery і натисніть Create. Copilot Studio сам реєструється в Krokul.
4. У вікні Add tool виберіть Create a new connection, увійдіть у Krokul, виберіть компанію й зніміть дозволи, які агентові не потрібні. Потім натисніть Add to agent.
5. Опублікуйте агента й додайте канал Teams and Microsoft Copilot, щоб колеги знаходили його в Teams і в Microsoft 365 Copilot.

### Власний потік через API і вебхуки Krokul

1. Для агента, що працює без людини, створіть ключ API Krokul зі scope читання тих даних, які йому потрібні.
2. У майстрі MCP виберіть API key, тип Header і назву заголовка x-api-key. Та сама адреса `https://app.krokul.com/mcp` тоді обслуговує власника ключа.
3. Щоб передавати події у ваші потоки Microsoft, підпишіть вебхук на card.won чи invoice.paid через webhook/api-upsert і перевіряйте заголовок x-crm-signature кожної доставки.

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

MCP-сервер Krokul працює через транспорт Streamable HTTP, якого вимагає Copilot Studio. SSE Copilot Studio більше не приймає. Krokul публікує метадані захищеного ресурсу OAuth і точку реєстрації клієнтів, тож варіант Dynamic discovery сам знаходить адреси й реєструє клієнта, а кожен вхід іде з PKCE. Кожен інструмент має позначки «лише читання» й «руйнівний» і проходить ту саму перевірку прав, ліміт запитів і журнал викликів, що й публічний API.

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

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

### Чи може Microsoft Copilot працювати з Krokul?

Так. Додайте `https://app.krokul.com/mcp` до агента Copilot Studio як інструмент Model Context Protocol з OAuth 2.0, і агент працюватиме з інструментами Krokul у Teams і Microsoft 365 Copilot.

### Чи бачать усі колеги через агента однакові дані Krokul?

Ні. З OAuth кожна людина входить у Krokul окремо, і Krokul перевіряє її роль на кожному виклику. Роль агента бачить лише власні угоди.

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

Ні. Інструментів видалення, злиття, скасування, архівації й повернення коштів через MCP немає. Агент створює й оновлює записи в межах дозволів, які ви погодили.

### Чи бачить Copilot Studio нові інструменти Krokul сам?

Так. Copilot Studio читає перелік інструментів із MCP-сервера, і інструменти, додані чи прибрані в Krokul, зʼявляються або зникають в агента без нового налаштування.

## Обмеження

Copilot Studio використовує MCP з увімкненою генеративною оркестрацією, а правила даних Power Platform керують підключенням MCP так само, як будь-яким іншим конектором. Видалення, злиття, скасування, архівація й повернення коштів лишаються за людьми в інтерфейсі Krokul. Одне підключення охоплює одну компанію в Krokul.

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

- [Claude](https://krokul.com/uk/integrations/claude/index.md)
- [ChatGPT](https://krokul.com/uk/integrations/chatgpt/index.md)
- [Microsoft Teams](https://krokul.com/uk/integrations/microsoft-teams/index.md)
- [Microsoft Outlook](https://krokul.com/uk/integrations/microsoft-outlook/index.md)
- [Power BI](https://krokul.com/uk/integrations/power-bi/index.md)

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

Microsoft, Microsoft Copilot, Copilot Studio і Microsoft Teams є торговими марками Microsoft Corporation. Krokul не афілійований із Microsoft.

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

---

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