跳转到主要内容

​
前置条件

  • 已安装 Windsurf
  • Linkly AI Desktop 已启动，MCP 服务正在运行

​
配置步骤

编辑 MCP 配置文件，在 mcpServers 中添加：
// ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "linkly-ai": {
      "serverUrl": "http://127.0.0.1:60606/mcp"
    }
  }
}
保存后重启 Windsurf。
配置文件支持 ${env:VAR_NAME} 语法，可通过环境变量管理 API Key，避免明文写入配置文件。

​
开始使用

配置完成后，在 Windsurf 的 Cascade 面板中直接提问，Cascade 会自动调用 Linkly AI 的工具。例如：
  • “搜索我的文档中关于 API 设计的内容”
  • “读一下项目需求文档并总结关键点”

​
常见问题

确认 Windsurf 已完全重启（不仅是关闭窗口），以及配置文件 JSON 格式正确。可在 Cascade 设置中查看 MCP 服务器状态。
Windsurf Cascade 最多支持 100 个工具（汇总所有 MCP 服务器）。如果工具总数超过上限，部分工具可能不可用。