diff --git a/content/documentation/admin/security/rbac.ru.md b/content/documentation/admin/security/rbac.ru.md index 4c49d59..86f69be 100644 --- a/content/documentation/admin/security/rbac.ru.md +++ b/content/documentation/admin/security/rbac.ru.md @@ -85,6 +85,14 @@ weight: 20 - `update:dashboards` — редактирование дашбордов. - `delete:dashboards` — удаление дашбордов. +MCP: +- `read:mcp-servers` — просмотр подключённых MCP-серверов. +- `edit:mcp-servers` — подключение, редактирование, синхронизация каталога и удаление MCP-серверов. +- `read:mcp-collections` — просмотр MCP-коллекций. +- `edit:mcp-collections` — создание, редактирование и удаление MCP-коллекций. +- `read:mcp-tools` — просмотр пользовательских MCP-инструментов. +- `edit:mcp-tools` — создание, редактирование и удаление пользовательских MCP-инструментов. + Внешние сервисы: - `create:external-services` — создание внешних сервисов. - `read:external-services` — просмотр внешних сервисов. @@ -132,6 +140,7 @@ weight: 20 - `view:admin-page` — доступ к разделу «Администрирование». - `view:self-service-page` — доступ к разделу «Самообслуживание». +- `view:ai-page` — доступ к разделу «AI». {{< alert level="info" >}} Без соответствующих `view:` разрешений пользователь не сможет увидеть разделы в навигационном меню, даже если у него есть другие разрешения для работы с объектами в этих разделах. @@ -161,6 +170,12 @@ weight: 20 - `control:processes` — управление процессами для сущности. - `edit:role-bindings` — редактирование привязок ролей для сущности. +#### MCP-коллекции + +Для MCP-коллекций: +- `use:mcp-collections` — вызов инструментов коллекции в AI-ассистенте и через MCP-сервер платформы. +- `edit:role-bindings` — редактирование привязок ролей для коллекции. + Для других объектов (действия, автоматизации, процессы, вебхуки, виджеты, дашборды, внешние сервисы и т. д.): - `read:[object-type]` — просмотр объекта. - `update:[object-type]` — редактирование объекта. diff --git a/content/documentation/release-notes/v1.6.0.ru.md b/content/documentation/release-notes/v1.6.0.ru.md index 25bb988..b27c1c7 100644 --- a/content/documentation/release-notes/v1.6.0.ru.md +++ b/content/documentation/release-notes/v1.6.0.ru.md @@ -1,11 +1,11 @@ --- title: v1.6.0 weight: 910 -description: Заметки о выпуске v1.6.0 — хранилище процесса, таймер, выгрузка аудит-логов в CSV, формат map в GenericAPI, функция toSlug, улучшения интерфейса и исправления. +description: Заметки о выпуске v1.6.0 — управление MCP, выгрузка аудит-логов в CSV, формат map в GenericAPI, функция toSlug, улучшения интерфейса и исправления. --- {{< alert level="info" >}} -Выпуск релиза планируется 22.06.2026 +Релиз выпущен 13.07.2026 {{< /alert >}} ## Несовместимые изменения @@ -67,6 +67,10 @@ description: Заметки о выпуске v1.6.0 — хранилище пр Добавлен механизм автоматического [создания сущностей](../../admin/actions/overview/#создание-сущностей) после успешного выполнения действия. +### MCP + +Добавлен раздел **AI** → **MCP** для подключения upstream MCP-серверов, пользовательских MCP-инструментов и MCP-коллекций. Подробнее — в разделе [«Управление MCP»](../../user/mcp-management/). + ## Улучшения интерфейса - Добавлена возможность создания новых действий, либо редактирования существующих, из окна конфигурации элемента процесса. diff --git a/content/documentation/user/ai-assistant.ru.md b/content/documentation/user/ai-assistant.ru.md index 16d5108..730553c 100644 --- a/content/documentation/user/ai-assistant.ru.md +++ b/content/documentation/user/ai-assistant.ru.md @@ -187,4 +187,9 @@ OpenAI-совместимый чат: ### Инструменты MCP -Список инструментов, параметры и примеры описаны в [документации MCP-сервера](../user/mcp-server/). В одном запросе модель может вызвать несколько инструментов. В панели чата можно раскрыть «Доступные инструменты», посмотреть аргументы и скопировать пример в поле ввода кликом. +AI-ассистент использует встроенные инструменты платформы и инструменты из [MCP-коллекций](../mcp-management/#mcp-коллекции), к которым у пользователя есть доступ. + +В панели чата раскройте **Доступные инструменты**, чтобы посмотреть название, тип (**internal**, **external**, **custom**), аргументы и пример. Клик по примеру вставляет текст в поле ввода. В одном запросе модель может вызвать несколько инструментов. + +- Встроенные инструменты (**internal**) и их параметры описаны в [документации MCP-сервера](../mcp-server/). +- Подключение MCP-серверов, пользовательских MCP-инструментов и настройка коллекций — в разделе [«Управление MCP»](../mcp-management/). diff --git a/content/documentation/user/interface.md b/content/documentation/user/interface.md index 5d9f4be..0493ac6 100644 --- a/content/documentation/user/interface.md +++ b/content/documentation/user/interface.md @@ -8,6 +8,7 @@ The Deckhouse Development Platform interface consists of the following sections: - "Home": the platform’s landing page. You can place one or more dashboards with widgets here. - "Catalog": a service catalog for viewing resources, entities, and relationships, and for running actions and scenarios. - "Self-Service": a section for configuring data sources, actions, webhooks, automations, scenarios, dashboards, and widgets. Access to this section can be restricted by the RBAC model. +- "AI": a section for configuring MCP servers, custom tools, and tool collections. Access to this section can be restricted by the RBAC model. - "Administration": a section for managing teams, users, access policies, and credentials. Access to this section can be restricted by the RBAC model. ## Global search diff --git a/content/documentation/user/interface.ru.md b/content/documentation/user/interface.ru.md index a157e9e..8c85abf 100644 --- a/content/documentation/user/interface.ru.md +++ b/content/documentation/user/interface.ru.md @@ -8,6 +8,7 @@ weight: 20 - «Главная» — стартовая страница платформы. Здесь можно размещать один или несколько дашбордов с виджетами. - «Каталог» — сервисный каталог для просмотра ресурсов, сущностей и связей, а также для запуска действий и сценариев. - «Самообслуживание» — раздел для настройки источников данных, действий, вебхуков, автоматизаций, сценариев, дашбордов и виджетов. Доступ к разделу может быть ограничен ролевой моделью. +- «AI» — раздел для настройки MCP-серверов, пользовательских инструментов и коллекций инструментов. Подробнее — в разделе [«Управление MCP»](mcp-management/). Доступ к разделу может быть ограничен ролевой моделью. - «Администрирование» — раздел для управления командами, пользователями, политиками доступа и учётными данными. Доступ к разделу может быть ограничен ролевой моделью. ## Глобальный поиск diff --git a/content/documentation/user/mcp-management.ru.md b/content/documentation/user/mcp-management.ru.md new file mode 100644 index 0000000..c90c615 --- /dev/null +++ b/content/documentation/user/mcp-management.ru.md @@ -0,0 +1,82 @@ +--- +title: Управление MCP +description: Подключение upstream MCP-серверов, пользовательских MCP-инструментов и MCP-коллекций для AI-ассистента и внешних MCP-клиентов. +--- + +Раздел **AI** → **MCP** предназначен для настройки инструментов, которые AI-ассистент и [встроенный MCP-сервер](../mcp-server/) могут вызывать от имени пользователя. + +Доступ к разделу **AI** контролируется глобальным разрешением `view:ai-page`. Настройка MCP-серверов, инструментов и коллекций — отдельными глобальными разрешениями `read:` / `edit:` (см. [ролевую модель](../../admin/security/rbac/#глобальные-разрешения)). + +## Обзор + +| Подраздел | Назначение | +|-----------|------------| +| **MCP-серверы** | Подключение upstream MCP-серверов и синхронизация их каталога инструментов | +| **MCP-коллекции** | Группы инструментов и разграничение доступа пользователей | +| **MCP-инструменты** | Пользовательские MCP-инструменты без upstream MCP-сервера | +| **Каталог** | Просмотр всех доступных вам инструментов | + +В AI-ассистенте инструменты отображаются с типом: + +- **internal** — встроенные инструменты платформы (описаны в [документации MCP-сервера](../mcp-server/)); +- **external** — инструменты, полученные из подключённого upstream MCP-сервера; +- **custom** — пользовательские MCP-инструменты. + +Вызов **external** и **custom** инструментов доступен только если они входят во **включённую** MCP-коллекцию, к которой у пользователя есть доступ. + +## MCP-серверы + +Подключите upstream MCP-сервер, чтобы импортировать его инструменты в каталог платформы. + +1. Перейдите в **AI** → **MCP** → **MCP-серверы**. +1. Нажмите **Подключить**. +1. На вкладке **Основная информация** укажите **Название**, **Идентификатор**, **Описание**, **Владелец** и **Команда**. +1. На вкладке **Конфигурация**: + 1. Включите переключатель **Включить**. + 1. Выберите **Транспорт** (`HTTP` или `SSE`). + 1. Укажите **URL** upstream MCP-сервера. + 1. При необходимости добавьте **HTTP-заголовки** и **учётные данные** для авторизации. +1. Нажмите **Сохранить**. + +После сохранения откройте карточку сервера и нажмите **Синхронизировать**, чтобы загрузить каталог инструментов. На вкладке **Инструменты** включите нужные инструменты и при необходимости задайте **Теги**. + +## MCP-инструменты + +Создайте пользовательский MCP-инструмент, который AI-ассистент вызывает напрямую, без upstream MCP-сервера. + +1. Перейдите в **AI** → **MCP** → **MCP-инструменты**. +1. Нажмите **Добавить**. +1. На вкладке **Основная информация** укажите **Название**, **Описание**, **Владелец**, **Команду** и **Теги**. +1. На вкладке **Конфигурация**: + 1. Включите переключатель **Включить**. + 1. Задайте **Схему аргументов** (JSON Schema с корневым типом `object`). + 1. При необходимости укажите **Сопоставление query-параметров** — JSON-объект, который сопоставляет имена аргументов с именами query-параметров URL. +1. На вкладке **Авторизация** укажите **URL** executor endpoint, **HTTP-метод**, **HTTP-заголовки** и **учётные данные**. +1. Нажмите **Сохранить**. + +Для **GET** и **DELETE** аргументы передаются только как query-параметры. Для **POST**, **PUT** и **PATCH** аргументы, не сопоставленные с query-параметрами, отправляются в JSON-теле запроса. + +## MCP-коллекции + +MCP-коллекция объединяет инструменты из каталога и определяет, какие из них доступны пользователям AI-ассистента и внешним MCP-клиентам. + +1. Перейдите в **AI** → **MCP** → **MCP-коллекции**. +1. Нажмите **Создать**. +1. На вкладке **Основная информация** укажите **Название**, **Идентификатор**, **Описание**, **Владелец** и **Команду**. +1. На вкладке **Конфигурация**: + 1. Включите переключатель **Включить**. + 1. В поле **Инструменты** выберите инструменты из доступного каталога. Каждый пункт содержит идентификатор MCP-сервера в скобках. +1. Нажмите **Сохранить**. + +Чтобы пользователь мог вызывать инструменты коллекции, откройте меню карточки коллекции и выберите **Настроить доступ**. Назначьте пользователям или командам роль с разрешением `use:mcp-collections`. Список разрешений — в [ролевой модели](../../admin/security/rbac/#mcp-коллекции). + +Владелец коллекции и супер-администратор получают доступ к коллекции автоматически. + +## Каталог + +Раздел **Каталог** показывает все инструменты, доступные текущему пользователю с учётом MCP-коллекций и прав доступа. Раздел предназначен для просмотра; редактирование выполняется на страницах **MCP-серверы**, **MCP-инструменты** и **MCP-коллекции**. + +## Связь с AI-ассистентом и MCP-сервером + +- В [AI-ассистенте](../ai-assistant/#инструменты-mcp) в блоке **Доступные инструменты** отображаются встроенные инструменты и инструменты из доступных коллекций. +- [MCP-сервер](../mcp-server/) платформы возвращает и вызывает те же инструменты из коллекций, что доступны пользователю, с учётом его прав RBAC. diff --git a/content/documentation/user/mcp-server.ru.md b/content/documentation/user/mcp-server.ru.md index 0430b28..d952cd5 100644 --- a/content/documentation/user/mcp-server.ru.md +++ b/content/documentation/user/mcp-server.ru.md @@ -11,8 +11,14 @@ MCP-сервер — компонент Deckhouse Development Platform (DDP), к MCP — это открытый протокол для взаимодействия AI-моделей с внешними системами. Подробнее о протоколе можно узнать на [официальном сайте MCP](https://modelcontextprotocol.io/). +{{< alert level="info" >}} +Помимо встроенных инструментов платформы, MCP-сервер может вызывать инструменты из [MCP-коллекций](../mcp-management/#mcp-коллекции), к которым у пользователя есть доступ. Настройка MCP-серверов, пользовательских MCP-инструментов и коллекций выполняется в разделе [«Управление MCP»](../mcp-management/). +{{< /alert >}} + ## Доступные инструменты +Ниже перечислены **встроенные** инструменты платформы. Инструменты типов **external** и **custom** доступны после [синхронизации каталога](../mcp-management/#mcp-серверы) и [добавления в MCP-коллекцию](../mcp-management/#mcp-коллекции). + ### get_resources Получить список ресурсов.