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

# 在 QoderWork 中使用 Linkly AI

> 将 Linkly AI 本地知识库接入 QoderWork，让桌面 AI 工作助手搜索和阅读你的私有文档

## 可以用来做什么

<AccordionGroup>
  <Accordion title="配合自动化任务检索本地资料">
    在 QoderWork 创建任务时，通过 Linkly AI Connector 让 AI
    先检索本地文档，再结合浏览器自动化、文件处理等工具，完成包含真实资料的复杂工作流。
  </Accordion>

  <Accordion title="多 Connector 协同工作">
    将 Linkly AI 与 Slack、Microsoft 365、Calendar 等 Connector
    组合使用，在同一个任务中同时访问本地文档和在线服务，打通信息孤岛。
  </Accordion>

  <Accordion title="无需重复上传文档">
    一次配置，在 QoderWork 的所有任务和对话中共享同一套本地知识库。AI
    按需检索，无需每次手动上传附件。
  </Accordion>
</AccordionGroup>

## 前置条件

* 已安装 [QoderWork](https://www.qoderwork.com)
* Linkly AI Desktop 已启动，MCP 服务正在运行

## 配置步骤

<Tabs>
  <Tab title="本地 MCP HTTP（推荐）" icon="globe">
    <Steps>
      <Step title="打开 Connectors 页面">
        在左侧导航栏点击 **Extensions → Connectors**。

        <img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/qoderwork-connectors.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=fa54deb63b8e5ab0e75819441cea5772" alt="QoderWork Connectors 页面" width="2712" height="1672" data-path="images/qoderwork-connectors.webp" />
      </Step>

      <Step title="添加新连接器">
        点击右上角 **+ Add**，在下拉菜单中选择 **Fill in Config Manually**。

        <img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/qoderwork-add-menu.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=a69a3a4730661697237d3b8a86e8b312" alt="选择 Fill in Config Manually" width="2712" height="1672" data-path="images/qoderwork-add-menu.webp" />
      </Step>

      <Step title="填写配置并添加">
        在 **Add MCP Server** 弹窗中填写以下信息：

        * **Server Type**：`Streamable HTTP`
        * **Server Name**：`linkly-ai`
        * **Server URL**：`http://127.0.0.1:60606/mcp`

        点击 **Add** 完成添加。

        <img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/qoderwork-http-local.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=2bcf000ac03e113422a28efa0307453e" alt="填写 Streamable HTTP 本地配置" width="2712" height="1672" data-path="images/qoderwork-http-local.webp" />
      </Step>
    </Steps>
  </Tab>

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

    <Steps>
      <Step title="打开 Connectors 页面">
        在左侧导航栏点击 **Extensions → Connectors**。
      </Step>

      <Step title="添加新连接器">
        点击右上角 **+ Add → Fill in Config Manually**。
      </Step>

      <Step title="填写远程配置并添加">
        在 **Add MCP Server** 弹窗中填写以下信息：

        * **Server Type**：`Streamable HTTP`
        * **Server Name**：`linkly-ai`
        * **Server URL**：`https://mcp.linkly.ai/mcp`

        点击 **Add** 完成添加。

        <img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/qoderwork-http-remote.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=a468129273f508c53266bf00ee2df57c" alt="填写 Streamable HTTP 远程配置" width="2712" height="1672" data-path="images/qoderwork-http-remote.webp" />
      </Step>
    </Steps>
  </Tab>

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

    <Steps>
      <Step title="打开 Connectors 页面">
        在左侧导航栏点击 **Extensions → Connectors**。
      </Step>

      <Step title="添加新连接器">
        点击右上角 **+ Add → Fill in Config Manually**。
      </Step>

      <Step title="填写 CLI 配置并添加">
        在 **Add MCP Server** 弹窗中填写以下信息：

        * **Server Type**：`STDIO`
        * **Command**：`linkly mcp`

        点击 **Add** 完成添加。

        <img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/qoderwork-stdio.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=da7e5da7aba7621b534e7b57f4d84b5f" alt="填写 STDIO CLI 配置" width="2712" height="1672" data-path="images/qoderwork-stdio.webp" />
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 在对话中启用

添加完成后，还需要在对话中手动开启连接器。在输入框工具栏点击插件图标，选择 **Connectors**，将 **linkly-ai** 的开关打开即可。

<img src="https://mintcdn.com/linklyai/PdV3hIc9lsrn2ArH/images/qoderwork-chat-toggle.webp?fit=max&auto=format&n=PdV3hIc9lsrn2ArH&q=85&s=799acb0bec2540e9f2ab7772ac43d791" alt="在聊天工具栏中启用 linkly-ai 连接器" width="2712" height="1672" data-path="images/qoderwork-chat-toggle.webp" />

## 常见问题

<AccordionGroup>
  <Accordion title="添加后在 Connectors 列表中找不到">
    切换到 Connectors 页面的 **Installed**
    标签页查看已安装列表。如仍不可见，尝试点击右上角刷新按钮。
  </Accordion>

  <Accordion title="远程 MCP 连接超时">
    请确认 Linkly AI Desktop
    的远程访问功能已开启，且桌面端隧道状态显示"已连接"。可在 Linkly AI
    设置页面的 MCP 分类中查看。
  </Accordion>

  <Accordion title="STDIO 方式报 command not found">
    确认已正确安装 Linkly AI CLI，在终端执行 `linkly --version` 验证。
  </Accordion>
</AccordionGroup>