> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yahont.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Обзор

> Добавляйте MCP-серверы, плагины OpenAPI и приложения Craft на одной странице панели администратора

Плагины дают агентам Yahont доступ к внешним инструментам и сервисам в реальном времени.
С помощью плагина агент может прочитать актуальные данные или выполнить действие,
например отправить ответ в Slack или создать заявку.

Администраторы управляют всеми плагинами в **Панель администратора → Плагины** (`/admin/plugins`).
Пользователи подключают свои аккаунты и задают личные настройки по умолчанию в разделе **Плагины** главного меню
(`/app/plugins`).

![Страница «Плагины» в панели администратора с MCP-сервером, плагином OpenAPI и приложением Craft для Slack](https://mintcdn.com/yahont-ai/ss_iEGJjM_ytrEBs/assets/admins/plugins/plugins_directory.webp?fit=max\&auto=format\&n=ss_iEGJjM_ytrEBs\&q=85\&s=edac1b85fb29dbf0cbeac21abb964ef5)

## Что переехало в Yahont CE 0.2

Начиная с Yahont CE 0.2 MCP-серверы, действия OpenAPI и приложения Craft собраны на одной странице **Плагины**. Серверы,
инструменты, учётные данные и настройки приложений Craft остались прежними. Изменилось только место.

| Раньше | Теперь |
| - | - |
| **Панель администратора → Действия MCP** (`/admin/mcp-actions`) | **Панель администратора → Плагины**, тип **MCP** |
| **Панель администратора → Действия OpenAPI** (`/admin/openapi-actions`) | **Панель администратора → Плагины**, тип **OpenAPI** |
| **Панель администратора → Craft → Приложения** (`/admin/craft/apps`) | **Панель администратора → Плагины**, тип **Приложения Craft** |
| **Craft → Приложения** (`/craft/v1/apps`) | **Плагины** в боковом меню Craft (`/craft/v1/plugins`) |
| Инструменты MCP и OpenAPI в меню **Действия** чата | **Действия → Плагины** в чате и **Плагины** в главном меню (`/app/plugins`) |
| «Действия OpenAPI» и «действия MCP» | «Плагины OpenAPI» и «плагины MCP» |

Старые ссылки открывают новые страницы.

## Типы плагинов

В Yahont есть три типа плагинов. Каждый тип подключает свой вид внешних систем.

| Тип | Что подключает | Где его могут использовать агенты | Когда использовать |
| - | - | - | - |
| [MCP](https://docs.yahont.ai/admins/plugins/mcp.md) | Сервер, который работает по [Model Context Protocol](https://modelcontextprotocol.io/) | Чат, свои агенты и Craft | Поставщик публикует MCP-сервер, или вы запускаете собственный. |
| [OpenAPI](https://docs.yahont.ai/admins/plugins/openapi.md) | REST API, который вы описываете схемой OpenAPI | Чат и свои агенты | У вас есть внутренний или сторонний REST API и нет MCP-сервера. |
| [Приложение Craft](https://docs.yahont.ai/admins/plugins/craft_apps.md) | Каталог конечных точек API одного приложения, например Slack или Gmail | Только Craft | Craft должен действовать от имени каждого пользователя в поддерживаемом приложении, с одобрениями на уровне действий. Требуется Craft. |

> [!TIP]
>
> Один и тот же сервис можно добавить несколько раз. Например,
> добавьте приложение Craft для Slack для Craft и MCP-сервер Slack для чата.

### Плагины и коннекторы

[Коннекторы](https://docs.yahont.ai/admins/connectors/overview.md) и плагины решают разные задачи.

| | Коннекторы | Плагины |
| - | - | - |
| Данные | Индексируют копию документов в поисковый индекс Yahont | Обращаются к внешнему сервису в реальном времени, в момент запроса |
| Права | Yahont применяет права, которые синхронизирует из источника, поэтому каждый пользователь находит только доступные ему документы | Внешний сервис применяет собственные права к аккаунту, который подключил плагин |
| Действия | Только чтение | Чтение и запись, если это разрешают сервис и плагин |

## Добавление плагина

Откройте **Панель администратора → Плагины**, нажмите **Добавить**, затем выберите **MCP**,
**OpenAPI** или **Приложения Craft**. Следуйте руководству для нужного типа плагина: [MCP](https://docs.yahont.ai/admins/plugins/mcp.md),
[OpenAPI](https://docs.yahont.ai/admins/plugins/openapi.md) или [приложения Craft](https://docs.yahont.ai/admins/plugins/craft_apps.md).

![Меню «Добавить» с вариантами MCP, OpenAPI и Приложения Craft](https://mintcdn.com/yahont-ai/ss_iEGJjM_ytrEBs/assets/admins/plugins/plugins_add_menu.webp?fit=max\&auto=format\&n=ss_iEGJjM_ytrEBs\&q=85\&s=d4ad126f8c395448bcfa8e94acbd35c0)

Добавлять приложения Craft могут только полные администраторы.
Фильтр и тип **Приложения Craft** показываются только полным администраторам и только когда Craft доступен.
Пользователи с правом **Управление действиями** могут добавлять и менять плагины MCP и OpenAPI.
Менеджер группы может ограничить MCP-сервер только группами, которыми он управляет.
Только полные администраторы могут менять, какие плагины включены в обычном чате рабочего пространства.

## Страница «Плагины»

Карточки отсортированы по состоянию: сначала активные плагины, затем плагины с проблемами, затем выключенные.

Удаление плагина убирает его из рабочего пространства, из всех своих агентов и у всех пользователей.
Чтобы оставить плагин, но запретить его использование в обычном чате или в Craft,
выключите его переключатель доступности.

## Настройки плагина

Изменения остаются черновиком, пока вы не нажмёте **Сохранить изменения**.

| Вкладка | MCP | OpenAPI | Приложение Craft |
| - | - | - | - |
| **Настройка** | Название, описание, доступ, доступность | Название, описания, схема, обычный чат | Название, доступность |
| **Аутентификация** | Способ аутентификации, свои заголовки, транспорт | Способ аутентификации | Учётные данные поставщика или шаблоны заголовков |
| **Инструменты** | Список инструментов и настройки одобрения в Craft | Список операций только для чтения | Политики одобрения действий |
| **Навыки** | — | — | Навыки, которые учат Craft пользоваться приложением |

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

| Настройка | Кто задаёт | Действие |
| - | - | - |
| **Доступ** (MCP) | Администратор | **Вся организация** или ограничение выбранными **Группы пользователей**. Ограничение по группам доступно в Yahont Cloud и Enterprise Edition. |
| **Включить в обычном чате** (MCP, OpenAPI) | Администратор | Делает плагин доступным в чатах без своего агента. |
| **Включить для Craft** (MCP, приложение Craft) | Администратор | Делает плагин доступным в сеансах и плановых задачах Craft. |
| **Подключение к своему агенту** | Создатель агента | Даёт одному [своему агенту](https://docs.yahont.ai/admins/agents/overview.md) инструменты плагина. Настройки обычного чата на него не влияют. |
| **Личные настройки по умолчанию** | Каждый пользователь | Выключает доступный в рабочем пространстве плагин в обычном чате или в Craft этого пользователя. |
| **Подключение аккаунта** | Каждый пользователь | Входит под аккаунтом пользователя, если плагин использует личный OAuth или личные ключи API. |

Личная настройка может только сузить то, что разрешил администратор.
Если администратор выключил **Включить в обычном чате**, никто не сможет включить плагин в обычном чате. Свои агенты,
которые уже используют плагин, сохраняют его, а его учётные данные и настройки не меняются.

> [!NOTE]
>
> Выбор плагинов MCP и OpenAPI для обычного чата теперь находится на странице «Плагины».
> В разделе **Настройки чата** остались только встроенные инструменты, например «Внутренний поиск» и «Веб-поиск».
> В Terraform `onyx_custom_tool.enabled` задаёт выбор обычного чата для плагина OpenAPI.

## Значки состояния

Значок состояния на каждой карточке показывает, где доступен плагин.
Каждый сегмент значка — отдельное место использования: **Основной чат**, **Свои агенты** и **Craft**.

| Цвет | Значение |
| - | - |
| Зелёный | Включён и готов к работе |
| Оранжевый | Выключен или пользователю нужно войти |
| Серый | Этот тип плагина не поддерживает такое место использования |

## Одобрения в Craft

Craft может попросить пользователя одобрить действие перед выполнением.
Администраторы задают политику для каждого инструмента MCP и каждого действия приложения Craft:

| Политика | Действие |
| - | - |
| **Автоодобрение** | Действие выполняется без запроса. |
| **Спрашивать** | Craft показывает карточку одобрения. Пользователь может одобрить один раз, одобрить на сеанс или отклонить. |
| **Выключено** | Действие не выполняется никогда. Пользователи и плановые задачи не могут это изменить. |

Включите **Разрешить пользователям менять настройки одобрения**,
чтобы пользователи могли выбрать более строгую или более мягкую политику для действий,
которые администратор не выключил.

> [!WARNING]
>
> Политики одобрения действуют только в Craft.
> В обычном чате и в своих агентах агент вызывает инструменты MCP и OpenAPI без запроса на одобрение.
> Выключите в чате инструменты, которые нельзя запускать без проверки.

## Следующие шаги

> [card] [MCP-серверы](https://docs.yahont.ai/admins/plugins/mcp.md)
>
> Подключите MCP-сервер и выберите его инструменты.

> [card] [Плагины OpenAPI](https://docs.yahont.ai/admins/plugins/openapi.md)
>
> Превратите схему REST API в инструменты для агентов.

> [card] [Приложения Craft](https://docs.yahont.ai/admins/plugins/craft_apps.md)
>
> Позвольте Craft действовать от имени каждого пользователя в Slack, Gmail, Notion и других приложениях.

> [card] [Плагины для пользователей](https://docs.yahont.ai/overview/core_features/plugins.md)
>
> Подключайте аккаунты и задавайте личные настройки по умолчанию.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.