@kaiva/bridge

Kaiva Bridge превращает ваш API, базу данных или документы в размещённый MCP-сервер, которым могут пользоваться Claude, ChatGPT, Cursor, VS Code и другие AI-клиенты. Сначала на этой странице рассматривается коннектор Kaiva Bridge ai.kaiv/bridge, затем — инструмент командной строки.

Kaiva Bridge как MCP-коннектор (`ai.kaiv/bridge`)

Kaiva Bridge — это также MCP-сервер, с помощью которого ваш AI-клиент может создавать и управлять размещёнными MCP-серверами прямо в чате. Он включён в официальный MCP Registry под названием ai.kaiv/bridge, а также в каталог коннекторов Claude.

Адрес: https://api.kaiv.ai/api/bridge/manage/mcp (Streamable HTTP)
Вход: OAuth 2.1 с учётной записью Kaiva Bridge (бесплатно, банковская карта не нужна). Ключ копировать не требуется.
Инструменты: list_my_servers, get_server, create_server (создаёт черновик сервера на основе URL спецификации OpenAPI) и reintrospect_server (обновляет инструменты сервера при изменении API).

Коннектор создаёт черновики и отображает список серверов. Опубликовать сервер и включить его инструменты можно в консоли — это делаете вы.

VS Code и GitHub Copilot: нажмите Add to VS Code на странице kaiv.ai/bridge или выполните в VS Code команду MCP: Add Server, указав адрес выше, а затем войдите в систему по запросу.

Claude: каталог Claude.

Claude Code: claude mcp add --transport http --scope user kaiva-bridge https://api.kaiv.ai/api/bridge/manage/mcp.

Cursor и ChatGPT: меню Add на kaiv.ai/bridge.

Затем попросите: «Покажи мои серверы Kaiva Bridge» или «Создай сервер Kaiva Bridge на основе https://petstore3.swagger.io/api/v3/openapi.json».

Инструмент командной строки

Публикуйте любой API или базу данных в виде работающего MCP-сервера прямо из терминала.

Kaiva Bridge превращает спецификацию OpenAPI, базу данных (PostgreSQL, MySQL, MariaDB или SQL Server) либо удалённый MCP-сервер в размещённый MCP-сервер, к которому могут обращаться ваши агенты. CLI работает через Management API. Все команды настройки можно безопасно выполнять повторно.

Для вашего агента для программирования

Подключите AI-агента к API, базам данных и документам с помощью Kaiva Bridge. Установите skill, чтобы агент для программирования мог самостоятельно настраивать подключения к размещённым MCP-серверам. Публичные API можно опробовать без учётной записи.

Поддерживаются Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot и другие совместимые агенты для программирования.

npx skills add ai-kaiva/bridge

Установка

Устанавливать ничего не нужно. В Node 18+ уже есть всё необходимое:

npx @kaiva/bridge help

Попробуйте без учётной записи

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

npx @kaiva/bridge try --openapi https://petstore3.swagger.io/api/v3/openapi.json

Вы получите адрес сервера, ключ для этого сервера и ссылку для его закрепления. Сервер предоставляет только операции GET из спецификации и работает 72 часа или до достижения 500 вызовов. Перейдите по ссылке для закрепления, чтобы сохранить сервер в своей рабочей области: его адрес останется прежним, а к нему будут применяться ограничения вашего плана.

После закрепления ключ перестаёт действовать, поэтому повторно подключите AI-клиент через консоль. Затем можно добавить ключ API и включить другие операции. Агенты для программирования могут выполнить эти действия самостоятельно (--json выводит один объект JSON).

В облачной среде агента (Codex cloud, Claude Code в браузере) сначала разрешите домены api.kaiv.ai и registry.npmjs.org: по умолчанию доступ к сети отключён или ограничен.

Плагин Claude Code

claude plugin marketplace add ai-kaiva/bridge
claude plugin install kaiva-bridge@kaiva

Или скопируйте только skill: npx @kaiva/bridge skill install.

Локальный Postgres без учётной записи

Если базой Postgres пользуются только AI-клиенты на вашем компьютере, установите Kaiva Postgres MCP — бесплатный MCP-сервер с открытым исходным кодом, который работает локально и доступен только для чтения. Он заменяет архивированный @modelcontextprotocol/server-postgres: достаточно изменить имя пакета, остальное остаётся без изменений.

claude mcp add postgres -- npx -y @kaiva/postgres-mcp postgresql://localhost/mydb
# or, from the same plugin marketplace as above (reads DATABASE_URL from your environment)
claude plugin install postgres-mcp@kaiva

Если та же база данных нужна в Claude.ai или ChatGPT либо всей команде, используйте приведённую ниже команду push --db, чтобы предоставить к ней доступ через Bridge.

Аутентификация

npx @kaiva/bridge login

В терминале появится код, а консоль откроется автоматически. Введите код в консоли и подтвердите вход (это должен сделать владелец или администратор рабочей области). Ключ сохраняется на этом компьютере в файле ~/.config/kaiva-bridge/credentials.json, доступном только вам. Команда whoami показывает рабочую область и используемый ключ; команда logout отзывает ключ и удаляет его.

Для CI и скриптов вместо этого используйте Management key из консоли (раздел Keys & access, тип ключа Management). Если такой ключ задан, он используется вместо сохранённого логина:

export KAIVA_BRIDGE_TOKEN=kv_mgmt_...

Команда logout отзывает только сохранённый логин. Ключ, заданный через KAIVA_BRIDGE_TOKEN, находится под вашим управлением: удалите переменную окружения, а когда ключ больше не понадобится — отзовите его в консоли. При повторном входе заменяемый логин отзывается.

Management keys не принимаются MCP-шлюзом, а ключи шлюза — Management API: эти два типа учётных данных нельзя использовать взаимозаменяемо.

Быстрый старт: от источника до работающего сервера

# An API spec (only operations that read are exposed with --read-only)
npx @kaiva/bridge push my-api --openapi https://api.example.com/openapi.json --read-only

# A database: DATABASE_URL from the environment or .env; Postgres, MySQL, MariaDB or SQL Server
npx @kaiva/bridge push shop-db --db --read-only
# → LIVE  https://api.kaiv.ai/api/bridge/mcp/shop-db-a1b2c3d4
# → check  first call: get_orders answered in 84ms (and what the AI is given)

# Documents: PDF, Word, PNG, JPEG, text or Markdown files, or a folder of them
npx @kaiva/bridge push handbook --docs ./policies
# waits until each file is read, then → LIVE  https://api.kaiv.ai/api/bridge/mcp/handbook-a1b2c3d4

npx @kaiva/bridge install my-api --client claude-code   # or --client cursor

Команда install добавляет сервер в Claude Code (в .mcp.json текущей папки или с флагом --global) либо в Cursor (в ~/.cursor/mcp.json или с флагом --project), сохраняя все остальные записи. При первом подключении клиент выполняет вход в систему с вашей учётной записью Kaiva; вместо этого можно использовать --key, чтобы записать ключ для одного сервера. Флаг --dry-run показывает предполагаемые изменения, а команда uninstall удаляет сервер.

Для любого другого MCP-клиента команда key --label --replace создаёт ключ шлюза, который нужно добавить вместе с адресом сервера. Команды можно выполнять повторно: push использует уже существующий сервер с таким именем, install не меняет существующую запись, а key --replace заменяет ключ с указанной меткой.

Поручите настройку агенту для программирования

npx @kaiva/bridge skill install        # adds the setup skill to Claude Code (~/.claude/skills)

Затем попросите: «Подключи мою базу данных к Claude Code с помощью Kaiva Bridge». Skill выполнит команды ниже, запросит подтверждение, если для подключения потребуется отключить проверку сертификатов или открыть операции записи, а затем проверит подключение первым вызовом инструмента.

Примеры

Готовые к запуску скрипты в каталоге примеров:

database-to-claude-code.sh: подключение базы данных Postgres, MySQL или MariaDB к Claude Code
openapi-to-cursor.sh: подключение спецификации OpenAPI к Cursor для текущего проекта
call-from-your-app.mjs: вызов MCP-сервера из собственного приложения Node без дополнительных зависимостей

Команды

Команда	Что делает
`push --openapi`	Создаёт сервер по спецификации OpenAPI, анализирует её, открывает доступ к инструментам и публикует сервер
`push --mcp`	Подключает существующий удалённый сервер MCP и позволяет выбрать, какие его инструменты предоставлять
`push --postgres`	Предоставляет инструменты только для чтения данных из базы Postgres
`push --mysql`	Предоставляет инструменты только для чтения данных из MySQL или MariaDB
`push --graphql`	Предоставляет инструменты для чтения данных через запросы GraphQL API. Мутации не предоставляются
`push --sqlserver`	Предоставляет инструменты только для чтения данных из SQL Server или Azure SQL (`sqlserver://…` или `Server=…;Database=…;User ID=…;Password=…`)
`push --docs`	Добавляет документы, которые ИИ может искать и читать постранично. Если загрузить другой документ с тем же именем файла, он заменит прежний. Параметр `--no-wait` возвращает управление сразу после отправки файлов
`push --db [--db-env NAME]`	Подключается к базе данных, указанной в `DATABASE_URL` или NAME. Значение берётся из переменной окружения либо из `.env.local`/`.env`. Тип базы определяется по адресу, который не отображается в командной строке
`push … --read-only`	Предоставляет только операции чтения. Запись останется отключённой, пока вы её не разрешите
`push … --no-check`	Пропускает проверку настройки, которая выполняется в конце каждой команды `push` и `try`: один реальный вызов, включённая запись, размер списка инструментов и таблицы, которые могут содержать личные данные
`push … --ca-file` / `--no-verify-tls`	Для базы данных с самоподписанным сертификатом: проверьте его с помощью CA-сертификата поставщика или подключитесь без проверки
`login [--no-browser]`	Подтверждает доступ этой машины в консоли и сохраняет для неё ключ
`whoami`	Показывает используемые рабочее пространство, учётную запись и ключ
`logout`	Отзывает ключ этой машины и удаляет его
`skill install [--project]`	Добавляет навык настройки для агентов программирования
`install --client claude-code\|cursor`	Добавляет работающий сервер в конфигурацию клиента; параметры: `--key`, `--dry-run`, `--global` (Claude Code), `--project` (Cursor)
`uninstall --client claude-code\|cursor`	Удаляет сервер и отзывает ключ, добавленный командой `install`
`doctor [--call ]`	Проверяет доступность сервера, вход в систему, публикацию, рукопожатие MCP и список инструментов. Для каждого шага указывается успешный результат, ошибка с кодом и способом её устранения либо то, что проверка не выполнялась. Параметр `--call` выполняет один вызов инструмента для чтения. В конце формируется отчёт для службы поддержки без секретных данных
`servers`	Показывает список серверов с их состоянием и источником
`publish`	Публикует черновик сервера
`key [--label L] [--replace]`	Создаёт ключ шлюза для конкретного сервера. Ключ показывается только один раз; параметр `--replace` отзывает предыдущий ключ с такой же меткой
`introspect`	Повторно считывает данные источника. Завершает работу с кодом 3, если изменение контракта было отложено
`revisions`	Показывает историю изменений контракта: когда он менялся и какой инструмент был затронут
`promote`	Публикует отложенное изменение
`reject`	Отклоняет изменение и восстанавливает текущую опубликованную версию
`auto-publish [--off]`	Публикует изменения контракта без проверки
`invoke [--args '{"k":"v"}']`	Выполняет тестовый вызов инструмента через реальный контролируемый процесс. Вызов регистрируется в журнале аудита
`logs [--limit 50]`	Показывает последние записи журнала аудита
`metrics [--range 24h]`	Показывает ключевые показатели рабочего пространства за период 1h · 24h · 7d · 30d

Параметр --json для команд push, key, install, whoami и doctor выводит в stdout один результат в формате JSON, а сообщения о ходе выполнения — в stderr. Это удобно для скриптов и агентов. Переменная KAIVA_BRIDGE_URL позволяет переопределить базовый URL API (по умолчанию — https://api.kaiv.ai/api/bridge/v1).

Попробуйте до регистрации

Вызовите работающий пример сервера в браузере — регистрация не нужна:

https://app.kaiv.ai/try