CAPI Gateway — MCP-сервер для Claude Code: REST в MCP
Превращает существующий REST API в MCP-инструмент без правок на бэкенде. Сервис регистрируется в Consul, и агент сразу видит его инструменты.
claude mcp add capi-gateway -- docker run -i --rm docker.io/surisoft/capi-core:1.417.5Что делает CAPI Gateway
CAPI Gateway — это API-шлюз на асинхронном прокси Undertow, который умеет выставлять сервисы наружу как MCP-инструменты для LLM-агентов. Бэкенды остаются обычными REST-сервисами: CAPI сам читает метаданные из Consul, собирает каталог инструментов и переводит вызовы tools/call в HTTP-запросы к вашему API. Ответ оборачивается обратно в формат MCP.
Кроме REST-бэкендов поддерживаются и настоящие MCP-серверы: их регистрируют с mcp-type: server, и CAPI сам забирает их инструменты через tools/list. Оба типа попадают в один общий MCP-эндпоинт. Сам MCP-шлюз помечен как экспериментальный, как и gRPC-шлюз.
Запуск идёт из JAR, Docker или Helm-чарта, и обязательна переменная окружения CAPI_CONFIG_FILE с путём к конфигу — без неё сервер не стартует. MCP-порт по умолчанию 8383 (capi.mcp.port). Для установки в агент нужен Docker: команда поднимает образ docker.io/surisoft/capi-core:1.417.5 в интерактивном режиме.
Какие задачи решает
- открыть существующий REST API агенту без переписывания бэкенда
- собрать каталог инструментов из сервисов, зарегистрированных в Consul
- проксировать вызовы MCP-серверов через один общий эндпоинт
- проверить маршруты и метрики шлюза через Admin API
- добавить валидацию OAuth2/OIDC-токенов перед вызовом бэкенда
Примеры запросов агенту
- Покажи список инструментов, которые отдаёт CAPI Gateway
- Вызови инструмент из CAPI и покажи ответ бэкенда
- Зарегистрируй новый сервис в Consul с MCP-метаданными
Как установить CAPI Gateway
Командой платформы
claude mcp add capi-gateway -- docker run -i --rm docker.io/surisoft/capi-core:1.417.5Командой платформы
codex mcp add capi-gateway -- docker run -i --rm docker.io/surisoft/capi-core:1.417.5Файл настроек
{
"mcpServers": {
"capi-gateway": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/surisoft/capi-core:1.417.5"
]
}
}
}Файл настроек
{
"servers": {
"capi-gateway": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/surisoft/capi-core:1.417.5"
]
}
}
}Командой платформы
gemini mcp add capi-gateway docker run -i --rm docker.io/surisoft/capi-core:1.417.5По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о CAPI Gateway
Как установить CAPI Gateway в Claude Code?
Одной командой: claude mcp add capi-gateway -- docker run -i --rm docker.io/surisoft/capi-core:1.417.5. Docker должен быть доступен в системе.
Что делает CAPI Gateway?
Это API-шлюз, который выставляет REST-сервисы и MCP-серверы как MCP-инструменты для LLM-агентов. Перевод между REST и JSON-RPC 2.0 берёт на себя шлюз, бэкенды менять не нужно.
Что нужно для работы шлюза?
Переменная окружения CAPI_CONFIG_FILE с путём к файлу конфигурации. Без неё CAPI не запустится.
