Skip to content
MCP server

Shardflux

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

Install
Runs
Locally or Remotely
Version
0.12.2
Listing updated
5 days ago

About Shardflux

Shardflux is an MCP server. It can run locally on your machine or as a hosted remote server.

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

Install

Run in a terminal

claude mcp add --transport http mcp https://mcp.shardflux.dev/mcp

Add to Settings → Connectors → Add custom connector

https://mcp.shardflux.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.shardflux.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.shardflux.dev/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.shardflux.dev/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.shardflux.dev/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • SHARDFLUX_API_KEYScoped Shardflux project API key (sfk_<key id>_<secret>). Its tool permissions decide which workspace tools are listed.Required
  • SHARDFLUX_API_URLAPI base URL. Plain http:// is allowed only for loopback hosts.
  • SHARDFLUX_WORKSPACE_KEYPin one workspace: workspace_key becomes optional on every tool and any other key is refused (workspace_pinned).
  • SHARDFLUX_TEMPLATEDefault template slug for workspace_open.
  • SHARDFLUX_MCP_TOOL_TIMEOUT_MSDefault and maximum deadline per tool call in milliseconds (1000-3600000). A call's timeout_ms can only shorten it.
  • SHARDFLUX_WAKEon: workspace tools resume a suspended workspace and then run. off: they return the workspace_not_running refusal.
  • SHARDFLUX_WAKE_TIMEOUT_MSLongest 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_LABELAttribution label of every tool token this server obtains (shown as an agent session).
  • SHARDFLUX_MCP_LOG_LEVELLog level of the JSON log lines on stderr (stdout carries the protocol).
  • SHARDFLUX_HTTP_KEEPALIVEUnset: private HTTP/1.1 pooling on Node 26, native fetch elsewhere. 0: force connection closure for diagnosis. 1: select native pooling.
  • SHARDFLUX_PREWAKEOffer explicit workspace_hint for tool input streaming (on or off).

Shardflux FAQ

How do I add Shardflux to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.shardflux.dev/mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers