diff --git a/docs/mcp.md b/docs/mcp.md
index f53c56767..df2203843 100644
--- a/docs/mcp.md
+++ b/docs/mcp.md
@@ -24,6 +24,26 @@ Other MCP clients use the same command line, e.g. in a JSON config:
 {"mcpServers": {"designcraft": {"command": "/path/to/designcraft-cli", "args": ["mcp"]}}}
 ```
 
+### From an installed release
+
+The release packages ship `designcraft-cli` alongside the desktop app, so no build is needed:
+
+| Install | CLI |
+|---|---|
+| Windows (MSI) | `C:\Program Files\DesignCraft\designcraft-cli.exe`, not added to `PATH` |
+| Linux (deb, rpm) | `/usr/bin/designcraft-cli` |
+| macOS | the separate `designcraft-cli-<version>-macos-universal.zip` release asset (the `.app` holds only the desktop app) |
+
+```sh
+# Windows
+claude mcp add designcraft -- "C:\Program Files\DesignCraft\designcraft-cli.exe" mcp
+# Linux, or macOS with the CLI unzipped onto PATH
+claude mcp add designcraft -- designcraft-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.
+
 ## Modes
 
 | | Headless (`mcp`) | Connected (`mcp --connect PORT` or `HOST:PORT`) |