Kaiva Bridge — Claude Code MCP server: setup and overview
Exposes OpenAPI schemas, databases, and document folders as managed MCP endpoints for coding agents. Helps you wire external APIs into your development workflows.
claude mcp add --transport http bridge https://api.kaiv.ai/api/bridge/manage/mcpWhat Kaiva Bridge does
The connector links your workspace directly to the Kaiva Bridge management endpoint over streamable HTTP. It furnishes tools like create_server, list_my_servers, get_server, and reintrospect_server, allowing an assistant to draft servers from schema URLs and refresh them when endpoints change. Activating write tools or publishing remain locked behind manual approval in the web console.
Beyond REST endpoints, the CLI generates servers from Postgres, MySQL, MariaDB, or SQL Server instances, alongside directories of text and PDF files. Local execution expects Node 18 or newer. A quick trial mode lets you spin up a temporary read-only endpoint without an account, constrained to 500 requests or 72 hours.
Management tokens and gateway credentials remain strictly separated; neither will work in place of the other. Sandboxed environments like cloud agents will drop connections unless you allow traffic to api.kaiv.ai and registry.npmjs.org.
What it helps with
- draft managed MCP endpoints from OpenAPI specifications
- expose SQL databases to coding agents with read-only guards
- index document directories for conversational retrieval
- resynchronize tool definitions when upstream APIs update
Example prompts for the agent
- Show my registered Kaiva Bridge servers.
- Draft a new MCP server from this OpenAPI schema link.
- Link the project database to Claude Code using Kaiva Bridge.
How to install Kaiva Bridge
Platform CLI: remote server
claude mcp add --transport http bridge https://api.kaiv.ai/api/bridge/manage/mcpPlatform CLI: remote server
codex mcp add kaiva-bridge --url https://api.kaiv.ai/api/bridge/manage/mcpConfig file
{
"mcpServers": {
"kaiva-bridge": {
"url": "https://api.kaiv.ai/api/bridge/manage/mcp"
}
}
}Config file
{
"servers": {
"kaiva-bridge": {
"type": "http",
"url": "https://api.kaiv.ai/api/bridge/manage/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http kaiva-bridge https://api.kaiv.ai/api/bridge/manage/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Kaiva Bridge
How to install Kaiva Bridge in Claude Code?
Add the HTTP bridge using claude mcp add --transport http kaiva-bridge https://api.kaiv.ai/api/bridge/manage/mcp. The client will guide you through OAuth 2.1 authentication in your browser.
What does Kaiva Bridge do?
It transforms REST documentation, databases, and text files into managed MCP servers that AI assistants can query as tools.
Can I test Kaiva Bridge without creating an account?
Yes. Running npx @kaiva/bridge try --openapi <url> spins up a temporary read-only server capped at 500 requests or 72 hours.
