Files
my-vault/.zcode/plans/plan-sess_0cc98e77-f1eb-421d-9514-7ef2591a7320.md
T

2.1 KiB

给 ZCode 安装 plane MCP server

背景结论

  • 你贴的配置是 Claude Code 格式:"!set -a && ..."! 命令展开是 Claude Code 专属语法,ZCode 不支持,必须改为在 env 里直接写字面值。
  • ZCode 用户级 MCP 配置位置:C:\Users\windy\.zcode\cli\config.jsonmcp.servers(现有 lineartinyfish 两个 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": "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 按需拉取)。