From 16727f331cccce57a8fa5d48bcc96d2e4804c686 Mon Sep 17 00:00:00 2001 From: rbousigues88 Date: Sat, 24 Oct 2026 01:40:56 +0000 Subject: [PATCH] docs(mcp): Windows setup for Claude Desktop (#3794) * docs(mcp): Windows setup for Claude Desktop (paths, two servers, Store config file) Co-Authored-By: Claude Opus 5.5 * docs(mcp): say the Store build can keep the config elsewhere, not that the other path fails Co-Authored-By: Claude Opus 5.5 --------- Co-authored-by: Claude Opus 5.5 --- docs/mcp.md | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/docs/mcp.md b/docs/mcp.md index 0a95dca62..0eb2784b5 100644 --- a/docs/mcp.md +++ b/docs/mcp.md @@ -154,6 +154,38 @@ Claude Desktop (`claude_desktop_config.json`), bridged to a running app: } ``` +On Windows the installer puts `solidcraft-cli.exe` next to `solidcraft.exe` in +`C:\Program Files\SolidCraft` (the portable zip has both too). Give the full path, with each +backslash doubled in JSON. This configuration declares two servers: `solidcraft` models +headless (no window; steadier for timings), `solidcraft-live` drives the app you have open, so +you can watch the agent model. `--allow-path` names a folder where the agent may save and +export; it must already exist. + +```json +{ + "mcpServers": { + "solidcraft": { + "command": "C:\\Program Files\\SolidCraft\\solidcraft-cli.exe", + "args": ["mcp", "--allow-path", "C:\\Users\\NAME\\SolidCraft-Agent"] + }, + "solidcraft-live": { + "command": "C:\\Program Files\\SolidCraft\\solidcraft-cli.exe", + "args": ["mcp", "--connect", "127.0.0.1:7878", "--allow-path", "C:\\Users\\NAME\\SolidCraft-Agent"] + } + } +} +``` + +Start the app with its control channel for `solidcraft-live`, from PowerShell: +`& "C:\Program Files\SolidCraft\solidcraft.exe" --control 7878`, or once for every launch: +`setx SOLIDCRAFT_CONTROL_PORT 7878`. + +Open `claude_desktop_config.json` with Claude Desktop's **Settings > Developer > Edit Config** +rather than by its path: the Microsoft Store (MSIX) build of Claude Desktop can keep its data in +its own package folder (`%LOCALAPPDATA%\Packages\…\LocalCache\Roaming\Claude`) instead of +`%APPDATA%\Claude`, and Edit Config opens the file the app actually reads. Quit Claude Desktop +completely (from the notification area) and start it again to load the servers. + ### Agent skills [`skills/`](https://github.com/bherbruck/solidcraft/tree/main/skills) holds four [Agent Skills](https://agentskills.io) for agents that model through this server: