# 给 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 按需拉取）。