Skip to content
selvedge

Cline MCP setup

Selvedge works with any compatible agent. This page covers one optional client integration; see general MCP and CLI setup for other agents.

Cline is the open-source autonomous agent for VS Code. It reads MCP servers from its own settings file, so Selvedge drops in with a small JSON block.

Before you start

Section titled “Before you start”

Install uv, then install the Selvedge CLI and MCP server:

Terminal window
uv tool install --upgrade selvedge

The MCP config below launches the server with uvx instead of a bare selvedge-server, so the package can be fetched on demand — the editor still needs to find uv installed. Prefer the global binary? Swap uvx --from selvedge selvedge-server for selvedge-server.

Add the MCP server

Section titled “Add the MCP server”

Add this to cline_mcp_settings.json — open it from Cline → MCP Servers → Configure MCP Servers:

{
  "mcpServers": {
    "selvedge": {
      "command": "uvx",
      "args": ["--from", "selvedge", "selvedge-server"]
    }
  }
}

Tell your agent when to call it

Section titled “Tell your agent when to call it”

Selvedge captures decisions when your agent calls it. Install the instruction block into your project’s .clinerules:

Terminal window
selvedge prompt --install .clinerules

It’s also a copy-paste block on the site: the Selvedge agent prompt block.

Verify

Section titled “Verify”

Open Cline’s MCP Servers panel — selvedge should appear with a green dot and its 8 tools listed. Then ask Cline to make a structural change and confirm it calls log_change.

If it doesn’t connect

Section titled “If it doesn’t connect”

Cline runs the command in your VS Code environment. If the server won’t start, make sure uv is installed there (the config calls uvx, which ships with uv). Prefer a global install? pip install selvedge and set command to selvedge-server.

Next

Section titled “Next”