English Français العربية

Shardflux

السجل الرسمي أدوات المطورين

Persistent cloud workspaces for AI agents: run commands, edit files, use git and a browser.

الموقع

التثبيت

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

Remote (streamable-http)
Claude Code 
claude mcp add --transport http shardflux 'https://mcp.shardflux.dev/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "shardflux": {
            "type": "http",
            "url": "https://mcp.shardflux.dev/mcp"
        }
    }
}
NPM package @shardflux/mcp
Claude Code 
claude mcp add shardflux -e 'SHARDFLUX_API_KEY=<your shardflux_api_key>' -e 'SHARDFLUX_API_URL=https://api.shardflux.dev' -e 'SHARDFLUX_WORKSPACE_KEY=<SHARDFLUX_WORKSPACE_KEY>' -e 'SHARDFLUX_TEMPLATE=<SHARDFLUX_TEMPLATE>' -e 'SHARDFLUX_MCP_TOOL_TIMEOUT_MS=120000' -e 'SHARDFLUX_WAKE=on' -e 'SHARDFLUX_WAKE_TIMEOUT_MS=120000' -e 'SHARDFLUX_AGENT_LABEL=mcp' -e 'SHARDFLUX_MCP_LOG_LEVEL=info' -e 'SHARDFLUX_HTTP_KEEPALIVE=<SHARDFLUX_HTTP_KEEPALIVE>' -e 'SHARDFLUX_PREWAKE=off' -- npx -y @shardflux/mcp@0.12.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "shardflux": {
            "command": "npx",
            "args": [
                "-y",
                "@shardflux/mcp@0.12.2"
            ],
            "env": {
                "SHARDFLUX_API_KEY": "<your shardflux_api_key>",
                "SHARDFLUX_API_URL": "https://api.shardflux.dev",
                "SHARDFLUX_WORKSPACE_KEY": "<SHARDFLUX_WORKSPACE_KEY>",
                "SHARDFLUX_TEMPLATE": "<SHARDFLUX_TEMPLATE>",
                "SHARDFLUX_MCP_TOOL_TIMEOUT_MS": "120000",
                "SHARDFLUX_WAKE": "on",
                "SHARDFLUX_WAKE_TIMEOUT_MS": "120000",
                "SHARDFLUX_AGENT_LABEL": "mcp",
                "SHARDFLUX_MCP_LOG_LEVEL": "info",
                "SHARDFLUX_HTTP_KEEPALIVE": "<SHARDFLUX_HTTP_KEEPALIVE>",
                "SHARDFLUX_PREWAKE": "off"
            }
        }
    }
}

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

  • SHARDFLUX_API_KEY إلزامي سري Scoped Shardflux project API key (sfk_<key id>_<secret>). Its tool permissions decide which workspace tools are listed.
  • SHARDFLUX_API_URL API base URL. Plain http:// is allowed only for loopback hosts.
  • SHARDFLUX_WORKSPACE_KEY Pin one workspace: workspace_key becomes optional on every tool and any other key is refused (workspace_pinned).
  • SHARDFLUX_TEMPLATE Default template slug for workspace_open.
  • SHARDFLUX_MCP_TOOL_TIMEOUT_MS Default and maximum deadline per tool call in milliseconds (1000-3600000). A call's timeout_ms can only shorten it.
  • SHARDFLUX_WAKE on: workspace tools resume a suspended workspace and then run. off: they return the workspace_not_running refusal.
  • SHARDFLUX_WAKE_TIMEOUT_MS Longest wait per tool call for a workspace to wake or finish a transition, in milliseconds (1000-3600000; clamped to SHARDFLUX_MCP_TOOL_TIMEOUT_MS).
  • SHARDFLUX_AGENT_LABEL Attribution label of every tool token this server obtains (shown as an agent session).
  • SHARDFLUX_MCP_LOG_LEVEL Log level of the JSON log lines on stderr (stdout carries the protocol).
  • SHARDFLUX_HTTP_KEEPALIVE Unset: private HTTP/1.1 pooling on Node 26, native fetch elsewhere. 0: force connection closure for diagnosis. 1: select native pooling.
  • SHARDFLUX_PREWAKE Offer explicit workspace_hint for tool input streaming (on or off).

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

ما هو Shardflux؟

Persistent cloud workspaces for AI agents: run commands, edit files, use git and a browser.

كيف أثبّت Shardflux؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http shardflux 'https://mcp.shardflux.dev/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

نعم. يتطلب SHARDFLUX_API_KEY، وتضبطها في إعداداته.

من يصون Shardflux؟

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

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