> ## 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.

# 在 Claude Cowork 中使用 Linkly AI

> 将 Linkly AI 本地知识库集成到 Claude Cowork，让 AI 桌面助手能够搜索和阅读你的私有文档

## 可以用来做什么

<AccordionGroup>
  <Accordion title="本地直连，无需隧道，随时高频调用">
    与 claude.ai 网页版不同，Claude Desktop 通过本机 MCP 直接连接 Linkly
    AI，无需远程隧道，延迟更低。日常工作中随时问「我关于 XX
    记录过什么？」，Linkly AI 的 `search`
    工具即刻检索你计算机中的所有笔记，响应更快。
  </Accordion>

  <Accordion title="深度分析本地长文档">
    Claude 擅长处理超长文本。通过 Linkly AI 的 `outline`
    工具先查看书稿、报告的目录结构，再用 `read`
    精读关键章节，比直接全文粘贴效率高得多，也不会触碰上下文长度限制。
  </Accordion>

  <Accordion title="与其他本地 MCP 服务器协同">
    Claude Desktop 支持同时连接多个 MCP 服务器。Linkly AI 可以和文件系统
    MCP、数据库 MCP 等协同工作，让 Claude
    在一次对话中同时访问你的知识库、本地文件和其他数据源，完成更复杂的任务。
  </Accordion>
</AccordionGroup>

## 前置条件

* 已安装 [Claude Desktop](https://claude.ai/download)（Claude Cowork 即 Claude Desktop，需要 Claude Pro 或更高订阅）
* Linkly AI Desktop 已启动，MCP 服务正在运行

## 配置步骤

<Tabs>
  <Tab title="MCP HTTP（推荐）" icon="globe">
    <Steps>
      <Step title="打开配置文件">
        在 Claude 菜单中，选择 **Settings → Developer → Edit Config**，打开
        `claude_desktop_config.json`。
      </Step>

      <Step title="添加 Linkly AI MCP">
        在 `mcpServers` 对象中添加以下配置：

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "url": "http://127.0.0.1:60606/mcp"
            }
          }
        }
        ```
      </Step>

      <Step title="重启 Claude">
        保存文件后，完全退出并重新启动 Claude Desktop（菜单 → Quit Claude）。
      </Step>
    </Steps>
  </Tab>

  <Tab title="MCP Stdio" icon="terminal">
    需要先[安装 Linkly AI CLI](/docs/zh/use-cli)。

    <Steps>
      <Step title="打开配置文件">
        在 Claude 菜单中，选择 **Settings → Developer → Edit Config**，打开
        `claude_desktop_config.json`。
      </Step>

      <Step title="添加 Linkly AI MCP">
        在 `mcpServers` 对象中添加以下配置：

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "command": "linkly",
              "args": ["mcp"]
            }
          }
        }
        ```
      </Step>

      <Step title="重启 Claude">
        保存文件后，完全退出并重新启动 Claude Desktop（菜单 → Quit Claude）。
      </Step>
    </Steps>
  </Tab>

  <Tab title="远程访问" icon="globe">
    需要先完成[远程访问配置](/docs/zh/use-in-remote)，桌面端隧道显示{" "}

    <Badge stroke color="green">
      ● 已连接
    </Badge>

    。

    <Steps>
      <Step title="打开 Connectors 设置">
        在 Claude 菜单中，选择 **Settings → Connectors**，点击 **Add custom
        connector**。
      </Step>

      <Step title="填写端点信息">
        * Name：`Linkly AI` - URL：`https://mcp.linkly.ai/mcp`
      </Step>

      <Step title="完成 OAuth 授权">
        添加后会自动跳转到 linkly.ai 进行 OAuth 授权。登录并确认授权后，返回 Claude
        即可使用。
      </Step>
    </Steps>
  </Tab>
</Tabs>

<Tip>
  建议同时安装 [Linkly AI Skills](/docs/zh/use-skills)，教会 AI 助手如何高效地使用
  Linkly AI 的工具，提升搜索和阅读效率。
</Tip>

## 开始使用

配置完成后，在 Claude Cowork 的对话中直接提问，Claude 会自动调用 Linkly AI
的工具来搜索和阅读你的本地文档。例如：

* "搜索我的文档中关于项目设计的内容"
* "读一下我的需求文档并帮我总结要点"

## 常见问题

<AccordionGroup>
  <Accordion title="重启后找不到 Linkly AI 工具">
    请确认：1. 配置文件 JSON 格式正确（可用 JSON 校验工具检查） 2. Claude
    已**完全退出**并重启（不仅是关闭窗口，需从菜单退出） 3. Linkly AI Desktop
    已启动，MCP 服务正在运行
  </Accordion>

  <Accordion title="Stdio 方式提示找不到 linkly 命令">
    请确保已[安装 Linkly AI CLI](/docs/zh/use-cli)，并且 `linkly` 命令在 PATH
    中可用。可在终端运行 `linkly --version` 验证安装。
  </Accordion>
</AccordionGroup>