Files
my-vault/.zcode/plans/plan-sess_0cc98e77-f1eb-421d-9514-7ef2591a7320.md
T
windyboy a3ee8c09cf security: scrub live credentials from tracked notes; point values at Vaultwarden
- replace real keys/passwords/tokens/connection strings with {{SECRET_*}}
  placeholders across 24 files (review-named 12 + noise-audit finds:
  WAQI/Dovecot/GPS/VPN subscriptions/Work runbooks/Plane API key)
- widen verifier: OPENSSH/RSA key headers, hyphenated sk-/prefixed sk-,
  credential assignments & table cells, telegram bot tokens, conn strings
- placeholder/default-value/config-name exemptions to kill doc FPs
- skip .obsidian plugin code and frozen Inbox-Clippings from value scan
- GIT_WORKFLOW: no git add ., verifier before commit, force-push exception
- final regression: 0 flagged in tracked scope (was 43)
2026-09-26 12:26:57 +08:00

2.1 KiB

给 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 中追加:

    "plane": {
      "type": "stdio",
      "command": "uvx",
      "args": ["plane-mcp-server", "stdio"],
      "env": {
        "PLANE_API_KEY": "{{SECRET_PLANE_API}}",
        "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 按需拉取)。