klanex

klanex MCP 服务

作为 MCP 服务，为 Agent 工具调用提供可靠执行能力。

klanex 是一个异步执行层，位于 Agent 的工具使用意图与实际的第三方 API 之间：它会在执行前通过架构校验拦截幻觉生成的负载，通过重试、退避和熔断器应对速率限制与服务中断，加密凭据，保留审计记录，并通过签名 Webhook 返回结果。借助此 MCP 服务，Agent 只需提交一次调用，klanex 就会确保调用成功送达。

失败信息会以适合模型阅读的方式返回：每个错误都附带一个 llm_hint，明确告知 Agent 需要修正什么（或 klanex 正在处理什么），让 Agent 自行纠正，而不是猜测。

连接（托管服务，推荐）

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 会阻塞最多 55s，等待最终结果。
get_execution	获取某次执行的当前状态、尝试次数、目标响应或分类错误。
list_executions	获取账户的执行记录，可按状态/时间筛选，并支持分页。
replay_execution	对已结束的执行进行字节级精确重跑——无需再次提示 LLM 即可从服务中断中恢复。
get_usage	获取套餐以及当月用量/配额。
list_connections	获取已存储的凭据连接（令牌库），以便通过 connection_id 引用——这样密钥就不会经过模型上下文。

为什么它比直接调用 API 更好

• 幻觉生成的负载会在执行前被拒绝——传入 payload_schema，不匹配时会同步返回并附带修正提示。
• 临时故障不需要 Agent 处理——429、超时和 5xx 响应会在熔断器保护下通过退避机制重试；Agent 无需采取任何操作。
• 网络瞬断绝不会导致退款重复执行——idempotency_key 使提交操作可以安全重试。
• 破坏性操作可以等待人工审批——requires_approval 会暂停执行，等待批准/拒绝决定（通过 API、控制面板或 Slack 按钮）。
• 凭据不会进入模型上下文——将凭据存储为连接即可；klanex 会在执行时注入凭据。

完整 API 文档：api.klanexai.com/docs

许可证

MIT