前置条件
- 已安装 Raycast(需要 Raycast Pro 订阅以使用 AI 功能)
- 已安装 Linkly AI CLI(Raycast 仅支持 Stdio 传输,必须通过 CLI)
- Linkly AI Desktop 已启动,MCP 服务正在运行
配置步骤
1
打开 MCP 扩展
在 Raycast 中搜索 Install Server,或前往 Raycast Store 安装 MCP 扩展(如未安装)。
2
添加 Linkly AI
执行 Install Server 命令,填写: - Name:
linkly-ai - Type:stdio - Command:linkly - Arguments:mcp3
重启 Raycast
保存后完全退出并重新启动 Raycast,使配置生效。
Raycast 目前仅支持 Stdio 传输,不支持 HTTP URL 方式。因此必须先安装 Linkly AI CLI,由 CLI 作为桥接与桌面端通信。
开始使用
配置完成后,在 Raycast AI Chat 中,输入@linkly-ai 召唤工具,或直接提问,Raycast 会自动调用 Linkly AI 的工具。例如:
- “搜索我的文档中关于产品设计的内容”
- “@linkly-ai read my project readme”
常见问题
提示找不到 linkly 命令
提示找不到 linkly 命令
Raycast 使用独立的 PATH 环境。请确保
linkly 命令安装在标准路径(如 /usr/local/bin 或 /opt/homebrew/bin)。 可在终端运行 which linkly 确认路径,并确保该路径在 Raycast 的 PATH 中。 修改 PATH 后需完全重启 Raycast 才能生效。工具列表为空
工具列表为空
确认 Linkly AI Desktop 已启动且 MCP 服务正在运行。Raycast 在每次调用时都会连接 CLI,桌面端必须处于运行状态。

