Planka V2

项目设置

用户

创建一个名为 "Website Redesign" 的项目，并创建名为 "Backlog"、"In Progress" 和 "Done" 的看板。

助手

✓ Created project "Website Redesign"
✓ Created board "Backlog"
✓ Created board "In Progress"
✓ Created board "Done"

Project setup completed successfully.

创建任务

用户

在 Backlog 看板中创建一张名为 "Implement authentication" 的卡片，并添加以下任务：

• 设计登录流程
• 实现 JWT 身份验证
• 添加密码重置功能
• 编写测试

助手

✓ Created card "Implement authentication"
✓ Created task list
✓ Added 4 tasks

工作流自动化

用户

找出分配给我的所有逾期卡片，将它们移至 "Blocked"，添加一条说明原因的评论，并生成项目摘要。

助手

✓ Found 7 overdue cards
✓ Moved cards to "Blocked"
✓ Added explanatory comments
✓ Generated updated project summary

{
  "command": "node",
  "args": ["/absolute/path/to/planka-v2-mcp/dist/index.js"],
  "env": {
    "PLANKA_BASE_URL": "https://your-planka-instance.com",
    "PLANKA_AGENT_EMAIL": "[email protected]",
    "PLANKA_AGENT_PASSWORD": "your-secure-password",
    "PLANKA_IGNORE_SSL": "true"
  }
}

适用于为服务本身做贡献，或需要固定版本的离线构建的情况。

{
  "mcpServers": {
    "planka-mcp": {
      "command": "npx",
      "args": ["-y", "@goldpulpy/planka-v2-mcp@latest"],
      "env": {
        "PLANKA_BASE_URL": "https://your-planka-instance.com",
        "PLANKA_AGENT_EMAIL": "[email protected]",
        "PLANKA_AGENT_PASSWORD": "your-secure-password",
        "PLANKA_IGNORE_SSL": "true"
      }
    }
  }
}

将此代码块添加到相应的配置文件中：

说明

Claude Code 还支持通过一行命令添加服务，无需手动编辑 JSON：

claude mcp add planka-mcp \
  --env PLANKA_BASE_URL=https://your-planka-instance.com \
  --env [email protected] \
  --env PLANKA_AGENT_PASSWORD=your-secure-password \
  --env PLANKA_IGNORE_SSL=true \
  -- npx -y @goldpulpy/planka-v2-mcp@latest

保存后重启客户端。

编辑 ~/.codex/config.toml：

[mcp_servers.planka-mcp]
command = "npx"
args = ["-y", "@goldpulpy/planka-v2-mcp@latest"]

[mcp_servers.planka-mcp.env]
PLANKA_BASE_URL = "https://your-planka-instance.com"
PLANKA_AGENT_EMAIL = "[email protected]"
PLANKA_AGENT_PASSWORD = "your-secure-password"
PLANKA_IGNORE_SSL = "true"

或使用一行命令添加：

codex mcp add planka-mcp -- npx -y @goldpulpy/planka-v2-mcp@latest

然后在生成的 [mcp_servers.planka-mcp.env] 区块中设置 PLANKA_* 变量。

添加到 ~/.continue/config.yaml：

mcpServers:
  - name: planka-mcp
    command: npx
    args:
      - -y
      - "@goldpulpy/planka-v2-mcp@latest"
    env:
      PLANKA_BASE_URL: https://your-planka-instance.com
      PLANKA_AGENT_EMAIL: [email protected]
      PLANKA_AGENT_PASSWORD: your-secure-password
      PLANKA_IGNORE_SSL: "true"

编辑 ~/.config/zed/settings.json（macOS/Linux）或 %APPDATA%\Zed\settings.json（Windows），也可通过 Cmd+Shift+P → "zed: open settings" 打开：

{
  "context_servers": {
    "planka-mcp": {
      "source": "custom",
      "command": "npx",
      "args": ["-y", "@goldpulpy/planka-v2-mcp@latest"],
      "env": {
        "PLANKA_BASE_URL": "https://your-planka-instance.com",
        "PLANKA_AGENT_EMAIL": "[email protected]",
        "PLANKA_AGENT_PASSWORD": "your-secure-password",
        "PLANKA_IGNORE_SSL": "true"
      }
    }
  }
}

手动添加的服务（而非通过 Zed 扩展安装的服务）必须设置 "source": "custom"。保存后，Zed 会自动重新加载服务，无需重启编辑器。

此服务是标准的 stdio MCP 服务，任何支持 command / args / env 结构的客户端都可以使用。将其指向：

npx -y @goldpulpy/planka-v2-mcp@latest

并按上文所示设置四个 PLANKA_* 环境变量。

• 确认 PLANKA_BASE_URL 末尾没有斜杠，并且运行 MCP 服务的机器可以访问该地址（不只是浏览器可以访问）。
• 检查 Agent 用户能否通过 Planka 的常规 Web 界面使用完全相同的凭据登录，并且已接受服务条款。

• 如果你的实例使用自签名证书，请设置 "PLANKA_IGNORE_SSL": "true"。请勿在生产环境中这样做——应改用有效证书。

• 确保卡片类型为 "project"（默认值）。创建为 "story" 类型的卡片不会以相同方式显示任务列表。