MCP-шлюз, ver. 1.0.0

Подключайте Claude, Codex, Cursor и других ИИ-агентов к сайту по протоколу MCP (Model Context Protocol). Агент получает в качестве инструментов только те методы API, которые вы явно разрешили.

Шлюз не открывает агенту базу сайта. Что агент может прочитать или изменить, определяют ваши роуты и их контроллеры.

MCP-шлюз — расширение модуля «API-платформа» (native.api) версии 2.0.0 и новее. Без него шлюз не устанавливается.

API-платформа принимает запрос агента, проверяет токен, группы, ограничения и параметры. Шлюз отвечает за протокол MCP и каталог инструментов.

Для кого

• Компаниям — чтобы дать ИИ-агентам сотрудников или клиентов доступ к данным и функциям сайта без передачи прав администратора.
  
• Командам разработки — чтобы опубликовать для агентов уже существующие методы API без отдельного MCP-сервера.
  
• Интеграторам и студиям — как повторно используемый слой для клиентских проектов на API-платформе.
  

1. Установите модуль штатным мастером Marketplace и добавьте пользователей агентов в группу «MCP: Клиенты».
   
2. Включите шлюз в настройках API-платформы и отметьте роуты, которые станут инструментами.
   
3. Подключите агента по адресу шлюза с 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-платформе.