Документация1С-Битрикс: Модулиnative.mcpНачало работы

Установка

Текст

11. API-платформа 2.0.0+ установлена и запущена?
2   ├─ Нет → установить и запустить
3   └─ Да ↓
4
52. Установить native.mcp
6   ├─ Проверки не пройдены → установка остановлена
7   └─ Проверки пройдены ↓
8
93. Добавить пользователей в группы
10   ├─ «MCP: Клиенты» → от чьего имени работают агенты (обязательно)
11   └─ «MCP: Заказы»  → только для демо-инструмента заказов
12
134. Отметить флажок MCP-шлюза: API-платформа → Настройки модуля → Роуты
14
155. Проверить GET /up/mcp (нужны сервисные роуты)
16   ├─ 200 → шлюз активен ↓
17   └─ 503 MODULE_INACTIVE → шлюз выключен, вернуться к шагу 4
18
196. Логировать входящие запросы? (необязательно)
20   ├─ Да → API-платформа → Настройки модуля:
21   │       «Аналитика» → «Собирать входящие запросы»
22   │       «Логирование» → группа «Входящие запросы»
23   └─ Нет → пропустить
24
25Дальше → опубликовать инструменты, подключить агента

API-платформа

Установите и запустите API-платформу версии 2.0.0 или новее. MCP-шлюз работает только вместе с ней: без установленной и доступной API-платформы установка будет остановлена.

Установите модуль

Загрузите модуль native.mcp на сайт.
Откройте «Marketplace → Установленные решения».
Найдите «MCP-шлюз» и выберите «Установить».

Перед регистрацией модуля установщик проверяет окружение:

Проверка	Сообщение при ошибке
API-платформа зарегистрирована, действующая или в демо-периоде	Модуль «API-платформа» не установлен
Версия API-платформы не ниже 2.0.0 и есть нужные возможности	Модуль «API-платформа» не поддерживает необходимые возможности MCP-шлюза
Версия PHP не ниже минимальной для API-платформы	Версия PHP должна быть не ниже …

Истёкший демонстрационный период API-платформы тоже останавливает установку.

Группы пользователей

При установке создаются две группы:

Группа	Код	Назначение
«MCP: Клиенты»	NATIVE_MCP_CLIENT	Вход в шлюз: без неё запросы к `/mcp` не проходят
«MCP: Заказы»	NATIVE_MCP_ORDER	Доступ к демонстрационному инструменту заказов

Если группа с таким кодом уже есть, она и её участники сохраняются.

Добавьте в «MCP: Клиенты» пользователей, от имени которых будут работать агенты, а в «MCP: Заказы» — тех, кому нужен демонстрационный инструмент заказов из статьи «Список заказов». Подробнее — в разделе «Доступ и группы».

Активация шлюза

Установка не включает шлюз автоматически.

Откройте «Сервисы → API-платформа → Настройки модуля», вкладка «Роуты».
Отметьте флажок активации MCP-шлюза и сохраните настройки.

Проверка шлюза

Для проверки состояния включите сервисные роуты и вызовите GET /up/mcp. Активный шлюз отвечает 200, выключенный — MODULE_INACTIVE / 503.

Логирование запросов

Необязательный шаг. Собственного журнала у MCP-шлюза нет: обращения к /mcp записывает API-платформа, как и остальные входящие запросы.

Откройте «Сервисы → API-платформа → Настройки модуля».
На вкладке «Аналитика» включите «Собирать входящие запросы».
На вкладке «Логирование» в группе «Входящие запросы» отметьте «Записывать входящие данные» и «Записывать исходящие данные» и выберите место хранения: база, файл или оба.
Сохраните настройки.

Записи появятся в разделе «Входящие запросы».

Дальше опубликуйте инструменты, получите токен и подключите ИИ-агента к шлюзу.