Skip to main content
MCP-інструменти дозволяють голосовому агенту викликати інструменти, які надає віддалений сервер Model Context Protocol, під час живої розмови. Платформа виявляє каталог віддалених інструментів, перетворює їх на функції, доступні для виклику LLM, і передає виклики на MCP-сервер через автентифікований Streamable HTTP.

​
Що потрібно налаштувати

MCP-інструмент має чотири важливі складові:
  • Назва: мітка сервера, що відображається на платформі.
  • Опис: підказує LLM, коли цей MCP-сервер релевантний.
  • URL: ендпоінт віддаленого MCP-сервера (http:// або https://).
  • Облікові дані: автентифікація, яку платформа надсилає при підключенні до цього сервера.
Також можна налаштувати фільтр інструментів, щоб дозволити лише певні віддалені MCP-інструменти.

​
Автентифікація

Більшість хостованих MCP-серверів очікують:
Тож перед створенням MCP-інструмента створіть облікові дані з:
  • Тип облікових даних: Bearer Token
  • Токен: токен доступу, виданий вашим MCP-сервером
Потім оберіть ці облікові дані для MCP-інструмента.
Якщо документація віддаленого MCP-сервера каже використовувати Bearer-автентифікацію, оберіть Bearer Token у діалозі облікових даних. Платформа перетворить це на точний заголовок Authorization: Bearer <token> при підключенні до MCP.
Платформа також підтримує інші типи облікових даних, але Bearer Token — типовий варіант для сторонніх MCP-серверів, якщо їхня документація не вказує інше.

​
Як це працює

Послідовність виконання:
  1. Коли ви зберігаєте чи оновлюєте MCP-інструмент, платформа відкриває короткочасну автентифіковану MCP-сесію й отримує каталог віддалених інструментів.
  2. Платформа зберігає цей каталог як виявлені інструменти, щоб в інтерфейсі було видно, які віддалені функції існують.
  3. Коли починається дзвінок, платформа відкриває одну активну MCP-сесію на кожен прикріплений MCP-сервер і використовує обрані облікові дані для цієї сесії.
  4. Для кожного вузла платформа надає лише ті MCP-інструменти, що дозволені фільтром на рівні сервера і вибором на рівні вузла.
  5. Платформа розміщує ці віддалені інструменти в просторі назв як звичайні функції LLM, щоб вони могли безпечно співіснувати з HTTP API-інструментами, переведенням дзвінка, завершенням дзвінка та іншими інструментами.
  6. Під час розмови LLM бачить лише назву інструмента, опис і схему аргументів. Вона не бачить секрет автентифікації.
  7. Коли LLM викликає один з цих інструментів, платформа передає виклик на MCP-сервер через активну автентифіковану сесію, отримує результат і повертає його в хід агента.
Коротко: платформа бере на себе виявлення, автентифікацію, керування сесіями, реєстрацію інструментів і передачу результатів; LLM лише вирішує, коли викликати інструмент і з якими аргументами.

​
Створення MCP-інструмента

  1. Перейдіть у розділ інструментів і створіть новий.
  2. Оберіть MCP Server.
  3. Введіть чітку назву й опис, що пояснює, коли LLM має використовувати цей сервер.
  4. Вставте URL MCP-сервера.
  5. Оберіть облікові дані. У більшості випадків це мають бути облікові дані Bearer Token.
  6. Збережіть інструмент і переконайтесь, що платформа виявила віддалені інструменти.
Якщо сервер надає багато інструментів, скористайтесь фільтрацією, щоб залишити лише ті, які справді потрібні агенту.

​
Прикріплення до вузла

Після створення MCP-інструмента:
  1. Відкрийте вузол сценарію, де інструмент має бути доступний.
  2. Додайте MCP-інструмент зі списку інструментів вузла.
  3. Оберіть лише ті віддалені MCP-функції, які мають бути доступні на цьому вузлі.
  4. У промпті вузла чітко вкажіть LLM, коли саме використовувати ці функції.
Чим точніший вибір на рівні вузла й чіткіші інструкції в промпті, тим надійніше працює MCP-інструмент.

​
Найкращі практики

  • За можливості використовуйте один MCP-сервер на одну логічну інтеграцію.
  • Робіть опис інструмента явним щодо того, коли LLM має використовувати цей сервер.
  • Надавайте доступ лише до мінімально необхідних віддалених функцій для кожного вузла.
  • Надавайте перевагу обліковим даним Bearer Token, якщо MCP-сервер не вказує іншу схему автентифікації.
  • Спочатку перевірте виявлення, потім протестуйте реальним телефонним чи веб-дзвінком, щоб переконатись, що LLM викликає потрібну MCP-функцію з правильними аргументами.
Якщо віддалений MCP-сервер тимчасово недоступний, платформа коректно продовжує роботу — дзвінок може тривати без цих MCP-інструментів, замість того щоб перервати всю розмову.