Эта страница о том, как использовать external MCP server как tool внутри voice agent. Если вы хотите, чтобы Claude, Cursor или другой coding agent управлял самой Агентикой через MCP, см. MCP-сервер Агентики.
MCP tools позволяют голосовому агенту Агентики вызывать tools, опубликованные удаленным server Model Context Protocol, во время live-разговора. Агентика обнаруживает remote tool catalog, превращает эти tools в LLM-callable functions и пересылает invocations на MCP server через authenticated Streamable HTTP.

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

MCP tool в Агентике состоит из четырех важных частей:
  • Name: label server, который отображается в Агентике
  • Description: объясняет LLM, когда этот MCP server релевантен
  • URL: endpoint удаленного MCP server (http:// или https://)
  • Credential: auth, который Агентика должна отправлять при подключении к server
Также можно задать tool filter, чтобы разрешить только конкретные remote MCP tools.

​
Authentication

Большинство hosted MCP servers ожидают:
Поэтому перед созданием MCP tool создайте credential в Агентике:
  • Credential Type: Bearer Token
  • Token: access token, выданный MCP server
Затем выберите этот credential в MCP tool.
Если documentation удаленного MCP server говорит использовать Bearer auth, выберите Bearer Token в credential dialog. Агентика преобразует это в точный header Authorization: Bearer <token> на MCP connection.
Агентика поддерживает и другие credential types, но Bearer Token — default, с которого стоит начинать для third-party MCP servers, если их docs не говорят иначе.

​
Как это работает

Runtime path:
  1. Когда вы сохраняете или refresh MCP tool, Агентика открывает short-lived authenticated MCP session и получает remote tool catalog.
  2. Агентика сохраняет этот catalog как discovered tools, чтобы UI мог показать, какие remote functions существуют.
  3. Когда звонок начинается, Агентика открывает один live MCP session на каждый attached MCP server и переиспользует выбранный credential.
  4. Для каждого node Агентика exposes только MCP tools, разрешенные server-level filter и node-level selection.
  5. Агентика namespaces remote tools в обычные LLM function definitions, чтобы они безопасно сосуществовали с HTTP API tools, call transfer, end call и другими tools.
  6. Во время разговора LLM видит только tool name, description и argument schema. Secret она не видит.
  7. Когда LLM вызывает один из tools, Агентика пересылает invocation на MCP server через активную authenticated session, получает result и передает его обратно в turn агента.
Коротко: Агентика берет на себя discovery, authentication, session management, tool registration и result plumbing; LLM только решает, когда вызвать tool и с какими arguments.

​
Создание MCP tool

  1. Перейдите в Tools и создайте новый tool.
  2. Выберите MCP Server.
  3. Введите понятное name и description, которое объясняет, когда LLM должна использовать этот server.
  4. Вставьте MCP server URL.
  5. Выберите credential. В большинстве случаев это должен быть Bearer Token credential.
  6. Сохраните tool и убедитесь, что Агентика обнаружила remote tools.
Если server exposes много tools, используйте filtering и оставьте только те, которые действительно нужны агенту.

​
Прикрепление к node

После создания MCP tool:
  1. Откройте workflow node, где tool должен быть доступен.
  2. Добавьте MCP tool из tool list узла.
  3. Выберите только те remote MCP functions, которые можно вызывать в этом node.
  4. В node prompt точно укажите LLM, когда использовать эти functions.
Чем строже node-level selection и prompt guidance, тем надежнее будет использование MCP tools.

​
Best practices

  • По возможности используйте один MCP server на одну логическую integration.
  • В tool description явно пишите, когда LLM должна использовать этот server.
  • Expose только минимум remote functions, нужных каждому node.
  • Предпочитайте Bearer Token credential, если MCP server не требует другую auth scheme.
  • Сначала протестируйте discovery, затем реальный phone/web call, чтобы подтвердить, что LLM вызывает нужную MCP function с правильными arguments.
Если remote MCP server временно недоступен, Агентика gracefully degrades: звонок может продолжиться без этих MCP tools, а не падает весь разговор.