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

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

Обзор

ПодразделНазначение
MCP-серверыПодключение upstream MCP-серверов и синхронизация их каталога инструментов
MCP-коллекцииГруппы инструментов и разграничение доступа пользователей
MCP-инструментыПользовательские MCP-инструменты без upstream MCP-сервера
КаталогПросмотр всех доступных вам инструментов

В 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 executor.
    4. При необходимости укажите Сопоставление query-параметров — JSON-объект, который сопоставляет имена аргументов с именами query-параметров URL.
  5. На вкладке Авторизация укажите URL executor endpoint, HTTP-метод, HTTP-заголовки и учётные данные. В URL можно использовать сегменты {placeholder} для path-параметров и плейсхолдеры учётных данных, например {{ .credentials.tenant_id }}.
  6. Нажмите Сохранить.

Пример. В схеме аргументов задан аргумент space_id, URL executor — 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-сервером

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