cortex-gateway MCP-сервер для Claude Code: установка
Объединяет HTTP-бэкенды в один MCP-шлюз с OAuth 2.1 и пользовательскими правами. Нужен для общего набора инструментов без отдельных коннекторов.
claude mcp add --transport http cortex-gateway https://mcp.cortex-gateway.dev/mcpЧто делает cortex-gateway
cortex-gateway — self-hosted MCP-шлюз перед несколькими HTTP-бэкендами. Он обнаруживает их инструменты, собирает единый каталог, принимает вызовы tools/call и отправляет их владельцу нужного инструмента. Доступ контролируется через OAuth 2.1, области прав и JWT, а действия попадают в псевдонимизированный аудит.
Бэкендам достаточно реализовать HTTP-контракт с одним endpoint POST /api/cortex/backend; библиотека MCP и stdio не нужны для этого контракта. Шлюз передаёт исходную личность пользователя, поэтому каждый бэкенд сам проверяет его права. Для нативных MCP-серверов есть встроенный MCP→backend адаптер, но он имеет статус beta.
Недоступный бэкенд исчезает из tools/list, а остальные продолжают работать. Установка подключает удалённый endpoint https://mcp.cortex-gateway.dev/mcp; для собственного развёртывания потребуется настроить OAuth и HTTP-бэкенды.
Какие задачи решает
- объединить несколько HTTP-бэкендов в один MCP-каталог
- передать права пользователя в каждый бэкенд
- защитить инструменты через OAuth 2.1 и scopes
- вести общий псевдонимизированный аудит вызовов
- подключить нативный MCP-сервер через адаптер
Примеры запросов агенту
- Покажи инструменты, доступные через cortex-gateway.
- Найди подходящий инструмент в общем каталоге и вызови его с моими правами.
- Сообщи о недостающей возможности через
report_missing_capability.
Как установить cortex-gateway
Командой платформы: удалённый сервер
claude mcp add --transport http cortex-gateway https://mcp.cortex-gateway.dev/mcpКомандой платформы: удалённый сервер
codex mcp add cortex-gateway --url https://mcp.cortex-gateway.dev/mcpФайл настроек
{
"mcpServers": {
"cortex-gateway": {
"url": "https://mcp.cortex-gateway.dev/mcp"
}
}
}Файл настроек
{
"servers": {
"cortex-gateway": {
"type": "http",
"url": "https://mcp.cortex-gateway.dev/mcp"
}
}
}Командой платформы: удалённый сервер
gemini mcp add -t http cortex-gateway https://mcp.cortex-gateway.dev/mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о cortex-gateway
Как установить cortex-gateway в Claude Code?
Выполните claude mcp add --transport http cortex-gateway https://mcp.cortex-gateway.dev/mcp.
Что делает cortex-gateway?
Шлюз объединяет инструменты HTTP-бэкендов в один MCP-сервер, защищает доступ OAuth 2.1 и передаёт вызовы нужному бэкенду с правами пользователя.
Что нужно для работы cortex-gateway?
Бэкенды должны предоставить endpoint POST /api/cortex/backend. Для доступа с пользовательскими правами нужны OAuth 2.1, JWT и scopes.
