vault backup: 2026-09-11 20:58:25

2026-09-11 20:58:25 +08:00
parent 9c88db6d0f
commit 42953759ff
4 changed files with 156 additions and 0 deletions
@@ -0,0 +1,33 @@
+# 给 ZCode 安装 plane MCP server
+
+## 背景结论
+- 你贴的配置是 Claude Code 格式：`"!set -a && ..."` 的 `!` 命令展开是 Claude Code 专属语法，**ZCode 不支持**，必须改为在 `env` 里直接写字面值。
+- ZCode 用户级 MCP 配置位置：`C:\Users\windy\.zcode\cli\config.json` → `mcp.servers`（现有 `linear`、`tinyfish` 两个 HTTP server，新增 `plane` 不影响它们）。
+- 选**用户级**而非工作区级：当前 vault 是自动备份提交的 git 仓库，工作区配置会把 API Key 提交进版本库；用户级文件在 home 目录，不入库，符合密钥规范。
+- `uvx` 已就位（`~/.local/bin/uvx.exe`，uv 0.12.5），按需拉取方式运行（你已确认）。
+
+## 步骤
+
+1. **编辑 `C:\Users\windy\.zcode\cli\config.json`**，在 `mcp.servers` 中追加：
+   ```json
+   "plane": {
+     "type": "stdio",
+     "command": "uvx",
+     "args": ["plane-mcp-server", "stdio"],
+     "env": {
+       "PLANE_API_KEY": "plane_api_d3dd7b29c3d04f6190f7bcf9fda078f3",
+       "PLANE_WORKSPACE_SLUG": "space",
+       "PLANE_BASE_URL": "https://plane.chans.xyz"
+     }
+   }
+   ```
+
+2. **创建本地 env 文件 `C:\Users\windy\.config\plane-mcp\env`**（本机此前不存在），写入同样的三个 KEY=VALUE 行——保持你跨工具的约定，Claude Code 那份 `!` 展开配置在这台机器上也能继续用。
+
+3. **冒烟测试**：带上述环境变量运行 `uvx plane-mcp-server stdio`，向 stdin 发送 MCP initialize 握手 JSON-RPC，确认包能从 PyPI 拉取、进程能启动并返回 `tools` 能力。首次运行需下载依赖，可能较慢。
+
+4. **验证与收尾**：校验 config.json JSON 语法合法；若后续 ZCode 里 `uvx` 因 Windows PATH 解析问题起不来，备用方案是把 `command` 改成绝对路径 `C:\Users\windy\.local\bin\uvx.exe`。之后重启 ZCode 会话（或 Settings → MCP 查看）确认 plane 已连接、`mcp__plane__*` 工具出现。
+
+## 不做的事
+- 不改动工作区内的任何文件（vault 不落任何密钥）。
+- 不安装为 `uv tool install` 常驻工具（你选择了 uvx 按需拉取）。