> ## 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

> Подключайте серверы Model Context Protocol к чату, своим агентам и Craft

> [!NOTE]
>
> В Yahont CE 0.2 MCP-серверы переехали с отдельной страницы администратора в **Панель администратора → Плагины**. См.
> [Что переехало](https://docs.yahont.ai/admins/plugins/overview.md#where-things-moved-in-onyx-5).

Плагин MCP подключает Yahont к серверу, который работает по [Model Context Protocol](https://modelcontextprotocol.io/).
Yahont — это MCP-клиент. Он находит инструменты на сервере, а агенты вызывают эти инструменты во время разговора.

Плагины MCP работают в обычном чате, в своих агентах и в Craft. Используйте плагин MCP,
если поставщик публикует MCP-сервер,
если вы запускаете собственный сервер или если для приложения нет встроенного [приложения
Craft](https://docs.yahont.ai/admins/plugins/craft_apps.md).

> [!NOTE]
>
> Чтобы другие MCP-клиенты могли использовать Yahont как сервер, см.
> [MCP-сервер Yahont](https://docs.yahont.ai/overview/yahont_anywhere/mcp_server.md).

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

**1. Откройте каталог MCP**

Откройте **Панель администратора → Плагины**, нажмите **Добавить**, затем выберите **MCP**.

![Каталог MCP с записями Linear, Notion, Sentry, Atlassian и пунктом «Добавить свой MCP-сервер»](https://mintcdn.com/yahont-ai/ss_iEGJjM_ytrEBs/assets/admins/plugins/add_mcp_catalog.webp?fit=max\&auto=format\&n=ss_iEGJjM_ytrEBs\&q=85\&s=1f95e30fedfd043f5dfe0c9207e08013)

Выберите запись каталога, чтобы подставить название и адрес сервера этого поставщика.
Для любого другого сервера выберите **Добавить свой MCP-сервер**.

**2. Введите сведения о сервере**

Введите **Название сервера** и **URL сервера MCP**. Yahont проверит сервер и покажет способ аутентификации,
транспорт подключения и поддержку документа метаданных клиента, которые он обнаружил.

![Окно добавления MCP-сервера после того, как Yahont обнаружил отсутствие аутентификации и транспорт Streamable HTTP](https://mintcdn.com/yahont-ai/ss_iEGJjM_ytrEBs/assets/admins/plugins/mcp_custom_filled.webp?fit=max\&auto=format\&n=ss_iEGJjM_ytrEBs\&q=85\&s=dfe38ce2c6f988ea61a7a6b706e75cdb)

API-сервер Yahont должен иметь доступ к этому адресу. При проверках во время настройки Yahont блокирует частные,
loopback- и link-local-адреса.

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

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

| Настройка | Действие |
| - | - |
| **Доступ** | **Вся организация** открывает сервер всем пользователям. **Группы пользователей** ограничивает его выбранными группами. Серверы с ограничением по группам доступны в Yahont Cloud и Enterprise Edition. Менеджер группы должен выбрать хотя бы одну управляемую им группу. |
| **Включить в обычном чате** | Делает инструменты доступными в чатах без своего агента. |
| **Включить для Craft** | Делает инструменты доступными в сеансах и плановых задачах Craft. Этот переключатель показывается, только если Craft включён. |

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

Выберите **Способ аутентификации**. Способ, который обнаружил Yahont, помечен как **Рекомендуется**.
О каждом способе читайте в разделе [Аутентификация](#authentication).

![Меню «Способ аутентификации» с вариантами OAuth, API-ключ и Без аутентификации](https://mintcdn.com/yahont-ai/ss_iEGJjM_ytrEBs/assets/admins/plugins/mcp_auth_methods.webp?fit=max\&auto=format\&n=ss_iEGJjM_ytrEBs\&q=85\&s=c90660650fffb1738f409390b57eaf19)

Нажмите **Подключить**. Yahont получит список инструментов сервера и откроет его настройки.

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

| Способ | Кто входит | Когда использовать |
| - | - | - |
| **Без аутентификации** | Никто | Сервер публичный или защищён сетевыми средствами. |
| **API-ключ**, общий | Администратор, один раз для всех | Все пользователи могут пользоваться одной служебной учётной записью. |
| **API-ключ**, личный | Каждый пользователь | У каждого пользователя есть личный токен, и сервер должен применять права этого пользователя. |
| **OAuth** | Каждый пользователь | Сервер поддерживает OAuth. Каждый пользователь входит под своим аккаунтом. |
| **Сквозной OAuth (OAuth Pass-through)** | Каждый пользователь, со входом в Yahont | Yahont передаёт серверу OAuth-токен пользователя, полученный при входе в Yahont. Способ показывается, только если вход в Yahont идёт через OAuth, OIDC или Google OAuth. |

При личных ключах API и OAuth каждый пользователь подключает свой аккаунт на [странице
«Плагины»](https://docs.yahont.ai/overview/core_features/plugins.md). После этого MCP-сервер возвращает только те данные,
которые доступны аккаунту пользователя.

### OAuth

OAuth — лучший выбор для большинства серверов поставщиков, например Linear, Notion, Atlassian и Sentry.

![Настройки OAuth: «Настроить автоматически», «Свой OAuth-клиент» и «Использовать документ метаданных клиента»](https://mintcdn.com/yahont-ai/ss_iEGJjM_ytrEBs/assets/admins/plugins/mcp_linear_oauth.webp?fit=max\&auto=format\&n=ss_iEGJjM_ytrEBs\&q=85\&s=ca3c87555625499db26aa44bd382ac3a)

| Параметр | Действие |
| - | - |
| **Настроить автоматически** | Yahont регистрирует OAuth-клиент по опубликованным настройкам сервера. Используйте, если сервер поддерживает динамическую регистрацию клиентов. |
| **Свой OAuth-клиент** | Введите client ID от вашего провайдера. Добавьте client secret, только если его требует провайдер. |
| **Использовать документ метаданных клиента** | Провайдер получает документ метаданных клиента Yahont через публичный интернет. Yahont проверяет это при проверке сервера и выключает настройку, когда провайдер не может получить документ. Тогда Yahont пробует автоматическую регистрацию клиента. Если подключение всё равно не удаётся с ошибкой метаданных клиента, выключите эту настройку и подключитесь снова. |

Если вы создаёте собственный OAuth-клиент, укажите для него redirect URI:

```text theme={null}
https://<your-yahont-domain>/mcp/oauth/callback
```

> [!WARNING]
>
> Yahont строит callback-адреса OAuth из `WEB_DOMAIN`. Укажите в `WEB_DOMAIN` адрес,
> который пользователи открывают в браузере.

### API-ключ

![Настройки API-ключа: выбор личного или общего токена и поле для проверочного ключа](https://mintcdn.com/yahont-ai/ss_iEGJjM_ytrEBs/assets/admins/plugins/mcp_api_key.webp?fit=max\&auto=format\&n=ss_iEGJjM_ytrEBs\&q=85\&s=1f1c839aada60b7affe724338179fa39)

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

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

![Дополнительные настройки: «Свои заголовки» и «Транспорт подключения»](https://mintcdn.com/yahont-ai/ss_iEGJjM_ytrEBs/assets/admins/plugins/mcp_advanced.webp?fit=max\&auto=format\&n=ss_iEGJjM_ytrEBs\&q=85\&s=b76064bb20e8f4408abb38cb4a5609ce)

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

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

![Вкладка «Инструменты» со списком инструментов MCP-сервера](https://mintcdn.com/yahont-ai/ss_iEGJjM_ytrEBs/assets/admins/plugins/mcp_tab_tools.webp?fit=max\&auto=format\&n=ss_iEGJjM_ytrEBs\&q=85\&s=6e2921c9df3a9d83a7218dcac4d93c82)

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

Когда Craft включён, вкладка **Настройки одобрения** задаёт политику Craft для каждого инструмента.

![Настройки одобрения с вариантами «Автоодобрение», «Спрашивать» и «Выключено» для каждого инструмента](https://mintcdn.com/yahont-ai/ss_iEGJjM_ytrEBs/assets/admins/plugins/mcp_tools_approval.webp?fit=max\&auto=format\&n=ss_iEGJjM_ytrEBs\&q=85\&s=38cd502ec8874ff13b40da7d81d9ac13)

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

Доступность инструментов и политики Craft — разные настройки. Инструмент,
который вы выключили в разделе **Доступные инструменты**, недоступен нигде.

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

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

![Вкладка «Настройка» MCP-сервера](https://mintcdn.com/yahont-ai/ss_iEGJjM_ytrEBs/assets/admins/plugins/mcp_after_connect.webp?fit=max\&auto=format\&n=ss_iEGJjM_ytrEBs\&q=85\&s=1f91a09d61873285e5f358d2b3563f90)

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

Если вы измените адрес сервера, Yahont удалит сохранённые подключения к этому серверу.
Пользователям придётся подключиться заново.

Чтобы удалить сервер, используйте значок корзины на странице «Плагины». В окне настроек кнопки удаления нет.

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

Откройте редактор агента и выберите MCP-сервер в разделе **Действия**. Затем выберите инструменты,
которые сможет использовать агент. См. [Агенты](https://docs.yahont.ai/admins/agents/overview.md).


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