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

# 在 Dify 中使用 Linkly AI

> 将 Linkly AI 本地知识库集成到 Dify AI 应用开发平台，增强 AI 应用的文档检索能力

## 可以用来做什么

<AccordionGroup>
  <Accordion title="搭建基于私有文档的问答机器人">
    无需将文档上传到 Dify，通过 MCP 接入 Linkly AI，让 Dify 的 Agent 用 `search`
    工具实时检索存储在你计算机中的文档，快速构建面向团队的内部知识问答助手。
  </Accordion>

  <Accordion title="本地知识库作为动态数据源，内容始终最新">
    与 Dify 内置的向量知识库不同，Linkly AI
    直接读取本地文件，文档更新后无需重新索引，Agent
    每次检索都获取到最新内容，始终与你的计算机保持同步。
  </Accordion>

  <Accordion title="组合三个工具构建多层次文档处理应用">
    利用 Dify 的可视化界面，将 Linkly AI 的
    `search`（检索）、`outline`（大纲）、`read`（精读）三个工具串联起来，快速搭建层次分明的文档摘要、问答或内容提取应用原型。
  </Accordion>
</AccordionGroup>

## 前置条件

* 已安装并运行 [Dify](https://dify.ai)
* Linkly AI Desktop 已启动，MCP 服务正在运行

## 配置步骤

根据你的 Dify 部署位置，选择对应的访问模式：

<Tabs>
  <Tab title="同一台电脑" icon="computer">
    Dify 和 Linkly AI 运行在同一台电脑上时，直接使用本机地址：

    在 Dify 中添加 MCP 工具，配置：

    * URL：`http://127.0.0.1:60606/mcp`
    * 无需额外鉴权

    <Tip>
      如果 Dify 运行在 Docker 容器中，`127.0.0.1` 指向容器自身。你需要使用宿主机 IP 或 `host.docker.internal` 来访问本机的 Linkly AI。
    </Tip>
  </Tab>

  <Tab title="局域网" icon="wifi">
    Dify 运行在局域网内的其他设备上时：

    1. 在 Linkly AI Desktop 中开启「局域网访问」
    2. 复制局域网 URL 和访问令牌
    3. 在 Dify 中添加 MCP 工具，配置：
       * URL：`http://192.168.x.x:60606/mcp`（使用你的实际局域网 IP）
       * Header：`Authorization: Bearer <你的访问令牌>`
  </Tab>

  <Tab title="云端" icon="globe">
    Dify 部署在云端（如 Dify Cloud）时：

    1. 完成[远程访问配置](/docs/zh/use-in-remote)
    2. 在 Dify 中添加 MCP 工具，配置：
       * URL：`https://mcp.linkly.ai/mcp`
       * Header：`Authorization: Bearer <你的 API Key>`
  </Tab>
</Tabs>

## 应用示例

配置完成后，你可以在 Dify 中构建各种 AI 应用，利用 Linkly AI 提供的文档检索能力，例如：

* 基于私有文档的问答机器人
* 文档摘要生成器
* 智能文档搜索助手

## 常见问题

<AccordionGroup>
  <Accordion title="Dify 无法连接 Linkly AI">
    请根据你的部署方式检查： - **同一台电脑**：确认 Linkly AI MCP
    服务正在运行。如果 Dify 在 Docker 中，使用 `host.docker.internal` 替代
    `127.0.0.1` - **局域网**：确认已开启局域网访问，访问令牌正确 -
    **云端**：确认隧道已连接，API Key 正确
  </Accordion>
</AccordionGroup>