用途
klanex-mcp 是 klanex 的 MCP（Model Context Protocol）服务器，目标是为智能体的工具调用提供可靠的异步执行层。它位于智能体的工具使用意图与真实第三方 API 之间，负责保证每次调用能够“落地”。
主要能力
- Schema 校验：传入 payload_schema 后，幻觉出来的 payload 会在执行前被拒绝，不匹配时同步返回并附带修正提示。
- 故障吸收：429、超时、5xx 等瞬时失败由 klanex 通过重试、退避和熔断机制处理，智能体无需干预。
- 幂等性：通过 idempotency_key 使提交可安全重试，避免网络波动导致退款等操作被重复执行。
- 审批门槛：requires_approval 可暂停执行，等待人工通过 API、仪表盘或 Slack 按钮做出批准或拒绝决定。
- 凭据安全：凭据以连接形式保存一次，klanex 在执行时注入，不进入模型上下文。
- 可读错误：每个错误都带有 llm_hint，告诉智能体需要修复什么，或说明 klanex 已在处理，从而让智能体自我纠正。
- 审计与回报：保留审计轨迹，并通过签名 webhook 回报结果。
使用方式
托管连接（推荐）
klanex 的 MCP 服务器是托管式的，如果客户端支持 HTTP 传输则无需安装：
- 在 klanexai.com 获取 API key，沙箱 key 免费。
- 在 Cursor / Windsurf / VS Code（mcp.json）中配置连接。
- 对于只能设置 Authorization 头的客户端，可使用
Authorization: Bearer klx_...。
stdio 代理连接
对于只支持 stdio 的客户端（如 Claude Desktop），该包提供将 stdio 代理到托管端点的功能：
- 代理按 key 前缀路由，
klx_test_…的 key 自动指向沙箱。 - 可通过设置
KLANEX_MCP_URL覆盖地址。
完整 API 文档见：api.klanexai.com/docs
适用场景
- 智能体需要调用第三方 API，且调用结果必须可靠落地。
- 需要防止幻觉 payload 执行、需要处理速率限制与故障、需要幂等保障、需要人工审批高风险操作，或需要将凭据隔离在模型上下文之外的场景。
限制
资料中未提供关于定价、支持平台范围、速率上限、SLA 等具体限制信息，暂未提供。
