Сервер MCP

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

Например, MCP-сервер может предоставлять инструменты для:

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

Вы можете использовать ИИ-агенты с подключенными инструментами MCP при настройке рабочих процессов, используя действие AI Agent.

Подключение сервера MCP к ИИ-агенту

Ainergy поддерживает подключение внешних MCP-серверов к ИИ-агентам.

MCP (Model Context Protocol) позволяет предоставлять ИИ-модели доступ к дополнительным инструментам и данным через единый протокол.

В Ainergy MCP-сервер подключается к адаптеру, после чего инструменты сервера MCP можно использовать в ИИ-агентах, связанных с этим адаптером.

Общая схема:

MCP-сервер
     ↓
MCP-инструменты
     ↓
ИИ-адаптер
     ↓
ИИ-агент

Чтобы подключить MCP-сервер и использовать его инструменты в ИИ-агенте:

1. Создайте запись сервера MCP, проверьте подключение и синхронизируйте методы.
2. Перейдите на форму нужного адаптера и укажите созданный сервер MCP в поле Сервер MCP.
3. (опционально) Включите автоматическое добавление новых методов (инструментов) сервера MCP в связанные адаптеры, если набор инструментов MCP-сервера может изменяться и новые инструменты должны автоматически становиться доступными для адаптера.
4. Настройте ИИ-агента, если это не было сделано ранее, и на его форме выберите Адаптер из шага 2.
5. Проверьте доступность инструментов MCP при выполнении агента.

В результате ИИ-агент сможет обращаться к сторонним сервисам для выполнения поставленных задач.

Создание сервера MCP

---

Для настройки сервера MCP выполните следующие действия:

1. Перейдите в навигаторе в раздел Ainergy → Настройки MCP → Серверы MCP.

2. Нажмите Создать, и заполните поля новой формы.

3. Нажмите Сохранить, чтобы сохранить запись.

4. Нажмите Проверить подключение, чтобы проверить корректность настроек. По окончании проверки вы увидите всплывающее сообщение с результатом. Информация будет также доступна в связанном списке Журнал MCP.

5. Нажмите Синхронизировать инструменты, чтобы обновить список доступных активных инструментов текущего сервера MCP.

   Если в связанном адаптере включено Автоматическое добавление новых методов, новые инструменты будут также добавлены в адаптер автоматически.

Доступные действия:

UI-действие	Описание
Проверить подключение	Нажмите, чтобы проверить подключение к серверу MCP. Результат проверки отобразится во всплывающем сообщении, а также будет доступен в связанном списке Журнал MCP.
Синхронизировать инструменты	Нажмите, чтобы обновить список доступных активных инструментов текущего сервера MCP.

note

Система ежедневно автоматически обновляет инструменты доступных серверов MCP в 3:00 часа ночи.

Поля формы Сервер MCP

Поле	Обязательно	Описание
Заголовок	Да	Укажите название сервера MCP.
Наименование	Да	Системное наименование, формируется автоматически при указании заголовка. Поле доступно для редактирования.
Описание	Нет	Добавьте описание сервера.
URL хоста	Да	Укажите URL хоста для доступа к серверу.
Требуется инициализация	Нет	Установите флажок, если необходима отдельная инициализация сервера.
Активен	Нет	Установите флажок, чтобы сделать сервер доступным для адаптеров.
Скрипт ответа	Да	Добавьте скрипт ответа.

Связанные списки

• Инструменты MCP – список инструментов (методов), доступных для данного сервера MCP.

• Записи VCS – список предыдущих версий записи.

• Журнал MCP – список запросов к серверу с подробными данными о каждом из них, например, проверки соединения, выполнения конкретных методов или инструментов, а также запросы инструментов.

  note

  • В записи Журнал MCP отображена следующая информация:

    • Действие;
    • Код состояния ответа;
    • Запрос;
    • Ответ;
    • Метаданные;
    • Результат скрипта ответа сервера;
    • Результат скрипта ответа инструмента.

  • Просмотр журнала доступен только пользователям с ролью ain_admin.

  • В Журнал MCP сохраняются исключительно данные о запросах, которые прошли валидацию входных данных.

  • Записи журнала удаляются только при удалении связанного адаптера.

Инструменты MCP

Инструменты MCP – методы MCP, с помощью которых ИИ-агенты Ainergy могут самостоятельно, безопасно и единообразно взаимодействовать с внешними программами, базами данных и сервисами.

Если на форме Адаптера установлен флажок Автоматически добавлять новые методы, то при добавлении новых инструментов связанного с ним сервера MCP список методов (инструментов MCP) этого адаптера будет обновляться автоматически.

Список используемых ИИ-агентом инструментов MCP отображается на его форме в связанном списке.

note

В системе все инструменты MCP имеют префикс в формате "mcp + порядковый номер записи инструмента", например mcp1_search_documents, что позволяет его идентифицировать, например, при просмотре информации о проделанной агентом работе.

Пример использования:

Если ИИ-агента подключить к серверу MCP, который использует инструменты для работы с документацией, ИИ-агент сможет:

1. определять, что для выполнения задачи требуется внешняя информация;
2. выбирать подходящие инструменты MCP;
3. передать инструменту MCP необходимые параметры;
4. получать результат;
5. использовать результат при формировании ответа.

Вы можете просмотреть список доступных ассистенту инструментов MCP в связанном списке Инструменты и методы на форме выбранного ассистента из таблицы Omni Assistant (ain_omni_assistant).

Вы можете самостоятельно запретить использование отдельных инструментов MCP в Ainergy. Для этого необходимо снять на их форме флажок Активен.

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

---

Создание записей инструментов MCP происходит автоматически после нажатия Синхронизировать инструменты на форме сервера MCP. Вы также можете создать записи методов вручную в таблице Инструменты MCP (ain_mcp_tool).

Поля формы Инструменты MCP

Поле	Обязательно	Описание
Наименование	Да	Укажите название инструмента.
Сервер MCP	Да	Выберите сервер MCP, на котором этот инструмент будет доступен.
Активен	Нет	Установите флажок, чтобы разрешить использование инструмента MCP для работы в Ainergy.
Доступен на сервере	Нет	Флажок установлен, если инструмент предоставляется подключенным сервером MCP. Если инструмент больше не предоставляется сервером MCP, он отображается как недоступный – флажок снят.
Описание	Нет	Добавьте промпт с описанием поставленной задачи.
Схема инструмента	Да	Добавьте схему.
Скрипт ответа	Да	Добавьте скрипт ответа.

Использование инструментов MCP в рабочих процессах

---

tip

Перед использованием инструментов MCP в рабочих процессах:

• проверьте подключение к MCP-серверу;
• синхронизируйте инструменты;
• убедитесь, что выбранный адаптер связан с нужными серверами MCP;
• проверьте доступность инструментов MCP в ИИ-агенте;
• протестируйте работу агента на реальных запросах;
• при возникновении ошибок проверьте Журнал MCP и Входящие запросы MCP.

Ошибки

Инструмент недоступен

Если нужный инструмент MCP недоступен, проверьте:

1. Доступность MCP-сервера. На форме сервера MCP нажмите Проверить подключение, и затем проверьте результат в связанном списке Журнал MCP.
2. Результат последней синхронизации в связанном списке Журнал MCP. Выполните синхронизацию повторно.
3. Наличие инструмента на самом сервере MCP.

Журнал MCP

Информация о запросах к серверам MCP и возникших ошибках хранится в разделе Ainergy → Настройки MCP → Журнал MCP.

Там вы можете ознакомиться с тем, какой запрос был выполнен, к какому Серверу MCP было обращение, какой получен Ответ, Код состояния ответа, Результат скрипта ответа инструмента и Результат скрипта ответа сервера. По умолчанию отображаются не все вышеперечисленные поля, вынесите их на представление списка, если необходимо.

В таблице Входящие запросы MCP (ain_mcp_incoming_request) вы можете проанализировать данные входящих запросов.