Управление MCP

Раздел «AI» → «MCP» предназначен для настройки инструментов, которые AI-ассистент и встроенный MCP-сервер могут вызывать от имени пользователя.

Доступ к разделу «AI» контролируется глобальным разрешением view:ai-page. Настройка MCP-серверов, инструментов и коллекций — отдельными глобальными разрешениями read: / edit: (см. ролевую модель).

Обзор

В AI-ассистенте инструменты отображаются со следующими типами:

• internal — встроенные инструменты платформы (описаны в документации MCP-сервера);
• external — инструменты, полученные из подключённого upstream MCP-сервера;
• custom — пользовательские MCP-инструменты.

Вызов инструментов типов external и custom доступен только в том случае, если они входят во включённую MCP-коллекцию, к которой у пользователя есть доступ.

MCP-серверы

Подключите upstream MCP-сервер, чтобы импортировать его инструменты в каталог платформы.

1. Перейдите в «AI» → «MCP» → «MCP-серверы».
2. Нажмите «Подключить».
3. На вкладке «Основная информация» укажите «Название», «Идентификатор», «Описание», «Владелец» и «Команда».
4. На вкладке «Конфигурация»:
   1. Включите переключатель «Включить».
   2. Выберите «Транспорт» (HTTP или SSE).
   3. Укажите «URL» upstream MCP-сервера.
   4. При необходимости добавьте «HTTP-заголовки» и «Учётные данные» для авторизации.
5. Нажмите «Сохранить».

После сохранения откройте карточку сервера и нажмите «Синхронизировать», чтобы загрузить каталог инструментов. На вкладке «Инструменты» включите нужные инструменты и при необходимости задайте «Теги».

MCP-инструменты

Создайте пользовательский MCP-инструмент, который AI-ассистент вызывает напрямую, без upstream MCP-сервера.

1. Перейдите в «AI» → «MCP» → «MCP-инструменты».
2. Нажмите «Добавить».
3. На вкладке «Основная информация» укажите «Название», «Описание», «Владелец», «Команду» и «Теги».
4. На вкладке «Конфигурация»:
   1. Включите переключатель «Включить».
   2. Задайте «Схему аргументов» (JSON Schema с корневым типом object).
   3. При необходимости укажите «Сопоставление path-параметров» — объект JSON, который сопоставляет имена аргументов с сегментами {placeholder} в URL исполнителя.
   4. При необходимости укажите «Сопоставление query-параметров» — объект JSON, который сопоставляет имена аргументов с именами query-параметров URL.
5. На вкладке «Авторизация» укажите «URL» эндпоинта исполнителя, «HTTP-метод», «HTTP-заголовки» и «Учётные данные». В URL можно использовать сегменты {placeholder} для path-параметров и плейсхолдеры учётных данных, например {{ .credentials.tenant_id }}.
6. Нажмите «Сохранить».

Пример. В схеме аргументов задан аргумент space_id, URL исполнителя — https://api.example.com/v1/spaces/{spaceId}/boards, сопоставление path-параметров — {"space_id": "spaceId"}. При вызове инструмента с space_id=42 запрос будет отправлен по адресу https://api.example.com/v1/spaces/42/boards.

Для GET и DELETE аргументы, не сопоставленные с path-параметрами, передаются только как query-параметры. Для POST, PUT и PATCH аргументы, не сопоставленные с path- или query-параметрами, передаются в теле запроса в формате JSON.

MCP-коллекции

MCP-коллекция объединяет инструменты из каталога и определяет, какие из них доступны пользователям AI-ассистента и внешним MCP-клиентам.

1. Перейдите в «AI» → «MCP» → «MCP-коллекции».
2. Нажмите «Создать».
3. На вкладке «Основная информация» укажите «Название», «Идентификатор», «Описание», «Владелец» и «Команду».
4. На вкладке «Конфигурация»:
   1. Включите переключатель «Включить».
   2. В поле «Инструменты» выберите инструменты из доступного каталога. Каждый пункт содержит идентификатор MCP-сервера в скобках.
5. Нажмите «Сохранить».

Чтобы пользователь мог вызывать инструменты коллекции, откройте меню карточки коллекции и выберите «Настроить доступ». Назначьте пользователям или командам роль с разрешением use:mcp-collections. Список разрешений приведён в ролевой модели.

Владелец коллекции и супер-администратор получают доступ к коллекции автоматически.

Каталог

Раздел «Каталог» показывает все инструменты, доступные текущему пользователю с учётом MCP-коллекций и прав доступа. Раздел предназначен только для просмотра. Редактирование выполняется на страницах «MCP-серверы», «MCP-инструменты» и «MCP-коллекции».

Связь с AI-ассистентом и MCP-сервером

Инструменты из MCP-коллекций используются следующим образом:

• В AI-ассистенте в блоке «Доступные инструменты» отображаются встроенные инструменты и инструменты из доступных коллекций.
• MCP-сервер платформы возвращает и вызывает те же инструменты из коллекций, которые доступны пользователю с учётом его прав RBAC.