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

# 在 QwenPaw 中使用 Linkly AI

> 将 Linkly AI 本地知识库接入 QwenPaw 智能体，让 AI 搜索和阅读你的私有文档

## 可以用来做什么

<AccordionGroup>
  <Accordion title="让智能体在任务执行中随时检索本地文档">
    QwenPaw 支持通过 MCP 扩展工具能力。接入 Linkly AI
    后，智能体在规划和执行任务时可以随时搜索你计算机中的文档，将本地知识与在线信息结合，提升输出质量。
  </Accordion>

  <Accordion title="结合计划模式利用本地资料">
    在 QwenPaw 的计划模式下，让智能体先通过 Linkly AI
    检索相关文档，再制定详细执行计划，确保方案建立在你真实的私有资料之上。
  </Accordion>

  <Accordion title="多智能体共享同一套本地知识库">
    QwenPaw 支持配置多个独立智能体，接入 Linkly AI
    后，每个智能体都可访问同一套本地文档，无需为不同智能体重复配置知识来源。
  </Accordion>
</AccordionGroup>

## 前置条件

* 已安装 [QwenPaw](https://qwenpaw.agentscope.io/downloads)
* Linkly AI Desktop 已启动，MCP 服务正在运行

## 配置步骤

<Tabs>
  <Tab title="本地 MCP HTTP（推荐）" icon="globe">
    <Steps>
      <Step title="打开 MCP 配置">
        打开 QwenPaw 控制台，进入 **智能体 → MCP**，点击 **+ 创建**。
      </Step>

      <Step title="粘贴配置并创建">
        在弹窗中粘贴以下 JSON，然后点击**创建**：

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

  <Tab title="远程 MCP" icon="cloud">
    需要先完成[远程访问配置](/zh/use-in-remote)，桌面端隧道显示 <Badge stroke color="green">● 已连接</Badge>。

    <Steps>
      <Step title="打开 MCP 配置">
        打开 QwenPaw 控制台，进入 **智能体 → MCP**，点击 **+ 创建**。
      </Step>

      <Step title="粘贴远程配置并创建">
        在弹窗中粘贴以下 JSON，然后点击**创建**：

        ```json theme={null}
        {
          "mcpServers": {
            "linkly-ai": {
              "transport": "streamable_http",
              "url": "https://mcp.linkly.ai/mcp"
            }
          }
        }
        ```
      </Step>
    </Steps>
  </Tab>

  <Tab title="CLI Stdio（备选）" icon="terminal">
    需要先[安装 Linkly AI CLI](/zh/use-cli)，且本地已安装 Node.js 18+。

    <Steps>
      <Step title="打开 MCP 配置">
        打开 QwenPaw 控制台，进入 **智能体 → MCP**，点击 **+ 创建**。
      </Step>

      <Step title="粘贴 CLI 配置并创建">
        在弹窗中粘贴以下 JSON，然后点击**创建**：

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

## 开始使用

配置完成后，在 QwenPaw 对话中直接提问，智能体会自动调用 Linkly AI 的工具搜索和阅读你的本地文档。

示例：

* "搜索我的文档中关于 XX 的内容"
* "帮我找一下本地笔记里有没有关于 YY 的记录，并做个总结"

## 常见问题

<AccordionGroup>
  <Accordion title="创建后工具未生效">
    进入 **智能体 → MCP** 页面，确认 linkly-ai 客户端的启用开关已打开。同时检查
    Linkly AI Desktop 是否正在运行、MCP 服务是否显示 Running。
  </Accordion>

  <Accordion title="CLI 方式报错 command not found">
    确认已正确安装 Linkly AI CLI（`linkly --version` 验证），以及 Node.js 版本 ≥
    18（`node --version` 确认）。
  </Accordion>

  <Accordion title="一次可以导入多个 MCP 配置吗">
    可以。QwenPaw 支持在一个 JSON 中的 `mcpServers` 对象里同时配置多个 MCP
    客户端，一次点击创建即可批量导入。
  </Accordion>
</AccordionGroup>