MCP server
Shardflux
Persistent cloud workspaces for AI agents: run commands, edit files, use git and a…
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.shardflux.dev/mcpInstall 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.RequiredSHARDFLUX_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.