From fbe028717e2314aedce9ed851dc44a7e7098823d Mon Sep 17 00:00:00 2001 From: Sawizzle <156952830+sawizzle@users.noreply.github.com> Date: Fri, 9 Oct 2026 17:06:42 -0700 Subject: [PATCH] docs: register the MCP server from an installed release Co-Authored-By: Claude Opus 5.5 --- docs/agents.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/agents.md b/docs/agents.md index f3618f60..1c2bb6ee 100644 --- a/docs/agents.md +++ b/docs/agents.md @@ -43,6 +43,26 @@ Desktop, Cursor and the like) take the same `command` and `args`. - **Bridge** (`["mcp", "--bridge", "9877"]`): drives a running `effectcraft --control 9877`, so you see every change live. Bridge mode adds `screenshot` and the `ui_*` tools. +### From an installed release + +The release packages ship `effectcraft-cli` alongside the desktop app, so no build is needed: + +| Install | CLI | +|---|---| +| Windows (MSI) | `C:\Program Files\EffectCraft\effectcraft-cli.exe`, not added to `PATH` | +| Linux (deb, rpm) | `/usr/bin/effectcraft-cli` | +| macOS | the separate `effectcraft-cli--macos-universal.zip` release asset (the `.app` holds only the desktop app) | + +```sh +# Windows +claude mcp add effectcraft -- "C:\Program Files\EffectCraft\effectcraft-cli.exe" mcp +# Linux, or macOS with the CLI unzipped onto PATH +claude mcp add effectcraft -- effectcraft-cli mcp +``` + +An unofficial community plugin, [artcraft-claude-plugin](https://github.com/sawizzle/artcraft-claude-plugin), +registers the installed ArtCraft apps in Claude Code in one step and adds usage notes for agents. + The server speaks JSON-RPC 2.0 over stdio, one message per line, and supports MCP protocol versions 2025-06-18, 2025-03-26 and 2024-11-05 (`initialize`, `ping`, `tools/list`, `tools/call`).