klanex

klanex MCP サーバー

MCP サーバーとして、エージェントのツール呼び出しを確実に実行します。

klanex は、エージェントによるツール利用の意図と実際のサードパーティ API の間に位置する非同期実行レイヤーです。実行前にスキーマで幻覚によるペイロードを検査し、リトライ／バックオフ／サーキットブレーカーでレート制限や障害に対処し、認証情報を暗号化して監査証跡を保持し、署名付き Webhook で結果を報告します。この MCP サーバーを使えば、エージェントは呼び出しを一度送信するだけで、klanex が確実に届けます。

エラーはすべて、モデル向けに記述されて返されます。それぞれのエラーには llm_hint が含まれ、エージェントが何を修正すべきか（または klanex がすでに対処中であること）を明確に伝えるため、エージェントは推測せずに自己修正できます。

接続（ホスト型、推奨）

klanex の MCP サーバーはホスト型です。クライアントが HTTP トランスポートに対応していれば、インストールは不要です。

エンドポイント	環境	キー
https://api.klanexai.com/mcp	本番環境	klx_live_…
https://api.sandbox.klanexai.com/mcp	サンドボックス（無料で試用可能）	klx_test_…

klanexai.com で API キーを取得してください。サンドボックスキーは無料です。

Claude Code

claude mcp add --transport http klanex https://api.klanexai.com/mcp \
  --header "X-API-Key: klx_live_..."

Cursor / Windsurf / VS Code（mcp.json）

{
  "mcpServers": {
    "klanex": {
      "url": "https://api.klanexai.com/mcp",
      "headers": { "X-API-Key": "klx_live_..." }
    }
  }
}

そのヘッダーしか設定できないクライアントでは、Authorization: Bearer klx_... も使用できます。

接続（stdio シム）

stdio しか使えないクライアント（例：Claude Desktop）向けに、このパッケージは stdio からホスト型エンドポイントへのプロキシとして動作します。

{
  "mcpServers": {
    "klanex": {
      "command": "npx",
      "args": ["-y", "klanex-mcp"],
      "env": { "KLANEX_API_KEY": "klx_live_..." }
    }
  }
}

シムはキーのプレフィックスで接続先を振り分けます。klx_test_… キーは自動的にサンドボックスに接続されます。接続先を変更するには KLANEX_MCP_URL を設定してください。

ツール

ツール	説明
execute	信頼性の高い非同期実行のために HTTP 呼び出しを送信します。JSON Schema による任意の検証、リトライ／バックオフ／サーキットブレーカー、冪等性キー、人による承認ゲート、認証情報の暗号化に対応します。wait_seconds を指定すると、最終結果が出るまで最大 55 秒待機します。
get_execution	実行の現在のステータス、試行回数、対象からの応答、または分類済みのエラーを取得します。
list_executions	アカウントの実行履歴を一覧表示します。ステータスや時間で絞り込み、ページ分割できます。
replay_execution	最終状態になった実行をバイト単位で完全に再実行します。LLM に再度プロンプトを送ることなく、障害から復旧できます。
get_usage	プランと当月の使用量／クォータを取得します。
list_connections	connection_id で参照する保存済み認証情報接続（トークン保管庫）を一覧表示します。これにより、シークレットがモデルコンテキストを通過することはありません。

API を直接呼び出すより優れている理由

• 幻覚によるペイロードは実行前に拒否されます — payload_schema を渡すと、不一致があった場合は修正のヒントとともに同期的に返されます。
• 一時的な障害にエージェントが対処する必要はありません — 429、タイムアウト、5xx はサーキットブレーカーの背後でバックオフを伴ってリトライされるため、エージェントは何もする必要がありません。
• ネットワークの瞬断によって返金が二重実行されることはありません — idempotency_key により、安全に再試行できます。
• 破壊的な操作は人の承認待ちにできます — requires_approval を指定すると、実行を一時停止して、承認／拒否の判断を待ちます（API、ダッシュボード、または Slack のボタンから操作できます）。
• 認証情報がモデルコンテキストに入りません — 一度接続として保存すれば、klanex が実行時に注入します。

API ドキュメント全文：api.klanexai.com/docs

ライセンス

MIT