Skip to main content
В Yahont CE 0.2 MCP-серверы переехали с отдельной страницы администратора в Панель администратора → Плагины. См. Что переехало.
Плагин MCP подключает Yahont к серверу, который работает по Model Context Protocol. Yahont — это MCP-клиент. Он находит инструменты на сервере, а агенты вызывают эти инструменты во время разговора. Плагины MCP работают в обычном чате, в своих агентах и в Craft. Используйте плагин MCP, если поставщик публикует MCP-сервер, если вы запускаете собственный сервер или если для приложения нет встроенного приложения Craft.
Чтобы другие MCP-клиенты могли использовать Yahont как сервер, см. MCP-сервер Yahont.

Добавление MCP-сервера

1

Откройте каталог MCP

Откройте Панель администратора → Плагины, нажмите Добавить, затем выберите MCP.Каталог MCP с записями Linear, Notion, Sentry, Atlassian и пунктом «Добавить свой MCP-сервер»Выберите запись каталога, чтобы подставить название и адрес сервера этого поставщика. Для любого другого сервера выберите Добавить свой MCP-сервер.
2

Введите сведения о сервере

Введите Название сервера и URL сервера MCP. Yahont проверит сервер и покажет способ аутентификации, транспорт подключения и поддержку документа метаданных клиента, которые он обнаружил.Окно добавления MCP-сервера после того, как Yahont обнаружил отсутствие аутентификации и транспорт Streamable HTTPAPI-сервер Yahont должен иметь доступ к этому адресу. При проверках во время настройки Yahont блокирует частные, loopback- и link-local-адреса.
3

Задайте доступность

На той же странице укажите, кто может пользоваться сервером и где он доступен:
4

Настройте аутентификацию

Выберите Способ аутентификации. Способ, который обнаружил Yahont, помечен как Рекомендуется. О каждом способе читайте в разделе Аутентификация.Меню «Способ аутентификации» с вариантами OAuth, API-ключ и Без аутентификацииНажмите Подключить. Yahont получит список инструментов сервера и откроет его настройки.

Аутентификация

При личных ключах API и OAuth каждый пользователь подключает свой аккаунт на странице «Плагины». После этого MCP-сервер возвращает только те данные, которые доступны аккаунту пользователя.

OAuth

OAuth — лучший выбор для большинства серверов поставщиков, например Linear, Notion, Atlassian и Sentry. Настройки OAuth: «Настроить автоматически», «Свой OAuth-клиент» и «Использовать документ метаданных клиента» Если вы создаёте собственный OAuth-клиент, укажите для него redirect URI:
Yahont строит callback-адреса OAuth из WEB_DOMAIN. Укажите в WEB_DOMAIN адрес, который пользователи открывают в браузере.

API-ключ

Настройки API-ключа: выбор личного или общего токена и поле для проверочного ключа Введите ключ, чтобы проверить сервер и загрузить его инструменты. Проверочный ключ сохраняется только в вашем аккаунте.

Дополнительные настройки

Дополнительные настройки: «Свои заголовки» и «Транспорт подключения»
  • Свои заголовки отправляются с каждым запросом. Используйте {api_key} для ключа API каждого пользователя и {user_email} для адреса электронной почты пользователя. Любой другой {placeholder} заставляет Yahont запросить значение у каждого пользователя при подключении.
  • Транспорт подключения по умолчанию — Streamable HTTP. Во время проверки при настройке Yahont сначала пробует Streamable HTTP, затем SSE. Выбирайте SSE (устаревший), только если сервер поддерживает один SSE.

Управление инструментами

Вкладка «Инструменты» со списком инструментов MCP-сервера
  • В разделе Доступные инструменты включайте и выключайте инструменты для всего рабочего пространства.
  • Нажмите Обновить инструменты, когда сервер добавит, удалит или изменит инструменты. Сначала сохраните или отмените отложенные изменения.
Когда Craft включён, вкладка Настройки одобрения задаёт политику Craft для каждого инструмента. Настройки одобрения с вариантами «Автоодобрение», «Спрашивать» и «Выключено» для каждого инструмента Доступность инструментов и политики Craft — разные настройки. Инструмент, который вы выключили в разделе Доступные инструменты, недоступен нигде.
Политики одобрения действуют только в Craft. В обычном чате и в своих агентах агенты вызывают включённые инструменты MCP без запроса.

Вкладка «Настройка»

Вкладка «Настройка» MCP-сервера Если вы измените адрес сервера, Yahont удалит сохранённые подключения к этому серверу. Пользователям придётся подключиться заново. Чтобы удалить сервер, используйте значок корзины на странице «Плагины». В окне настроек кнопки удаления нет.

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

Откройте редактор агента и выберите MCP-сервер в разделе Действия. Затем выберите инструменты, которые сможет использовать агент. См. Агенты.