Kaiva Bridge

Kaiva Bridge

Kaiva Bridge を使うと、API、データベース、ドキュメントを、Claude、ChatGPT、Cursor、VS Code、その他の AI クライアントが利用できる、管理対象の MCP サーバーに変換できます。このページでは、まず Kaiva Bridge コネクター ai.kaiv/bridge について説明し、その後にコマンドラインツールを紹介します。

MCP コネクターとしての Kaiva Bridge（ai.kaiv/bridge）

Kaiva Bridge 自体も MCP サーバーなので、AI クライアントからチャット内で MCP サーバーを作成、管理できます。公式の MCP Registry と Claude のコネクターディレクトリに ai.kaiv/bridge として登録されています。

• アドレス：https://api.kaiv.ai/api/bridge/manage/mcp（Streamable HTTP）
• サインイン：Kaiva Bridge アカウントで OAuth 2.1 を使用します（無料、カード不要）。コピーするキーはありません。
• ツール：list_my_servers、get_server、create_server（OpenAPI 仕様の URL からサーバーのドラフトを作成）、reintrospect_server（API の変更時にサーバーのツールを更新）

コネクターでできるのは、ドラフトの作成と一覧表示です。サーバーの公開とツールの有効化は、コンソールでユーザー自身が行います。

VS Code と GitHub Copilot： kaiv.ai/bridge の「Add to VS Code」をクリックするか、VS Code で MCP: Add Server を実行して上記のアドレスを入力し、求められたらサインインします。 Claude： claude.ai/directory/kaiva-bridge。 Claude Code： claude mcp add --transport http --scope user kaiva-bridge https://api.kaiv.ai/api/bridge/manage/mcp。 Cursor と ChatGPT： kaiv.ai/bridge の「Add」メニュー。

次のように依頼します。「Kaiva Bridge のサーバーを一覧表示して」または「https://petstore3.swagger.io/api/v3/openapi.json から Kaiva Bridge サーバーを作成して」。

コマンドラインツール

ターミナルから、あらゆる API やデータベースを稼働中の MCP サーバーとして公開できます。

Kaiva Bridge を使うと、OpenAPI 仕様、データベース（PostgreSQL、MySQL、MariaDB、SQL Server）、またはリモート MCP サーバーを、エージェントが呼び出せる管理対象の MCP サーバーに変換できます。この CLI は Management API 経由で操作します。セットアップコマンドは何度実行しても安全です。

コーディングエージェント向け

Kaiva Bridge を使って、AI エージェントを API、データベース、ドキュメントに接続します。スキルをインストールすると、コーディングエージェントが管理対象の MCP 接続をセットアップできるようになります。アカウントなしで公開 API をお試しください。

Claude Code、Codex、Cursor、Gemini CLI、GitHub Copilot、その他の互換性のあるコーディングエージェントで動作します。

npx skills add ai-kaiva/bridge

インストール

インストールは不要です。Node 18+ があればすべてそろっています。

npx @kaiva/bridge help

アカウントなしで試す

公開 API 仕様なら、コマンドを 1 つ実行するだけで、動作する MCP サーバーを利用できます。アカウントもログインも不要です。

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

サーバーのアドレス、そのサーバー専用のキー、クレームリンクが発行されます。サーバーが提供するのは仕様にある GET 操作のみで、有効期間は 72 時間または 500 回の呼び出しです。クレームリンクを開くと、サーバーをワークスペースに保存できます。アドレスは変わらず、プランの上限が適用されます。クレームするとキーは無効になるため、コンソールから AI クライアントを再接続してください。その後、API キーを追加して、他の操作を有効にできます。コーディングエージェントはこれらの操作を自分で実行できます（--json を指定すると、JSON オブジェクトを 1 つ出力します）。

クラウドエージェントのサンドボックス（Codex cloud、Claude Code on the web）では、最初に api.kaiv.ai と registry.npmjs.org のドメインを許可してください。デフォルトでは、これらへのネットワークアクセスが無効、または制限されています。

Claude Code プラグイン

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

または、スキルだけをコピーします：npx @kaiva/bridge skill install。

アカウント不要で利用できる、マシン上の Postgres

マシン上の AI クライアントだけが使用する Postgres データベースには、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 キーは MCP ゲートウェイでは拒否され、ゲートウェイキーは Management API では拒否されます。この2種類の認証情報は相互に使用できません。

クイックスタート：ソースから稼働中のサーバーへ

# 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 <server-id> --label <client> --replace を実行すると、エンドポイントとともに貼り付けるゲートウェイキーが作成されます。同じコマンドを再実行しても重複しません。push は同じ名前のサーバーを再利用し、install は既存のエントリをそのまま維持し、key --replace はそのラベルのキーを置き換えます。

コーディングエージェントに任せる

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

次のように依頼します：「Kaiva Bridge を使ってデータベースを Claude Code に接続して」。スキルは以下のコマンドを実行し、証明書チェックを行わずに接続する場合や、書き込みを行う操作を公開する場合には事前に確認を求め、最初のツール呼び出しで接続を確認します。

例

実行可能なスクリプトは examples/ にあります。

• database-to-claude-code.sh：Postgres、MySQL、MariaDB のデータベースを Claude Code に接続します
• openapi-to-cursor.sh：このプロジェクトの OpenAPI 仕様を Cursor に接続します
• call-from-your-app.mjs：依存関係なしで、独自の Node アプリから MCP サーバーを呼び出します

コマンド

コマンド	説明
push <name> --openapi <url>	OpenAPI 仕様から作成し、イントロスペクションを行って公開し、パブリッシュします
push <name> --mcp <url>	既存のリモート MCP サーバーをラップし、提供するツールを選択します
push <name> --postgres <conn>	Postgres データベースから読み取り専用ツールを作成します
push <name> --mysql <conn>	MySQL または MariaDB データベースから読み取り専用ツールを作成します
push <name> --graphql <endpoint>	GraphQL API のクエリから読み取りツールを作成します（ミューテーションは提供されません）
push <name> --sqlserver <conn>	SQL Server または Azure SQL データベースから読み取り専用ツールを作成します（sqlserver://… または Server=…;Database=…;User ID=…;Password=…）
push <name> --docs <files or folders>	AI がページ単位で検索・読み取りできるドキュメントを作成します。同じファイル名を再度指定すると、そのドキュメントが置き換えられます。--no-wait を指定すると、ファイルの送信後に戻ります
push <name> --db [--db-env NAME]	環境変数または .env.local／.env にある DATABASE_URL（または NAME）のデータベースを使用します。エンジンはアドレスから判別され、そのアドレスがコマンドラインに表示されることはありません
push … --read-only	読み取り操作のみを公開します。書き込みは、選択するまで無効のままです
push … --no-check	各 push と try の最後に実行されるセットアップチェック（実際の呼び出しを1回行う、書き込みを有効にする、ツールリストのサイズと非公開に見えるテーブルを確認する）を省略します
push … --ca-file <pem> / --no-verify-tls	自己署名証明書を使用するデータベースの場合、プロバイダーの CA と照合するか、検証せずに接続します
login [--no-browser]	コンソールでこのマシンを承認し、このマシン用のキーを保存します
whoami	使用中のワークスペース、アカウント、キーを表示します
logout	このマシンのキーを失効させ、削除します
skill install [--project]	コーディングエージェント用のセットアップスキルを追加します
install <server> --client claude-code|cursor	稼働中のサーバーをクライアントの設定に追加します。--key、--dry-run、--global（Claude Code）、--project（Cursor）を指定できます
uninstall <server> --client claude-code|cursor	サーバーを削除し、install で追加したキーを失効させます
doctor <server> [--call <tool>]	到達性、サインイン、公開状態、MCP ハンドシェイク、ツールリストを確認します。各ステップは成功するか、エラーコードと修正方法を示して失敗するか、未実行であることを示します。--call は読み取りを行うツールで1回呼び出します。サポート用の診断結果（シークレットを含まない）を最後に出力します
servers	状態とソースを含むサーバー一覧を表示します
publish <server-id>	下書きサーバーをパブリッシュします
key <server-id> [--label L] [--replace]	サーバー専用のゲートウェイキーを発行します（表示は1回のみ）。--replace を指定すると、同じラベルの以前のキーを失効させます
introspect <server-id>	ソースを再読み込みします。コントラクトの変更が保留された場合は、終了コード3で終了します
revisions <server-id>	コントラクトの履歴を表示します。変更時期と変更されたツールを確認できます
promote <server-id>	保留中の変更をパブリッシュします
reject <server-id>	保留中の変更を破棄し、現在提供中の状態に戻します
auto-publish <server-id> [--off]	コントラクトの変更をレビューなしでパブリッシュします
invoke <server-id> <tool-id> [--args '{"k":"v"}']	実際のガバナンス対象パスを通してツールをテスト呼び出しします（監査対象）
logs [--limit 50]	監査ログの末尾を表示します
metrics [--range 24h]	ワークスペースの KPI（1h · 24h · 7d · 30d）

push、key、install、whoami、doctor で --json を指定すると、スクリプトやエージェント向けに、stdout に1つの JSON 結果を出力します（進捗状況は stderr に出力されます）。KAIVA_BRIDGE_URL で API のベース URL を上書きできます（デフォルトは https://api.kaiv.ai/api/bridge/v1）。

サインアップ前にお試しください

アカウントなしで、ブラウザーから稼働中のサンプルサーバーを呼び出せます： https://app.kaiv.ai/try

---

MIT © SLATEAI LIMITED · kaiv.ai/bridge