MCP-шлюз

Что умеет решение

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

Модуль работает только в связке с API-платформой. MCP-шлюз является расширением для модуля native.api версии 2.0.0 и выше; установка без этой платформы невозможна. API-платформа принимает запросы агентов, проверяет токены, группы и ограничения, тогда как шлюз отвечает за протокол MCP и каталог инструментов.

Решение подходит компаниям, которые хотят дать сотрудникам или клиентам доступ к данным и функциям сайта через ИИ, не передавая административные права. Разработчикам оно позволяет опубликовать существующие методы API для агентов без создания отдельного сервера. Интеграторы и студии могут использовать этот компонент как повторно используемый слой для клиентских проектов на базе API-платформы.

Для запуска работы установите модуль через стандартный мастер Marketplace и добавьте пользователей агентов в группу «MCP: Клиенты».

Активируйте шлюз в настройках API-платформы и выберите маршруты, которые станут инструментами.

Подключите агента к адресу шлюза, предоставив access-токен пользователя.

Для публикации собственных инструментов требуется участие разработчика: логика работы с данными и проверка прав доступа к отдельным записям реализуются в вашем проекте.

Возможности для вашей команды

Явная публикация. Инструментом становится только маршрут, отмеченный для публикации. Остальные методы API остаются недоступными для агента.

Сохранение правил доступа. Запрос агента проходит через стандартный конвейер API-платформы: проверка access-токена, учет групп пользователя, ограничения по IP-адресам, расписания, лимиты запросов, события и кеш.

Разграничение по группам. Разные пользователи видят различный набор инструментов. Недоступный инструмент нельзя вызвать даже по имени.

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

Подсказки для клиента. Инструмент можно пометить как читающий, изменяющий или обращающийся к внешним системам — клиент агента использует эту информацию, например, для запроса подтверждения.

Быстрое отключение. Отзовите токен или исключите пользователя из группы «MCP: Клиенты».

Модуль MCP-шлюз от ВЕБКО • WEBCO протестирован с популярными агентами. Подключение, получение каталога и вызов инструментов успешно проверены в Codex и Claude. В документации содержатся настройки для Claude, Claude Desktop, Claude Code, Codex, VS Code, Cursor и Gemini CLI, а также готовая инструкция для автоматического подключения агента.

Ограничения текущей версии:

Агент передаёт access-токен API-платформы в заголовке запроса.

Поддерживаются только инструменты. Функции Resources, prompts, tasks и отдельный SSE-поток не реализованы.

Шлюз не имеет собственных таблиц, журналов и административных страниц: токены, журналы и настройки хранятся исключительно в API-платформе.

Перед внедрением рекомендуется изучить документацию, которая включает:

Инструкции по установке, настройке доступа и управлению группами пользователей.

Руководство по подключению ИИ-агентов и инструкцию для агента.

Методику публикации роутов как инструментов.

Примеры инструментов и описание протокола JSON-RPC.

Для модуля «MCP-шлюз» General iT может выполнить установку, настройку и проверку работы в вашем проекте.