如何把 Onplana 连接到 Claude Desktop
五个步骤。生成令牌，粘贴配置片段，重启 Claude Desktop，再用一次工具调用确认。总共约 5 分钟。
之后你就可以让 Claude 做这样的事：“为 Q3 发布创建一份带每周里程碑的项目计划”，或“总结本周所有活跃项目的风险”，Claude 会直接在 Onplana 中完成工作。
五个步骤
- 1
生成 Onplana 连接令牌
在 app.onplana.com 登录 Onplana。前往“设置 → 智能体 → 连接智能体”，选择 Claude Desktop 卡片（或 Custom MCP client），然后选择“个人访问令牌”，最后生成令牌并显示连接片段。复制个人访问令牌（以 pat_ 开头）。该令牌只有 MCP_AGENT 范围：它可以调用 MCP 工具，但不能创建其他令牌、更改计费，也不能触碰 MCP 之外的任何内容。
- 2
打开 Claude Desktop 的配置
在 Claude Desktop 中，点击 Settings → Developer → Edit Config。这会在你的默认编辑器中打开 claude_desktop_config.json。在 macOS 上它位于 ~/Library/Application Support/Claude/claude_desktop_config.json；在 Windows 上位于 %APPDATA%\Claude\claude_desktop_config.json。如果文件为空或不存在，用 `{}` 创建它。
- 3
粘贴 Onplana MCP 服务器的配置
在 "mcpServers" 键下添加一个 "onplana" 条目。完整配置：{"mcpServers": {"onplana": {"url": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}。把 pat_paste-your-token-here 替换为第 1 步复制的令牌。保存文件。
- 4
重启 Claude Desktop
完全退出 Claude Desktop（macOS 上按 Command+Q，Windows 上彻底关闭）再重新打开。Onplana 的工具应该会出现在工具选择器中。
- 5
确认连接
在新对话中问：“列出我的 Onplana 项目”。Claude 会调用 Onplana 的 list_projects 工具并显示结果。如果看到错误，请检查令牌，并确认配置文件是有效的 JSON。
claude_desktop_config.json
{
"mcpServers": {
"onplana": {
"url": "https://mcp.onplana.com/mcp",
"headers": {
"Authorization": "Bearer pat_paste-your-token-here"
}
}
}
}如何确认它能正常工作
在 Claude Desktop 中打开一个新对话，试试下面任意一个：
- “列出我的 Onplana 项目。”
- “我的 Onplana 账户里有什么逾期了？”
- “在 Onplana 的项目 X 中创建一项名为‘把 Postgres 迁移到 Aurora’的任务。”
- “生成项目 Y 的状态报告。”
Claude 会在执行之前在对话中显示工具调用，方便你检查读取或写入了哪些数据。修改在所有方案中都会应用；在 Free 中，部分写入操作有每月上限（Professional 方案及以上没有上限），智能体还可以通过其 dryRun 选项请求一个不提交任何内容的预览。
常见问题
Onplana 的哪个方案包含 MCP？
MCP 包括免费版在内的所有方案均可使用。智能体的并发连接数随方案增加（Free 2，Professional 3，Business 5，Enterprise 10，Enterprise+ 不限），而真正限制 AI 用量的是你的 AI 令牌余额（付费方案为每月额度，Free 为一次性赠送额度，另加你购买的额度）。你可以随时在 app.onplana.com/billing 更换方案。
有没有 OAuth 可以替代令牌？
有。Onplana 已收录在 Claude 的 Connectors 目录中：在 Claude Desktop（或 claude.ai）中打开 Settings，找到 Connectors，浏览目录，选择 Onplana，然后在浏览器中批准访问，无需粘贴任何内容。底层是带 PKCE 的 OAuth 2.1，Onplana 按 RFC 9728 和 RFC 8414 在 https://mcp.onplana.com/.well-known/oauth-protected-resource 和 oauth-authorization-server 发布发现元数据。这里介绍的粘贴令牌方式适用于你想要配置文件的情况；OAuth 适合不想管理长期令牌的人。
Claude 能使用哪些工具？
351 个工具：读取（例如 list_projects、get_project、list_tasks、list_my_tasks、list_overdue、list_risks、search_org_knowledge、summarize_project、analyze_project_risks、generate_status_report）、写入（例如 create_project、create_task、update_task、assign_task、create_milestone、create_comment、bulk_update_tasks、create_sprint_with_tasks、submit_timesheet、link_dependency、move_task_to_sprint），以及治理、变更控制、合规、文档和工作流的所有领域。部分工具由方案开启；完整目录见 onplana.com/mcp。
Claude 能通过 MCP 删除项目或任务吗？
能，而且可以恢复，除非管理员把它关闭了。通过 MCP 的删除工具有：删除任务、项目、列表或文档。每一项都是按工作区设置的开关，在管理员保存选择之前一直开启，调用者也仍然需要本来就需要的权限。所有删除都可逆地放入回收站，删除的任务或项目会连同整个子树一起保留，并以原来的标识符还原，因此依赖关系和层级都保持完整。冲刺、里程碑、史诗和目标没有任何通过 MCP 的删除工具。
可以用 Claude Code（CLI）代替 Claude Desktop 吗？
可以。Claude Code 内置 MCP 支持。一行安装：`claude mcp add onplana --transport http https://mcp.onplana.com/mcp`。Claude Code 在第一次调用工具时启动 OAuth（无需粘贴令牌），打开浏览器登录 Onplana 并完成授权；此后，该项目中的任何 `claude` 会话都能看到 Onplana 的工具目录。如果要用令牌代替 OAuth，在命令后加上 `--header "Authorization: Bearer pat_…"`。用 `claude mcp list` 确认。适用于 macOS、Linux 和 Windows 上的 WSL。
在哪里可以吊销连接？
在 Onplana 中，“设置 → 智能体 → 连接”列出每个连接，包括个人访问令牌和浏览器登录：在对应行选择“吊销”。立即生效；Claude 的下一次工具调用会返回 401，Claude 会请你重新连接。
如果我的令牌泄露了怎么办？
立即吊销它（见上文），并在同一个面板中生成一个新令牌。泄露的令牌在下一次调用时就会失效。Enterprise 方案及以上，组织所有者或管理员可以在审计日志页面的“智能体活动”中看到泄露令牌发出的每一次调用，以检查攻击者可能看到或修改了什么。
在 Linux 上能用吗？
Claude Desktop 目前只有 macOS 和 Windows 版本。在 Linux 上，请使用其他 MCP 客户端，例如 MCP 官方 Inspector（npx @modelcontextprotocol/inspector）或 Cursor（支持 Linux），或者用 Onplana 的 TypeScript 类型化客户端 SDK，把 Onplana 连接集成到本地智能体脚本中。