Подключайте Claude, Codex, Cursor и других ИИ-агентов к сайту по протоколу MCP (Model Context Protocol). Агент получает в качестве инструментов только те методы API, которые вы явно разрешили.
Шлюз не открывает агенту базу сайта. Что агент может прочитать или изменить, определяют ваши роуты и их контроллеры.
Работает вместе с API-платформойMCP-шлюз — расширение модуля «API-платформа» (native.api) версии 2.0.0 и новее. Без него шлюз не устанавливается.
API-платформа принимает запрос агента, проверяет токен, группы, ограничения и параметры. Шлюз отвечает за протокол MCP и каталог инструментов.
Для кого
- Компаниям — чтобы дать ИИ-агентам сотрудников или клиентов доступ к данным и функциям сайта без передачи прав администратора.
- Командам разработки — чтобы опубликовать для агентов уже существующие методы API без отдельного MCP-сервера.
- Интеграторам и студиям — как повторно используемый слой для клиентских проектов на API-платформе.
- Установите модуль штатным мастером Marketplace и добавьте пользователей агентов в группу «MCP: Клиенты».
- Включите шлюз в настройках API-платформы и отметьте роуты, которые станут инструментами.
- Подключите агента по адресу шлюза с access-токеном пользователя.
| Для публикации собственных инструментов нужен разработчик: методы работы с данными и проверки прав на отдельные записи реализуются в вашем проекте. |
- Явная публикация. Инструментом становится только роут, отмеченный для публикации. Остальные методы API агенту недоступны.
- Прежние правила доступа. Запрос агента проходит общий конвейер API-платформы: access-токен, группы пользователя, ограничения по IP-адресам, расписания, лимиты запросов, события и кеш.
- Разграничение по группам. Разные пользователи видят разный набор инструментов. Недоступный инструмент нельзя вызвать даже по имени.
- Схемы аргументов без ручной работы. Агент получает описание и схему каждого инструмента из параметров роута, а шлюз проверяет аргументы до вызова.
- Подсказки клиенту. Инструмент можно пометить как читающий, изменяющий или обращающийся к внешним системам — клиент агента использует это, например, чтобы запросить подтверждение.
- Отключение в одно действие. Отзовите токен или исключите пользователя из группы «MCP: Клиенты».
Подключение, получение каталога и вызов инструментов проверены в Codex и Claude. В документации приведены настройки Claude, Claude Desktop, Claude Code, Codex, VS Code, Cursor и Gemini CLI, а также готовая инструкция, по которой агент подключается сам.
Ограничения версии- Агент передаёт access-токен API-платформы в заголовке.
- Поддерживаются инструменты. Resources, prompts, tasks и отдельный SSE-поток не реализованы.
- Собственных таблиц, журналов и административных страниц у шлюза нет: токены, журналы и настройки остаются в API-платформе.
В документации собраны:
- Установка, доступ и группы пользователей.
- Подключение ИИ-агентов и инструкция для агента.
- Публикация роутов как инструментов.
- Примеры инструментов и описание протокола JSON-RPC.