Перейти до основного вмісту
DocumentationAPI ReferenceVideo Tutorials

MCP-сервери

MCP — Model Context Protocol — це відкритий стандарт, що дозволяє AI-помічникам виявляти та викликати зовнішні інструменти. Якщо ви запускаєте MCP-сумісний сервер (свій власний або один із багатьох серверів спільноти), ви можете підключити його до Hanc.AI, і ваші агенти отримають інструменти сервера в момент початку дзвінка.

Після підключення агент може викликати ці інструменти посеред розмови — отримуючи живі дані, виконуючи розрахунки, запускаючи backend-воркфлоу — точно як вбудовані інтеграції Calendar, HubSpot або API Tool.

Доступно на кожному тарифі

MCP-сервери доступні на всіх тарифах, включно з Free. Немає плати за сервер — ви платите лише за хвилини дзвінків, які ваш агент використовує під час виклику інструментів.

Коли використовувати MCP​

СценарійЧому MCP підходить
Ви вже запускаєте внутрішній tool-серверОдне з'єднання, усі ваші інструменти доступні кожному агенту
Ви хочете розділити інструменти між агентамиПідключіть один раз, прикріпіть до стількох агентів, скільки хочете
Ви використовуєте спільнотні MCP-сервериПідключіть популярні open-source MCP-сервери без написання користувацького коду
Поверхня інструментів часто змінюєтьсяАгент повторно виявляє інструменти на кожному дзвінку — додавайте/видаляйте інструменти на сервері без торкання дашборду

Якщо у вас один разовий ендпоінт, API Tool простіший. Якщо у вас набір пов'язаних інструментів або ви вже підтримуєте MCP-сервер, це правильна інтеграція.

Підключення MCP-сервера​

1. Відкрийте сторінку Integrations​

У бічній панелі дашборду перейдіть до Integration. Прокрутіть до розділу MCP servers.

2. Натисніть «Connect MCP server»​

Відкривається модальне вікно. Заповніть:

ПолеОпис
LabelКоротка назва для цього з'єднання (наприклад, "Sales Tools", "Internal CRM"). Мітка показується в селекторі інструментів агента та префіксує назви інструментів, що подаються AI, тож тримайте її короткою та змістовною.
URLHTTPS URL вашого MCP-сервера. Має бути публічно доступною адресою — http:// і приватні/внутрішні адреси відхиляються.
AuthenticationNone, якщо ваш сервер відкритий, або Bearer token, якщо він очікує заголовок Authorization: Bearer ….
Token(Лише для Bearer) Ваш токен автентифікації. Зберігається зашифрованим — лише ваш обліковий запис платформи може його розшифрувати для використання.

Натисніть Save. Hanc.AI перевіряє формат URL та зберігає з'єднання. З'єднання тепер доступне кожному агенту у вашому робочому просторі.

Мітки мають значення

Назви інструментів від кожного MCP-сервера префіксуються міткою з'єднання, тож MCP-сервер з інструментом lookup_order, підключений як "Shop API", з'явиться агенту як Shop_API_lookup_order. Це запобігає колізіям, коли ви підключаєте кілька MCP-серверів з подібно названими інструментами.

3. Редагувати, вимкнути або видалити​

Список MCP-серверів показує мітку, URL, тип автентифікації та статус кожного з'єднання, яке ви додали. Використовуйте дії рядка, щоб:

  • Edit — змінити мітку, URL, тип автентифікації або токен
  • Delete — видалити з'єднання повністю

Видалення з'єднання деактивує його для кожного агента, до якого воно було прикріплене — ці агенти просто втрачають доступ до його інструментів на наступному дзвінку.

Прикріплення MCP-інструментів до агента​

З'єднання у вашому робочому просторі доступне вашим агентам — але кожен агент окремо вирішує, які з ваших з'єднань надавати. Це означає, що ви можете мати окремих Sales та Support агентів, які витягують з різних MCP-серверів.

1. Відкрийте вкладку Actions агента​

Виберіть агента. Відкрийте вкладку Actions. Натисніть Add Action.

2. Виберіть «MCP servers» з групи Live-call​

Випадаючий список показує три групи: Pre fetch, Live call, Post call. Шукайте у групі Live-call — саме там належать MCP-сервери, оскільки агент викликає MCP-інструменти під час розмови, а не до чи після.

3. Увімкніть, які з'єднання активувати​

Модальне вікно перераховує кожне MCP-з'єднання у вашому робочому просторі, кожне з перемикачем on/off. Увімкніть ті, які цей агент має використовувати. Ви також можете написати коротку інструкцію в полі «When to use it» — це те, що агент читає, щоб вирішити, коли звертатися до цих інструментів під час розмови.

Натисніть Save. Тепер агент має доступ до інструментів з кожного увімкненого MCP-з'єднання.

Змішуйте та комбінуйте

Ви можете мати одне MCP-з'єднання, увімкнене на п'яти агентах, і інше, увімкнене лише на одному — кожен агент має свій власний інструмент MCP servers з власним набором перемикачів.

Як це працює під час дзвінка​

Коли починається дзвінок, агент підключається до кожного зі своїх увімкнених MCP-серверів і питає «які інструменти ви пропонуєте?» Все, що повертає сервер, надається AI як інструмент, який він може викликати під час розмови.

Кілька речей, які слід знати:

  • Інструменти виявляються на початку дзвінка. Якщо ви додасте або видалите інструменти на своєму MCP-сервері, зміна з'явиться на наступному ж дзвінку — не потрібно оновлювати нічого в Hanc.AI.
  • Назви інструментів префіксуються міткою з'єднання (тож "Shop API" + інструмент search_products → Shop_API_search_products). Вбудовані інструменти агента та інші MCP-інструменти не стикатимуться.
  • Описи інструментів та схеми параметрів приходять з вашого MCP-сервера. Пишіть там хороші описи — це те, що AI використовує, щоб вирішити, коли і як викликати інструмент.
  • Помилки повідомляються назад агенту. Якщо виклик інструменту не вдається, агент бачить повідомлення про помилку і може вирішити повторити спробу, вибачитися або спробувати інший інструмент.

Вимоги до вашого MCP-сервера​

Щоб працювати з Hanc.AI, вашому серверу потрібно:

ВимогаДеталь
HTTPSЗвичайний http:// не приймається. Використовуйте справжній TLS-сертифікат.
Публічний URLURL має розпізнаватися на публічну адресу — Hanc.AI не може дістатися серверів у приватній мережі або на localhost.
MCP Streamable HTTP transportПоточний MCP HTTP-транспорт через єдиний ендпоінт. Лише-SSE та stdio-транспорти не підтримуються в цій інтеграції.
Bearer auth (опціонально)Якщо ваш сервер вимагає автентифікації, він має приймати стандартний заголовок Authorization: Bearer <token>.

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

Безпека та приватність​

Ваші bearer-токени зберігаються зашифровано у спокої. Лише інфраструктура дзвінків Hanc.AI може їх розшифрувати, і лише в момент початку дзвінка, коли агенту потрібно підключитися до вашого сервера.

Виклики інструментів течуть агент → Hanc.AI → ваш MCP-сервер → назад. Ми не логуємо payload-и викликів інструментів. Ваш сервер логує те, що ви виберете логувати на своєму боці.

Якщо ви змінюєте або ротуєте свій токен, відредагуйте з'єднання в дашборді — нове значення набуває чинності на наступному дзвінку.

Доступність на тарифах​

ТарифMCP-сервери
FreeДоступно
Starter / Pro / Business / EnterpriseДоступно

Немає плати за з'єднання — ви платите лише за хвилини дзвінків, протягом яких агент викликає інструменти.

Усунення несправностей​

«З'єднання не зберігається»​

  • Переконайтеся, що URL починається з https://, а не з http://.
  • Переконайтеся, що хост публічно доступний — localhost, 127.0.0.1 та внутрішні адреси заблоковані за дизайном.
  • Перевірте bearer-токен, якщо ви його встановили — зайві пробіли або лапки зламають збереження.

«Агент не бачить інструментів»​

  • Перевірте, що запис MCP-сервера на вкладці Actions агента має принаймні одне з'єднання, увімкнене on, і запис збережено.
  • Переконайтеся, що ваш MCP-сервер відповідає на запит tools/list і не вимагає інтерактивного потоку автентифікації.
  • Подивіться в журналі дзвінків агента на повідомлення від MCP-з'єднання прямо на початку дзвінка.

«Інструмент провалюється посеред дзвінка»​

  • Агент побачить будь-яку помилку, яку повертає ваш сервер. Перевірте логи свого сервера.
  • Довгі інструменти можуть тайм-аутитися — тримайте виконання MCP-інструменту під кілька секунд на виклик, щоб відвідувач не сидів у тиші.

«Я змінив інструменти на своєму сервері, але агент все ще використовує старі»​

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

Пов'язане​