指南 · 约 5 分钟

如何把 Onplana 连接到 Cursor

五个步骤。生成令牌，粘贴 mcpServers 片段，重新加载 Cursor，再用一次工具调用确认。约 5 分钟。

之后你就可以让 Cursor 的 Agent 做这样的事：“为 Q3 发布创建一份带每周里程碑的项目计划”，或“总结本周所有活跃项目的风险”，Cursor 会直接在 Onplana 中完成工作，无需离开编辑器。

打开 Onplana → 设置 → 智能体 Cursor 的 MCP 文档

五个步骤

  1. 1

    生成 Onplana 连接令牌

    在 app.onplana.com 登录 Onplana。前往“设置 → 智能体 → 连接智能体”，选择 Cursor 卡片（或 Custom MCP client），然后选择“个人访问令牌”，最后生成令牌并显示连接片段。复制个人访问令牌（以 pat_ 开头）。该令牌只有 MCP_AGENT 范围：它可以调用 MCP 工具，但不能创建其他令牌、更改计费，也不能触碰 MCP 之外的任何内容。

  2. 2

    打开 Cursor 的 MCP 配置

    在 Cursor 中打开 Settings（macOS 上按 Command+Shift+J，Windows 或 Linux 上按 Ctrl+Shift+J），进入 Tools & MCP，选择 New MCP Server。Cursor 也可以直接读取 JSON 配置：项目级的在仓库根目录的 .cursor/mcp.json 中，全局的在 ~/.cursor/mcp.json 中。编辑 JSON 与使用界面的效果相同。

  3. 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. 4

    重新加载 Cursor

    重新加载 Cursor 窗口（Command+Shift+P 或 Ctrl+Shift+P，然后选择 "Reload Window"），或在 Settings 的 Tools & MCP 中关闭再打开 onplana 服务器。握手成功后，Onplana 的工具会出现在 Agent 的工具列表中，并带一个绿色状态点。

  5. 5

    确认连接

    在 Cursor 的 Agent 聊天中问：“列出我的 Onplana 项目”。Cursor 会调用 Onplana 的 list_projects 工具并显示结果。如果看到错误，请检查令牌，并确认配置文件是有效的 JSON。

.cursor/mcp.json（项目）或 ~/.cursor/mcp.json（全局）

{
  "mcpServers": {
    "onplana": {
      "url": "https://mcp.onplana.com/mcp",
      "headers": {
        "Authorization": "Bearer pat_paste-your-token-here"
      }
    }
  }
}

如何确认它能正常工作

打开 Cursor 的 Agent 聊天，试试下面任意一个：

  • “列出我的 Onplana 项目。”
  • “我的 Onplana 账户里有什么逾期了？”
  • “在 Onplana 的项目 X 中创建一项名为‘把 Postgres 迁移到 Aurora’的任务。”
  • “生成项目 Y 的状态报告。”

Cursor 会在执行之前显示工具调用，方便你检查读取或写入了哪些数据。修改在所有方案中都会应用；在 Free 中，部分写入操作有每月上限（Professional 方案及以上没有上限），智能体还可以通过其 dryRun 选项请求一个不提交任何内容的预览。

常见问题

Onplana 的哪个方案包含 MCP？

MCP 包括免费版在内的所有方案均可使用。智能体的并发连接数随方案增加（Free 2，Professional 3，Business 5，Enterprise 10，Enterprise+ 不限），而真正限制 AI 用量的是你的 AI 令牌余额（付费方案为每月额度，Free 为一次性赠送额度，另加你购买的额度）。你可以随时在 app.onplana.com/billing 更换方案。

Cursor 的 MCP 支持稳定吗？

稳定，MCP 是 Cursor 中已经发布的功能，而不是实验性功能。Onplana 的连接关联到 CURSOR 提供方，并获得所有读取、创建和更新工具。话虽如此，Cursor 的设置位置可能随版本变化；如果发生这种情况，请在 docs.cursor.com 查看当前位置，并保留同样的 onplana 服务器条目。

用项目配置还是全局配置？

两者都可以。仓库根目录中的 .cursor/mcp.json 把连接限定在该项目（当不同仓库对应使用不同令牌的不同 Onplana 组织时很有用）。~/.cursor/mcp.json 把连接应用到所有 Cursor 窗口。如果两者都定义了 "onplana" 服务器，以项目配置为准。

Cursor 能使用哪些工具？

与任何 MCP 客户端看到的同一个 351 个工具目录：读取（list_projects、get_project、list_tasks、list_my_tasks、list_overdue、list_risks、search_org_knowledge、summarize_project、generate_status_report）、写入（create_project、create_task、update_task、assign_task、create_milestone、create_comment、bulk_update_tasks、create_sprint_with_tasks、link_dependency），以及治理、变更控制、合规、文档和工作流等领域。部分工具由方案开启；完整目录见 onplana.com/mcp。

Cursor 能通过 MCP 删除项目或任务吗？

能，而且可以恢复，除非管理员把它关闭了。通过 MCP 的删除工具有：删除任务、项目、列表或文档。每一项都是按工作区设置的开关，在管理员保存选择之前一直开启，调用者也仍然需要本来就需要的权限。所有删除都可逆地放入回收站，删除的任务或项目会连同整个子树一起保留，并以原来的标识符还原，因此依赖关系和层级都保持完整。冲刺、里程碑、史诗和目标没有任何通过 MCP 的删除工具。

能用 OAuth 代替粘贴令牌吗？

Onplana 在 mcp.onplana.com/.well-known/ 发布 OAuth 2.1 的发现元数据（RFC 9728 和 RFC 8414）。Cursor 是否自动使用它们，取决于你所用 Cursor 版本对 MCP 认证的支持；这里介绍的在请求头中放令牌的方式，适用于所有支持远程 MCP 服务器的版本。

在哪里吊销连接？

在 Onplana 中，依次进入“设置”“智能体”“连接”，在令牌所在行选择“吊销”。立即生效；Cursor 的下一次工具调用会返回 401。Enterprise 方案及以上，组织所有者或管理员可以在审计日志页面的“智能体活动”中看到该令牌发出的每一次调用。

相关内容