English Français العربية

klanex

السجل الرسمي الأمن

Reliable async execution for agent tool calls: schema gating, retries, idempotency, audit trail.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http klanex 'https://api.klanexai.com/mcp' --header 'X-API-Key: <klanex API key (klx_live_... for production; free klx_test_... sandbox keys work at https://api.sandbox.klanexai.com/mcp)>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "klanex": {
            "type": "http",
            "url": "https://api.klanexai.com/mcp",
            "headers": {
                "X-API-Key": "<klanex API key (klx_live_... for production; free klx_test_... sandbox keys work at https://api.sandbox.klanexai.com/mcp)>"
            }
        }
    }
}
NPM package klanex-mcp
Claude Code 
claude mcp add klanex -e 'KLANEX_API_KEY=<your klanex_api_key>' -- npx -y klanex-mcp@0.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "klanex": {
            "command": "npx",
            "args": [
                "-y",
                "klanex-mcp@0.1.0"
            ],
            "env": {
                "KLANEX_API_KEY": "<your klanex_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • KLANEX_API_KEY إلزامي سري klanex API key; klx_test_... keys route to the sandbox automatically

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. klanex MCP server
  2. Connect (hosted, recommended)
  3. Connect (stdio shim)
  4. Tools
  5. Why this beats calling APIs directly
  6. License

klanex MCP server

Reliable execution for agent tool calls, as an MCP server.

klanex is an async execution layer between an agent's tool-use intents and real third-party APIs: it schema-gates hallucinated payloads before anything runs, absorbs rate limits and outages with retries/backoff/circuit breakers, encrypts credentials, keeps an audit trail, and reports back via signed webhooks. With this MCP server, an agent submits a call once — klanex makes sure it lands.

Failures come back written for the model: every error carries an llm_hint telling the agent exactly what to fix (or that klanex is already handling it), so agents self-correct instead of guessing.

klanex's MCP server is hosted — no install needed if your client supports HTTP transports:

EndpointEnvironmentKeys
https://api.klanexai.com/mcpproductionklx_live_…
https://api.sandbox.klanexai.com/mcpsandbox (free to try)klx_test_…

Get an API key at klanexai.com — sandbox keys are free.

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_... works too, for clients that can only set that header.

Connect (stdio shim)

For clients that only speak stdio (e.g. Claude Desktop), this package proxies stdio to the hosted endpoint:

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

The shim routes by key prefix — klx_test_… keys go to the sandbox automatically. Set KLANEX_MCP_URL to override.

Tools

ToolWhat it does
executeSubmit an HTTP call for reliable async execution: optional JSON Schema gate, retries/backoff/circuit breakers, idempotency keys, human approval gates, encrypted credentials. wait_seconds blocks up to 55s for the terminal result.
get_executionCurrent status, attempts, target response, or classified error for an execution.
list_executionsThe account's executions, filterable by status/time, paginated.
replay_executionRe-run a terminal execution byte-exact — outage recovery without re-prompting the LLM.
get_usagePlan and current-month usage/quota.
list_connectionsStored credential connections (token vault) to reference via connection_id — so secrets never pass through model context.

Why this beats calling APIs directly

  • Hallucinated payloads are rejected before they execute — pass payload_schema and mismatches return synchronously with a correction hint.
  • Transient failures are not the agent's problem — 429s, timeouts, and 5xxs are retried with backoff behind a circuit breaker; the agent does nothing.
  • A network blip can never double-execute a refund — idempotency_key makes submits safe to retry.
  • Destructive actions can wait for a human — requires_approval pauses execution for an approve/reject decision (API, dashboard, or Slack buttons).
  • Credentials stay out of model context — store them once as a connection; klanex injects them at execution time.

Full API docs: api.klanexai.com/docs

License

MIT

الأسئلة الشائعة

ما هو klanex؟

Reliable async execution for agent tool calls: schema gating, retries, idempotency, audit trail.

كيف أثبّت klanex؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http klanex 'https://api.klanexai.com/mcp' --header 'X-API-Key: <klanex API key (klx_live_... for production; free klx_test_... sandbox keys work at https://api.sandbox.klanexai.com/mcp)>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج klanex إلى مفتاح API؟

نعم. يتطلب KLANEX_API_KEY, X-API-Key، وتضبطها في إعداداته.

هل klanex مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون klanex؟

ينشره chrassy. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.