> ## 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 (MCP) в Yahont Model Context Protocol (MCP) позволяет ИИ-агентам контролируемо вызывать инструменты и сервисы. Yahont можно настроить как MCP-клиент, чтобы ваши агенты получали данные или выполняли операции. > [!TIP] > > Yahont также может выступать в роли MCP-сервера! > Руководство по [MCP-серверу Yahont](/overview/yahont_anywhere/mcp_server) расскажет, как подключить Claude, > Cursor и другие ИИ-инструменты к вашей базе знаний Yahont. ## MCP в Yahont **1. Откройте панель действий** Нажмите значок профиля пользователя, выберите **Панель администратора** и откройте вкладку **MCP-действия** на боковой панели. ![Панель MCP-действий в панели администратора Yahont](https://mintcdn.com/yahont-ai/GgKRVXXDNIirDkuK/assets/admins/actions/mcp_actions.png?fit=max\&auto=format\&n=GgKRVXXDNIirDkuK\&q=85\&s=b755907f2b26d35f9690f8d6f5722cf6) **2. Добавьте MCP-сервер в Yahont** Нажмите кнопку **Добавить сервер MCP** и заполните следующие поля: ![Диалог добавления MCP-сервера в панели администратора Yahont](https://mintcdn.com/yahont-ai/uOUoHpXrpfUMZdwx/assets/overview/core_features/mcp.png?fit=max\&auto=format\&n=uOUoHpXrpfUMZdwx\&q=85\&s=a86e17f1a544234217f72d649b614c3f) * **Название сервера** — понятное название этого MCP-сервера. Обычно это название сервиса, к которому вы подключаетесь (например, «Slack», «Jira»). * **Описание** — любая дополнительная информация, помогающая определить сервер. Полезно, чтобы различать несколько настроенных подключений к MCP-серверам, работающим с одним и тем же сервисом. * **URL MCP-сервера** — URL MCP-сервера, который должен быть доступен из вашего инстанса Yahont. Большинство URL заканчиваются на `/mcp`, а у старых серверов — на `/sse`. * **Управляемый MCP-сервер:** URL обычно указан в документации поставщика в описании подключения. * **MCP-сервер с самостоятельным размещением:** сервер нужно запускать в режиме транспорта HTTP — Yahont сейчас не поддерживает подключение через stdio. Если сервер работает на той же машине, что и Yahont, используйте `http://127.0.0.1:`. В остальных случаях используйте URL и порт, по которому сервер доступен. Когда вы нажмёте **Добавить сервер**, Yahont создаст сервер в состоянии **отключён**. Следующие шаги настроят аутентификацию (если она нужна) и проверят, что Yahont может к нему подключиться. **3. Настройте аутентификацию на MCP-сервере** ![Настройка аутентификации MCP-сервера в Yahont](https://mintcdn.com/yahont-ai/GgKRVXXDNIirDkuK/assets/admins/actions/mcp_config.png?fit=max\&auto=format\&n=GgKRVXXDNIirDkuK\&q=85\&s=40569a5033f48acb19e4a556ce7b3272) Yahont поддерживает четыре типа аутентификации при подключении к MCP-серверу: ### Без аутентификации Используйте, если MCP-сервер не защищён. Обычно это нужно только для тестирования при подключении к локальному MCP-серверу из локального инстанса Yahont, но может пригодиться, если сервер развёрнут внутри VPC и вы хотите, чтобы все пользователи имели к нему одинаковый неограниченный доступ. ### API-ключ Сервер защищён аутентификацией по API-ключу, обычно в формате `Authorization: Bearer `. Есть два подрежима: * **Общий ключ** — администратор настраивает один API-ключ, используемый для всех запросов пользователей. Похоже на «Без аутентификации»: пользователям не нужна дополнительная настройка, и у всех будет одинаковый уровень доступа (тот, что даёт выбранный вами API-ключ). * **Индивидуальный ключ** — пользователи проходят аутентификацию в диалоге, указывая собственные API-ключи для подключения к серверу. Полезно, если нужно, чтобы доступ к внешнему сервису различался в зависимости от личности пользователя. Этот режим также самый гибкий: Yahont позволяет администратору задать произвольные шаблоны заголовков, отправляемых на MCP-сервер. ### OAuth Многие современные MCP-серверы поддерживают аутентификацию OAuth, чтобы дать пользователям доступ к инструментам и данным через тот же процесс входа, который они используют при ручной работе с сервисом. Многие MCP-серверы с поддержкой OAuth поддерживают [Client ID Metadata Documents (CIMD)](https://datatracker.ietf.org/doc/draft-ietf-oauth-client-id-metadata-document/) или [Dynamic Client Registration (DCR)](https://datatracker.ietf.org/doc/html/rfc7591). Эти стандарты позволяют Yahont подключаться без вручную настроенных **Client ID** и **Client Secret**. В большинстве случаев достаточно нажать **Подключить** и пройти процесс OAuth. Если по документации MCP-сервера нужно зарегистрировать приложение OAuth: 1. Создайте приложение OAuth в IdP (поставщике удостоверений), который использует MCP-сервер. 2. Добавьте в приложение следующий callback-URL Yahont: `https:///mcp/oauth/callback` 3. Введите сгенерированные **Client ID** и **Client Secret** в Yahont и нажмите **Подключить**. > [!NOTE] > > В HTTPS-развёртываниях Yahont автоматически публикует и использует CIMD уровня развёртывания с брендингом Yahont > по адресу `https:///api/mcp/oauth/client-metadata`, если сервер авторизации его поддерживает. > При локальной разработке по HTTP вместо этого используется DCR. ### Сквозной OAuth Доступно только если ваш инстанс Yahont настроен на аутентификацию через OAuth. В этом режиме Yahont передаёт OAuth-токен доступа пользователя на MCP-сервер в заголовке `Authorization: Bearer`. Чаще всего это полезно, если ваша организация размещает собственные MCP-серверы и не хочет, чтобы пользователям пришлось проходить аутентификацию повторно после входа в Yahont через OAuth. Многие MCP-серверы требуют области (scopes), которые Yahont по умолчанию не запрашивает при входе. Точные области смотрите в документации MCP-сервера, затем добавьте их в переопределение областей через запятую для вашего типа аутентификации: * **Google OAuth:** `GOOGLE_OAUTH_SCOPE_OVERRIDE` * **OIDC:** `OIDC_SCOPE_OVERRIDE` Эти настройки заменяют области по умолчанию, поэтому сохраните `openid`, `email` и `profile` вместе с дополнительными областями. Примеры смотрите в разделах [настройка областей Google OAuth](/deployment/authentication/oauth#customizing-requested-scopes) и [настройка областей OIDC](/deployment/authentication/oidc#customizing-requested-scopes). > [!NOTE] > > Запрос области в Yahont не гарантирует, что поставщик удостоверений её выдаст. > Область также должна быть доступна и разрешена для клиента OAuth/OIDC Yahont у поставщика удостоверений, > а некоторые поставщики требуют согласия администратора. Точная настройка зависит от поставщика. > Выданный токен доступа должен содержать и нужные области, и аудиторию (audience), принимаемую MCP-сервером. *** Нажатие **Подключить** проверит, что Yahont может обратиться к MCP-серверу с выбранным способом аутентификации. Затем на панели MCP-действий администратор может вывести список инструментов MCP-сервера и выбрать, какое подмножество инструментов будет доступно для использования в агентах по всей организации. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.