2.1 KiB
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),按需拉取方式运行(你已确认)。
步骤
-
编辑
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" } } -
创建本地 env 文件
C:\Users\windy\.config\plane-mcp\env(本机此前不存在),写入同样的三个 KEY=VALUE 行——保持你跨工具的约定,Claude Code 那份!展开配置在这台机器上也能继续用。 -
冒烟测试:带上述环境变量运行
uvx plane-mcp-server stdio,向 stdin 发送 MCP initialize 握手 JSON-RPC,确认包能从 PyPI 拉取、进程能启动并返回tools能力。首次运行需下载依赖,可能较慢。 -
验证与收尾:校验 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 按需拉取)。