English Français العربية

Shardflux

Registre officiel Outils de développement

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

Site web

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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

Variables d'environnement

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

Questions fréquentes

Qu'est-ce que Shardflux ?

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

Comment installer Shardflux ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http shardflux 'https://mcp.shardflux.dev/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Shardflux ?

Oui. Il attend SHARDFLUX_API_KEY, à renseigner dans sa configuration.

Qui maintient Shardflux ?

Il est publié par dev.shardflux. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.