> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 Raycast 中使用 Linkly AI

> 将 Linkly AI 本地知识库集成到 Raycast AI，让 macOS 效率工具能够搜索和阅读你的私有文档

## 前置条件

* 已安装 [Raycast](https://raycast.com)（需要 Raycast Pro 订阅以使用 AI 功能）
* 已安装 [Linkly AI CLI](/docs/zh/use-cli)（Raycast 仅支持 Stdio 传输，必须通过 CLI）
* Linkly AI Desktop 已启动，MCP 服务正在运行

## 配置步骤

<Steps>
  <Step title="打开 MCP 扩展">
    在 Raycast 中搜索 **Install Server**，或前往 **Raycast Store** 安装 MCP
    扩展（如未安装）。
  </Step>

  <Step title="添加 Linkly AI">
    执行 **Install Server** 命令，填写： - **Name**：`linkly-ai` -
    **Type**：`stdio` - **Command**：`linkly` - **Arguments**：`mcp`
  </Step>

  <Step title="重启 Raycast">
    保存后完全退出并重新启动 Raycast，使配置生效。
  </Step>
</Steps>

<Note>
  Raycast 目前**仅支持 Stdio 传输**，不支持 HTTP URL 方式。因此必须先安装 Linkly
  AI CLI，由 CLI 作为桥接与桌面端通信。
</Note>

## 开始使用

配置完成后，在 Raycast AI Chat 中，输入 `@linkly-ai` 召唤工具，或直接提问，Raycast 会自动调用 Linkly AI 的工具。例如：

* "搜索我的文档中关于产品设计的内容"
* "@linkly-ai read my project readme"

## 常见问题

<AccordionGroup>
  <Accordion title="提示找不到 linkly 命令">
    Raycast 使用独立的 PATH 环境。请确保 `linkly` 命令安装在标准路径（如
    `/usr/local/bin` 或 `/opt/homebrew/bin`）。 可在终端运行 `which linkly`
    确认路径，并确保该路径在 Raycast 的 PATH 中。 修改 PATH 后需完全重启 Raycast
    才能生效。
  </Accordion>

  <Accordion title="工具列表为空">
    确认 Linkly AI Desktop 已启动且 MCP 服务正在运行。Raycast
    在每次调用时都会连接 CLI，桌面端必须处于运行状态。
  </Accordion>
</AccordionGroup>