Add Colibri MCP client examples to live image (Sam & Codex)

Installs read-only and trusted-write MCP client config examples under /usr/local/share/clawdie-iso/mcp-examples and links them from the bootstrap page.\n\nChecks: ./scripts/check-format.sh; sh -n build.sh scripts/stage-colibri-iso.sh; python3 -m json.tool MCP examples; git diff --check

BUILD.md

@@ -98,7 +98,8 @@ the login milestone and is the lightweight control plane for the live USB.
 
 `colibri-mcp` is staged out of the box for MCP-capable editors and assistants.
 It defaults to read-only tools; launch it with `COLIBRI_MCP_WRITE=1` only for a
-trusted write-capable MCP profile.
+trusted write-capable MCP profile. Example MCP client configs are installed at
+`/usr/local/share/clawdie-iso/mcp-examples/`.
 
 ### Colibri vs. Clawdie service names
 

build.sh

@@ -1465,6 +1465,13 @@ EOF
     mkdir -p "${MOUNT_POINT}/usr/local/share/clawdie-iso/bootstrap"
     install -m 0644 "${LIVE_SESSION_DIR}/bootstrap.html" \
         "${MOUNT_POINT}/usr/local/share/clawdie-iso/bootstrap/index.html"
+    if [ -d "${LIVE_SESSION_DIR}/mcp-examples" ]; then
+        mkdir -p "${MOUNT_POINT}/usr/local/share/clawdie-iso/mcp-examples"
+        cp -R "${LIVE_SESSION_DIR}/mcp-examples/." \
+            "${MOUNT_POINT}/usr/local/share/clawdie-iso/mcp-examples/"
+        find "${MOUNT_POINT}/usr/local/share/clawdie-iso/mcp-examples" \
+            -type f -exec chmod 0644 {} +
+    fi
     chroot "$MOUNT_POINT" chown -R clawdie:clawdie /home/clawdie/Desktop
     chmod 0755 "${MOUNT_POINT}/home/clawdie/Desktop"
     chmod 0644 \

live/operator-session/bootstrap.html

@@ -122,6 +122,10 @@ colibri-mcp tools          # MCP bridge, read-only by default
 COLIBRI_MCP_WRITE=1 colibri-mcp tools  # trusted write-capable profile
 colibri create-task --title "check network"
 colibri list-tasks --status queued</pre>
+      <p>
+        MCP client examples are installed under
+        <code>/usr/local/share/clawdie-iso/mcp-examples/</code>.
+      </p>
 
       <h2>pi assistant</h2>
       <pre>

live/operator-session/mcp-examples/README.md

@@ -0,0 +1,58 @@
+# Colibri MCP client examples
+
+The live USB includes `/usr/local/bin/colibri-mcp`, an MCP server that exposes
+Colibri status, glasspane snapshots, task lists, and skills to MCP-capable
+editors/assistants.
+
+Default posture is read-only. Write tools are available only when the MCP server
+process is launched with `COLIBRI_MCP_WRITE=1`.
+
+## Generic MCP client config
+
+Most MCP clients accept a config shaped like `mcpServers`. Use one of:
+
+- `mcp-readonly.json` — safe default profile
+- `mcp-trusted-write.json` — explicit trusted profile with write tools enabled
+
+## Quick checks
+
+```sh
+colibri-mcp tools
+COLIBRI_MCP_WRITE=1 colibri-mcp tools
+colibri-mcp socket-path
+```
+
+## Claude Code example
+
+If your Claude Code version supports `claude mcp add`, adapt:
+
+```sh
+claude mcp add colibri /usr/local/bin/colibri-mcp
+claude mcp add colibri-write --env COLIBRI_MCP_WRITE=1 /usr/local/bin/colibri-mcp
+```
+
+If your version uses a JSON config file instead, copy the matching object from
+`mcp-readonly.json` or `mcp-trusted-write.json`.
+
+## Zed / Cursor example
+
+Zed, Cursor, and other MCP-capable editors may use slightly different config
+file paths or wrapper keys by version. The server object is the important part:
+
+```json
+{
+  "command": "/usr/local/bin/colibri-mcp",
+  "args": [],
+  "env": {}
+}
+```
+
+For a write-capable profile, add:
+
+```json
+{
+  "env": { "COLIBRI_MCP_WRITE": "1" }
+}
+```
+
+Only enable the write profile for trusted workspaces/sessions.

live/operator-session/mcp-examples/mcp-readonly.json

@@ -0,0 +1,9 @@
+{
+  "mcpServers": {
+    "colibri": {
+      "command": "/usr/local/bin/colibri-mcp",
+      "args": [],
+      "env": {}
+    }
+  }
+}

live/operator-session/mcp-examples/mcp-trusted-write.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "colibri-write": {
+      "command": "/usr/local/bin/colibri-mcp",
+      "args": [],
+      "env": {
+        "COLIBRI_MCP_WRITE": "1"
+      }
+    }
+  }
+}