Описание модуля
| Название | Описание |
|---|---|
| Наименование | MCP-шлюз |
| Код модуля | native.mcp |
| Дата релиза | 27.10.2026 |
| Дата обновления | 27.10.2026 |
| Версия | 1.0.0 |
| Зависимость | API-платформа 2.0.0 и новее |
MCP-шлюз — расширение API-платформы для управляемого взаимодействия сайта с ИИ-агентами по протоколу MCP (Model Context Protocol). Он предоставляет агенту явно разрешённые роуты API в виде инструментов: агент получает их список, выбирает нужный и вызывает его.
Кому что читать
- Администратору сайта. «Установка» и «Доступ и группы»: включить шлюз и добавить пользователей в нужные группы. Дальше — «Ручное подключение» или «Инструкция для агента», чтобы агент подключился сам.
- Разработчику сайта. «Инструменты»: как объявить роут инструментом, какие ключи есть у секции
mcpи как ограничить инструмент группами. Готовые разборы — в примерах инструментов, детали обмена с агентом — в «Протоколе JSON-RPC».
Как это работает
- Разработчик сайта описывает роуты в карте роутов API-платформы и добавляет нужным роутам секцию
mcp. - Агент обращается к роуту
POST /mcpотносительно пути API, например/api/mcp, с access-токеном API-платформы. Настройки популярных агентов приведены в разделе «ИИ-агенты» → «Ручное подключение». - По запросу
tools/listшлюз возвращает роуты с секциейmcp, доступные группам пользователя токена. - По запросу
tools/callшлюз проверяет аргументы и выполняет выбранный роут общим конвейером API-платформы: с проверками доступа, лимитами, событиями и кешем. - Результат контроллера возвращается агенту в ответе JSON-RPC.
Шлюз не содержит бизнес-логики. Что агент может прочитать или изменить на сайте, определяют роуты и их контроллеры.
Ответственность
| API-платформа | MCP-шлюз |
|---|---|
Путь, описание и проверка доступа роута /mcp | Протокол JSON-RPC, версии и заголовки MCP |
| Токены, клиенты, группы, лимиты, CORS и журналирование | Каталог инструментов и проверка аргументов |
| Флаг активации шлюза на вкладке «Роуты» | Встроенные инструменты сведений о сайте и платформе |
Карты роутов и константы секции публикации ToolConfig | Группы «MCP: Клиенты» и «MCP: Заказы», которые создаёт и удаляет установщик |
Собственных таблиц, токенов, журналов и административных страниц у MCP-шлюза нет.
Требования
- API-платформа 2.0.0 и новее: действующий модуль или активный демонстрационный период.
- Версия PHP — не ниже минимальной для установленной API-платформы, см. системные требования.
- «1С-Битрикс: Управление сайтом» или Битрикс24 (коробочная версия).
Ограничения версии
- Вход через OAuth не поддерживается: агент передаёт access-токен API-платформы в заголовке.
- Поддерживаются инструменты. Resources, prompts, tasks и отдельный SSE-поток не реализованы.
- Подключение, получение каталога и вызов инструментов проверены в Codex и Claude.