Эта страница о том, как использовать внешний MCP-сервер как инструмент внутри голосового агента. Если вы хотите, чтобы Claude, Cursor или другой агент для программирования управлял самой Агентикой через MCP, см. MCP-сервер Агентики.
MCP-инструменты позволяют голосовому агенту Агентики вызывать инструменты, опубликованные на удалённом сервере Model Context Protocol, во время живого разговора. Агентика обнаруживает каталог удалённых инструментов, превращает эти инструменты в функции, доступные для вызова LLM, и пересылает вызовы на MCP-сервер через аутентифицированный Streamable HTTP.

​
Что настроить

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

​
Аутентификация

Большинство облачных MCP-серверов ожидают:
Поэтому перед созданием MCP-инструмента создайте учётные данные в Агентике:
  • Тип учётных данных: Bearer Token
  • Токен: access-токен, выданный 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-инструментами, переключением звонка, завершением звонка и другими инструментами.
  6. Во время разговора LLM видит только название инструмента, описание и схему аргументов. Секрет она не видит.
  7. Когда LLM вызывает один из инструментов, Агентика пересылает вызов на MCP-сервер через активную аутентифицированную сессию, получает результат и передает его обратно в ход разговора агента.
Коротко: Агентика берет на себя обнаружение, аутентификацию, управление сессиями, регистрацию инструментов и передачу результатов; LLM только решает, когда вызвать инструмент и с какими аргументами.

​
Создание MCP-инструмента

  1. Перейдите в Инструменты и создайте новый инструмент.
  2. Выберите MCP-сервер.
  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-инструментов, а не падает весь разговор.