Перейти к основному содержимому

Подключение MCP-серверов

Интеграция с MCP-серверами (от англ. Model Context Protocol) — ключевой способ расширить возможности вашей системы. MCP-серверы позволяют AI-агентам и процессам безопасно взаимодействовать с внешними системами, базами данных и сервисами. После подключения MCP-сервера вы сможете использовать его функции как шаги в бизнес-процессах или как инструменты для AI-агента.

Платформа Agent Platform поддерживает подключение к разным типам MCP-серверов:

  • Публичные реестры и маркетплейсы (например, Smithery).
  • Приватные self-hosted инсталляции.
  • Сервисы с прямым доступом по URL.
Особенности работы с MCP-серверами
  • Стабильность и доступность: MCP-серверы — это внешние сервисы. Платформа Agent Platform не отвечает за их работу и доступность.
  • Потребление контекста: вызов функций и их описание занимают значительную часть контекстного окна, что может ухудшить качество работы моделей с небольшим контекстом. Рекомендуем использовать модели с большим контекстным окном.
  • Стоимость: использование функций MCP-серверов может быть платным. Уточняйте тарифы у провайдера сервиса.

Создание подключения​

к сведению

Платформа Agent Platform находится в активной разработке и тексты интерфейса могут меняться.

Чтобы добавить MCP-сервер в проект, выполните следующие шаги:

  1. В левом меню перейдите в раздел Интеграции.

  2. Нажмите Добавить и выберите MCP.

  3. Заполните параметры:

    • Название — укажите понятное имя, которое будет отображаться в списке интеграций. Например, Калькулятор тарифов или API базы знаний.

    • URL MCP-сервера — введите адрес, по которому доступен сервер.

    • Имя коллекции — укажите имя для группы функций, полученных с сервера. Оно будет использоваться как префикс и поможет избежать конфликтов при нескольких MCP-интеграциях.

      По нему вы также сможете найти функции в конструкторе.

    • Учетные данные — если требуется аутентификация (например, API-ключ), выберите учетные данные из списка или создайте новые. Если доступ открыт, оставьте поле пустым.

  4. Нажмите Сохранить.

Платформа автоматически подключится к серверу, получит список доступных функций и их параметры. Теперь вы можете использовать их в процессах.

Пример: подключение через Smithery​

Рассмотрим подключение на примере MCP-сервера из публичного реестра Smithery. Этот сервер предоставляет функции для получения содержимого веб-страниц и извлечения данных.

При добавлении интеграции укажем следующие параметры:

  • Название: Fetch
  • URL MCP-сервера: https://server.smithery.ai/@smithery-ai/fetch/mcp?api_key=<server_api_key> — это адрес MCP-сервера с переданным в URL API-ключом для доступа к функциям. Чтобы его получить на сайте Smithery, нажмите Get URL with keys instead.
  • Имя коллекции: fetch
  • Учетные данные: оставим пустым, так как API-ключ уже передан в URL.

После сохранения интеграции она появится в списке, а в конструкторе процессов вы сможете найти функции fetch.fetch_url, fetch.extract_elements и fetch.get_page_metadata:

MCP-сервер в списке интеграций

Использование в процессе​

После подключения вы можете использовать функции MCP на холсте.

Режим «Функция»​

Базовый режим, чтобы использовать функцию как отдельный шаг в процессе.

  • Как работает: система вызывает выбранную функцию с заданными параметрами. Для получения результата в следующем блоке используйте метод Context.getLastFunctionResult().
  • Когда использовать: для задач, где вызов внешней системы — это четкий шаг в процессе. Например: «получить курс валют», «рассчитать доставку», «проверить статус заказа».

Настройка​

  1. В левом меню перейдите в Конструктор → .
  2. Выберите Функции → MCP.
  3. Перетащите функцию на холст и укажите параметры. Вы можете задать их вручную или использовать JavaScript-выражения для динамической подстановки данных, например {{'ID этого канала: ' + Context.getBotId()}}.

Режим «Инструмент»​

Используется совместно с блоком Агент, позволяя AI самостоятельно решать, когда вызывать функцию.

  • Как работает: вы не вызываете функцию напрямую — она становится «инструментом» для агента. Агент сам решает, когда и как ее использовать, исходя из диалога с пользователем.
  • Когда использовать: для гибких систем, где агент взаимодействует с внешним миром: например, «забронируй переговорную» или «какой у меня баланс?».

Подробнее о настройке функций в режиме инструмента смотрите в разделе про блок «Агент».