MCP-серверы
MCP — Model Context Protocol — открытый стандарт, позволяющий AI-ассистентам находить и вызывать внешние tools. Если у вас MCP-совместимый сервер (свой или один из множества community-серверов), подключите его в Hanc.AI — и агенты получат tools сервера в момент начала звонка.
После подключения агент может вызывать эти tools в разговоре — забирать live-данные, делать расчёты, запускать backend-воркфлоу — точно как встроенные интеграции с Calendar, HubSpot или API Tool.
MCP-серверы доступны на всех тарифах, включая Free. Никакой платы за сервер — вы платите только за минуты звонков, когда агент вызывает tools.
Когда использовать MCP
| Сценарий | Почему подходит MCP |
|---|---|
| У вас уже есть внутренний tool-сервер | Одно подключение — все tools доступны каждому агенту |
| Хотите делиться tools между агентами | Подключите раз, цепляйте на любое число агентов |
| Используете community MCP-серверы | Подключайте популярные open-source MCP-серверы без своего кода |
| Набор tools часто меняется | Агент заново обнаруживает tools на каждом звонке — добавляйте/удаляйте tools на сервере без правки в панели |
Если у вас один разовый эндпоинт, проще использовать API Tool. Если есть набор связанных tools или уже поддерживаете MCP-сервер — это правильная интеграция.
Подключение MCP-сервера
1. Откройте Integrations
В боковой панели → Integration. Прокрутите до раздела MCP servers.
2. Нажмите «Connect MCP server»
Откроется модалка. Заполните:
| Поле | Описание |
|---|---|
| Label | Короткое имя подключения (например, "Sales Tools", "Internal CRM"). Label показывается в пикере tools агента и префиксует имена tools, видимые AI — держите его коротким и осмысленным. |
| URL | HTTPS URL вашего MCP-сервера. Должен быть публично достижим — http:// и приватные/внутренние адреса отклоняются. |
| Authentication | None, если сервер открыт, или Bearer token, если ожидает заголовок Authorization: Bearer …. |
| Token | (Только для Bearer) Ваш токен. Хранится зашифрованно — только ваш аккаунт может расшифровать. |
Нажмите Save. Hanc.AI проверяет формат URL и сохраняет подключение. Оно становится доступно каждому агенту в рабочем пространстве.
Имена tools каждого MCP-сервера префиксуются label подключения. MCP-сервер с tool lookup_order, подключённый как "Shop API", появится у агента как Shop_API_lookup_order. Это предотвращает коллизии, когда у разных MCP-серверов одинаковые имена.
3. Редактирование, отключение, удаление
Список MCP-серверов показывает label, URL, тип аутентификации и статус каждого подключения. В строках действий:
- Edit — поменять label, URL, тип авторизации или токен
- Delete — полностью удалить подключение
Удаление подключения деактивирует его для каждого агента, к которому оно было прицеплено — эти агенты просто теряют доступ к его tools на следующем звонке.
Привязка MCP-tools к агенту
Подключение в рабочем пространстве доступно агентам — но каждый агент сам решает, какие из ваших подключений открывать. Это позволяет иметь отдельных Sales- и Support-агентов, тянущих с разных MCP-серверов.
1. Откройте вкладку Actions агента
Выберите агента. Вкладка Actions. Нажмите Add Action.
2. Выберите «MCP servers» из группы Live-call
Выпадающий список показывает три группы: Pre fetch, Live call, Post call. MCP-серверы — в группе Live-call, потому что агент вызывает MCP-tools во время разговора, а не до или после.
3. Переключите нужные подключения
Модалка показывает каждое MCP-подключение рабочего пространства с переключателем on/off. Включите те, которые нужны этому агенту. Можно написать короткую инструкцию в поле «When to use it» — её читает агент, чтобы понять, когда тянуться к этим tools в разговоре.
Нажмите Save. Теперь у агента доступ к tools каждого включённого MCP-подключения.
Одно MCP-подключение можно включить на пяти агентах, другое — только на одном. У каждого агента свой MCP servers tool со своим набором переключателей.
Как это работает во время звонка
Когда звонок начинается, агент подключается к каждому из включённых MCP-серверов и спрашивает «какие tools у тебя есть?». Что бы сервер ни вернул — становится доступным AI как tool, который он может вызвать в разговоре.
Что важно знать:
- Tools обнаруживаются в начале звонка. Если вы добавляете или удаляете tools на MCP-сервере, изменение видно на самом следующем звонке — менять что-либо в Hanc.AI не нужно.
- Имена tools префиксуются label подключения (так что
"Shop API"+ toolsearch_products→Shop_API_search_products). Встроенные tools агента и другие MCP-tools не столкнутся. - Описания tools и схемы параметров приходят с вашего MCP-сервера. Пишите хорошие описания — именно их использует AI, решая, когда и как вызвать tool.
- Ошибки возвращаются агенту. Если tool падает, агент видит сообщение об ошибке и может решить — повторить, извиниться или попробовать другой tool.
Требования к вашему MCP-серверу
Чтобы работать с Hanc.AI, сервер должен:
| Требование | Деталь |
|---|---|
| HTTPS | Простой http:// не принимается. Используйте настоящий TLS-сертификат. |
| Публичный URL | URL должен резолвиться в публичный адрес — Hanc.AI не дотянется до серверов в приватной сети или на localhost. |
| MCP Streamable HTTP transport | Текущий MCP HTTP-транспорт через один эндпоинт. SSE-only и stdio-транспорты этой интеграцией не поддерживаются. |
| Bearer auth (опционально) | Если сервер требует аутентификацию, он должен принимать стандартный заголовок Authorization: Bearer <token>. |
Если хостите свой сервер за firewall, выставьте его через туннель или reverse-proxy с публичным HTTPS-эндпоинтом.
Безопасность и приватность
Ваши bearer-токены хранятся зашифрованно at rest. Только инфраструктура звонков Hanc.AI может их расшифровать, и только в момент начала звонка, когда агенту нужно подключиться к серверу.
Вызовы tools идут: агент → Hanc.AI → ваш MCP-сервер → обратно. Мы не логируем payload вызовов. Ваш сервер логирует то, что вы решите логировать.
При смене или ротации токена отредактируйте подключение в панели — новое значение применится на следующем звонке.
Доступность по тарифам
| Тариф | MCP-серверы |
|---|---|
| Free | Доступно |
| Starter / Pro / Business / Enterprise | Доступно |
Платы за подключение нет — вы платите только за минуты звонков, в течение которых агент вызывает tools.
Решение проблем
«Connection won't save»
- Убедитесь, что URL начинается с
https://, а неhttp://. - Убедитесь, что хост публично достижим —
localhost,127.0.0.1и внутренние адреса заблокированы по дизайну. - Перепроверьте bearer-токен, если задавали — лишние пробелы или кавычки сломают сохранение.
«Agent doesn't see the tools»
- Проверьте, что запись MCP server на вкладке Actions агента имеет хотя бы одно включённое подключение и запись сохранена.
- Убедитесь, что ваш MCP-сервер отвечает на tools/list-запрос и не требует интерактивного auth-флоу.
- Загляните в лог звонка агента — сообщения от MCP-подключения должны быть прямо в начале звонка.
«Tool fails mid-call»
- Агент увидит любую ошибку, которую вернёт сервер. Проверьте логи сервера.
- Долгие tools могут отвалиться по таймауту — держите выполнение MCP-tool в пределах нескольких секунд за звонок, чтобы посетитель не сидел в тишине.
«Я изменил tools на сервере, но агент использует старые»
- Tools переоткрываются в начале каждого звонка, не кешируются между звонками. Следующий новый звонок видит обновлённый набор. Идущие звонки сохраняют tools, которые получили в начале.
Связанное
- Actions & Tools — встроенные tools и как организована вкладка Actions
- Интеграции — все доступные интеграции
- API Tool RAG — простой вариант для одного эндпоинта