指南 · 约 5 分钟

如何把 Onplana 连接到 Windsurf

五个步骤。生成令牌，粘贴 mcpServers 片段（Windsurf 使用 serverUrl），刷新 Cascade，再用一次工具调用确认。约 5 分钟。

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

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

五个步骤

  1. 1

    生成 Onplana 连接令牌

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

  2. 2

    打开 Windsurf Cascade 的 MCP 配置

    在 Windsurf 中打开 Plugins (MCP) 面板，选择 "View raw config"。这会打开 mcp_config.json。在 macOS 和 Linux 上它位于 ~/.codeium/windsurf/mcp_config.json；在 Windows 上位于你用户配置文件下的 .codeium\windsurf 文件夹中。如果文件为空，用 {} 开头。

  3. 3

    粘贴 Onplana MCP 服务器的配置

    在 "mcpServers" 键下添加一个 "onplana" 条目。完整配置：{"mcpServers": {"onplana": {"serverUrl": "https://mcp.onplana.com/mcp", "headers": {"Authorization": "Bearer pat_paste-your-token-here"}}}}。Windsurf 对远程 HTTP 服务器使用 "serverUrl" 键（而不是 "url"）。把 pat_paste-your-token-here 替换为第 1 步的令牌并保存。

  4. 4

    刷新 Cascade

    在 Plugins (MCP) 面板中点击 "Refresh"（圆形箭头），让 Cascade 重新读取配置并完成 MCP 握手。onplana 服务器应显示绿色状态和可用工具的数量。Cascade 最多同时启用 100 个 MCP 工具，而 Onplana 提供 351 个，所以如果缺少 Onplana 的某些工具，请停用你不需要的其他服务器或工具。

  5. 5

    确认连接

    在 Cascade 中问：“列出我的 Onplana 项目”。Windsurf 会调用 Onplana 的 list_projects 工具并显示结果。如果看到错误，请检查令牌，确认键名是 "serverUrl"（不是 "url"），并确认 JSON 有效。

~/.codeium/windsurf/mcp_config.json

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

如何确认它能正常工作

打开 Cascade，试试下面任意一个：

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

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

常见问题

Onplana 的哪个方案包含 MCP？

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

为什么 Windsurf 使用 "serverUrl" 而不是 "url"？

这是 Windsurf 针对通过 HTTP 的远程 MCP 服务器的配置结构。Claude Desktop 和 Cursor 使用 "url"；Windsurf Cascade 使用 "serverUrl"。条目的其余部分（onplana 服务器名称和 Authorization 请求头）完全相同。误用 "url" 是 Windsurf 连接不出现、又不报错的最常见原因。

Windsurf 的 MCP 支持稳定吗？

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

Windsurf 能使用哪些工具？

与任何 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。

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

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

在哪里吊销连接？

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

相关内容