前置条件
- 已安装 Windsurf
- Linkly AI Desktop 已启动，MCP 服务正在运行
配置步骤
MCP HTTP（推荐）
MCP Stdio
远程访问
编辑 MCP 配置文件，在 mcpServers 中添加：// ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"linkly-ai": {
"serverUrl": "http://127.0.0.1:60606/mcp"
}
}
}
// %USERPROFILE%\.codeium\windsurf\mcp_config.json
{
"mcpServers": {
"linkly-ai": {
"serverUrl": "http://127.0.0.1:60606/mcp"
}
}
}
需要先安装 Linkly AI CLI。编辑配置文件，在 mcpServers 中添加：{
"mcpServers": {
"linkly-ai": {
"command": "linkly",
"args": ["mcp"]
}
}
}
需要先完成远程访问配置，桌面端隧道显示● 已连接。{
"mcpServers": {
"linkly-ai": {
"serverUrl": "https://mcp.linkly.ai/mcp",
"headers": {
"Authorization": "Bearer ${env:LINKLY_API_KEY}"
}
}
}
}
配置文件支持 ${env:VAR_NAME} 语法，可通过环境变量管理 API Key，避免明文写入配置文件。
开始使用
配置完成后，在 Windsurf 的 Cascade 面板中直接提问，Cascade 会自动调用 Linkly AI 的工具。例如：
- “搜索我的文档中关于 API 设计的内容”
- “读一下项目需求文档并总结关键点”
常见问题
确认 Windsurf 已完全重启（不仅是关闭窗口），以及配置文件 JSON 格式正确。可在
Cascade 设置中查看 MCP 服务器状态。
Windsurf Cascade 最多支持 100 个工具（汇总所有 MCP
服务器）。如果工具总数超过上限，部分工具可能不可用。
