> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ukrgsm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP-інструмент

> Підключіть зовнішній MCP-сервер до голосового агента, щоб LLM могла викликати його віддалені інструменти під час живої розмови.

MCP-інструменти дозволяють голосовому агенту викликати інструменти, які надає віддалений сервер [Model Context Protocol](https://modelcontextprotocol.io/), під час живої розмови. Платформа виявляє каталог віддалених інструментів, перетворює їх на функції, доступні для виклику LLM, і передає виклики на MCP-сервер через автентифікований Streamable HTTP.

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

MCP-інструмент має чотири важливі складові:

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

Також можна налаштувати **фільтр інструментів**, щоб дозволити лише певні віддалені MCP-інструменти.

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

Більшість хостованих MCP-серверів очікують:

```http theme={null}
Authorization: Bearer <token>
```

Тож перед створенням MCP-інструмента створіть облікові дані з:

* **Тип облікових даних**: `Bearer Token`
* **Токен**: токен доступу, виданий вашим MCP-сервером

Потім оберіть ці облікові дані для MCP-інструмента.

<Note>
  Якщо документація віддаленого MCP-сервера каже використовувати Bearer-автентифікацію, оберіть **Bearer Token** у діалозі облікових даних. Платформа перетворить це на точний заголовок `Authorization: Bearer <token>` при підключенні до MCP.
</Note>

Платформа також підтримує інші типи облікових даних, але **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-функцію з правильними аргументами.

<Note>
  Якщо віддалений MCP-сервер тимчасово недоступний, платформа коректно продовжує роботу — дзвінок може тривати без цих MCP-інструментів, замість того щоб перервати всю розмову.
</Note>