跳转到主要内容
Windsurf 已更名为 Devin Desktop。本文按 Devin Desktop 编写;还在用改名前的 Windsurf,见文末常见问题。

前置条件

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

配置步骤

Devin Desktop 从 mcp_config.json 读取 MCP 服务器配置,新对话默认使用的 Devin Local 智能体和旧的 Cascade 智能体都读这个文件:
  • macOS / Linux:~/.config/devin/mcp_config.json
  • Windows:%APPDATA%\devin\mcp_config.json
在 mcpServers 中添加:
保存后重启 Devin Desktop。
Devin Local 默认在每次调用 MCP 工具前请你确认。弹出确认时,可以选择对 linkly-ai 的全部工具始终允许,之后就不会反复询问。

开始使用

配置完成后,在 Devin Desktop 中新建对话直接提问,智能体会自动调用 Linkly AI 的工具。例如:
  • “搜索我的文档中关于 API 设计的内容”
  • “读一下项目需求文档并总结关键点”

常见问题

确认 Devin Desktop 已完全退出后重新打开(不只是关闭窗口),并检查配置文件 JSON 格式是否正确。Devin Local 的自定义面板会列出当前会话加载了哪些 MCP 服务器,可以在那里确认 linkly-ai 是否已连接。
旧版 Windsurf 的配置文件在 ~/.codeium/windsurf/mcp_config.json(Windows 为 %USERPROFILE%\.codeium\windsurf\mcp_config.json),HTTP 地址的字段名用 serverUrl,其余步骤相同。更新到 Devin Desktop 后如果用不到 Linkly AI 的工具,按本文的路径重新配置一次。
旧的 Cascade 智能体最多支持 100 个工具(汇总所有 MCP 服务器)。如果工具总数超过上限,部分工具可能不可用。