English Français العربية

Shardflux

Official registry Developer tools

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

Website

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http shardflux 'https://mcp.shardflux.dev/mcp'
JSON configuration (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 configuration (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"
            }
        }
    }
}

Environment variables

  • SHARDFLUX_API_KEY required secret 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).

Frequently asked questions

What is Shardflux?

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

How do I install Shardflux?

It runs as a remote server. In Claude Code: claude mcp add --transport http shardflux 'https://mcp.shardflux.dev/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Shardflux need an API key?

Yes. It expects SHARDFLUX_API_KEY, which you set in its configuration.

Who maintains Shardflux?

It is published by dev.shardflux. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.