add mcp gateway description

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]` — редактирование объекта.

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/).
+
 ## Улучшения интерфейса
 
 - Добавлена возможность создания новых действий, либо редактирования существующих, из окна конфигурации элемента процесса.

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/).

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

content/documentation/user/interface.ru.md

@@ -8,6 +8,7 @@ weight: 20
 - «Главная» — стартовая страница платформы. Здесь можно размещать один или несколько дашбордов с виджетами.
 - «Каталог» — сервисный каталог для просмотра ресурсов, сущностей и связей, а также для запуска действий и сценариев.
 - «Самообслуживание» — раздел для настройки источников данных, действий, вебхуков, автоматизаций, сценариев, дашбордов и виджетов. Доступ к разделу может быть ограничен ролевой моделью.
+- «AI» — раздел для настройки MCP-серверов, пользовательских инструментов и коллекций инструментов. Подробнее — в разделе [«Управление MCP»](mcp-management/). Доступ к разделу может быть ограничен ролевой моделью.
 - «Администрирование» — раздел для управления командами, пользователями, политиками доступа и учётными данными. Доступ к разделу может быть ограничен ролевой моделью.
 
 ## Глобальный поиск

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.

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
 
 Получить список ресурсов.