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

MCP-клиенты

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

Управлять ими можно в разделе Настройки › Автоматизация › AI-клиенты MCP.

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

  1. Вы добавляете адрес MCP-сервера и подключаетесь. MonoChat считывает то, что предлагает сервер: его Инструменты, Ресурсы, Шаблоны ресурсов и Промпты.
  2. При сохранении MonoChat сохраняет этот список как содержимое клиента.
  3. В узле Создать AI-ответ в чате или узле AI-агент вы выбираете инструменты, которые должны быть у этого узла, и можете переписать описание каждого инструмента для модели.
  4. Во время разговора модель сама решает, когда вызвать инструмент; MonoChat обращается к MCP-серверу и возвращает результат модели.

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

Добавление MCP-клиента​

  1. Перейдите в Настройки › Автоматизация › AI-клиенты MCP и нажмите + (Создать).

  2. Заполните поля:

    ПолеОписание
    НазваниеНазвание сервера, которое отображается рядом с каждым из его инструментов в панелях узлов.
    ОписаниеНеобязательные заметки.
    ВерсияВерсия клиента, о которой MonoChat сообщает серверу при подключении, например 1.0.0.
    Конечная точкаБазовый URL MCP-сервера. MonoChat подключается по транспорту SSE по адресу <Endpoint>/sse, поэтому вводите адрес без /sse.
    Тип авторизацииNone, Basic (с полями Имя пользователя и Пароль) или Bearer (с полем Токен). Учётные данные сохраняются вместе с клиентом.

  3. Нажмите Подключить. MonoChat подключится к серверу и покажет найденное во вкладках:

    • Информация о сервере: Название, Версия, Версия протокола и Инструкции сервера.
    • Инструменты: название и описание каждого инструмента.
    • Ресурсы, Шаблоны ресурсов и Промпты, если сервер их предлагает.

  4. Если список выглядит правильно, нажмите Сохранить. Чтобы изменить адрес и попробовать снова, нажмите кнопку Отключить рядом.

подсказка

Если Подключить не срабатывает, проверьте, что конечная точка доступна из интернета, что сервер поддерживает транспорт SSE и что URL ещё не заканчивается на /sse.

Обновление списка инструментов​

Когда MCP-сервер добавляет или изменяет инструменты, откройте клиент через Обновить. MonoChat подключится заново и покажет актуальное содержимое; нажмите Обновить, чтобы сохранить новый список.

Удаление клиента также удаляет его содержимое, поэтому узлы теряют инструменты, которые были получены из него.

Передача инструментов узлу​

Узел «Создать AI-ответ в чате»​

  1. Откройте узел и прокрутите до раздела Настройки инструментов контента MCP-клиента AI.
  2. Нажмите Настроить инструменты контента MCP-клиента AI. В панели Инструменты контента MCP-клиента AI перечислены инструменты, уже добавленные в этот узел.
  3. Нажмите + (Создать), затем выберите инструмент в поле Инструменты контента MCP-клиента AI. Инструменты отображаются в виде <client name> - <tool name>.
  4. Поле Описание заполняется собственным описанием инструмента. Измените его, если хотите точнее объяснить модели, когда использовать инструмент, например «Используйте это, чтобы найти заказ по его номеру». Описание обязательно.
  5. Повторите для каждого инструмента, затем сохраните узел.

В той же панели можно обновить описание инструмента или удалить его из узла.

Узел «AI-агент»​

В узле AI-агент в разделе Настройки инструментов есть та же кнопка Настроить инструменты контента MCP-клиента AI. Выбранные MCP-инструменты предлагаются агенту вместе с AI-областями и AI-инструментами узла, в любой оболочке (harness). См. AI-агенты.

к сведению

Запуск агента проверяет, что все MCP-инструменты узла всё ещё существуют в вашем рабочем пространстве. Если вы удалите MCP-клиент, который использует узел, запуски этого узла будут завершаться ошибкой «AI-область или инструмент MCP не найдены в этом рабочем пространстве.», пока вы не удалите инструмент из узла.

Права доступа​

Доступ регулируется правами роли Просмотр / Создание / Обновление / Удаление клиентов AI MCP в автоматизации и Просмотр содержимого клиентов AI MCP в автоматизации. См. Роли.