如何将 Nextcloud 文件连接到 Cursor

Cursor 中的 Nextcloud 文件

简短回答： 将你的 Nextcloud 作为 File Search 连接器添加到 AnythingMCP，通过 WebDAV 使用应用专用密码。AnythingMCP 会为你选择的文件夹建立全文索引，并保持索引同步。然后将 AnythingMCP 连接到 Cursor。Cursor 可以按文件名和内容查找文件，读取所需的页面，并把文件本身以附件或临时下载链接的形式提供给你。系统不会向你的 Nextcloud 写入任何内容。

AI 助手无法自行打开你的 Nextcloud；即使可以，为了回答一个问题它也得下载每一个文件。正是索引，让"当前价格表中商品 NT-601 的价格是多少？"这样的问题几秒钟就能得到答案。

你需要准备什么

• Nextcloud 的 WebDAV 地址：https://YOUR-HOST/remote.php/dav/files/USER/。
• 该用户的应用专用密码（设置 → 安全 → 设备与会话），切勿使用账户密码。给它起个名字，例如 AnythingMCP，这样就可以单独撤销它。
• 一个对你希望可搜索的文件夹拥有读取权限的用户。AnythingMCP 看到的内容与该用户看到的完全一致。
• 一个 AnythingMCP 工作区：AnythingMCP Cloud（免费试用 7 天）或你自己自托管的安装。

AnythingMCP 还提供用于 Nextcloud API 的 Nextcloud 连接器：用户、群组、共享、服务器状态。它不会读取文件内部的内容，这是 File Search 的工作。如果两者都需要，可以同时使用。Hetzner Storage Share 等托管型 Nextcloud 服务的用法相同。

设置步骤

第 1 步 — 设置 File Search 连接器

在 AnythingMCP 中打开 Marketplace，选择 Nextcloud (File Search)：它会打开 File Search 向导，并预置 Nextcloud 的设置。（或者打开 Connectors → New → File Search，选择 WebDAV 和 Nextcloud 快捷选项。）

1. 连接。 输入 WebDAV 地址、用户名和应用专用密码，以及要使用的文件夹，例如 Documents/Projects。
2. 测试。 在保存任何内容之前，AnythingMCP 会先连接、登录并列出该文件夹，然后显示检查清单（地址、可达性、加密、服务器身份、登录、文件夹），并在某一步失败时告诉你该如何修复。
3. 扫描。 点击 Scan folder。AnythingMCP 会列出文件夹内容但暂不建立索引，并显示一棵树，包含每个子文件夹的文件数量、文件类型和年份。看起来像归档的文件夹（Alt、Old、Archive、Backup）默认已取消勾选，因此 Cursor 不会引用过时的文档。在你勾选文件夹、文件类型或设置时间上限时，一个进度条会将你的选择与你的套餐进行对比；当所选内容超出套餐限制时，请取消勾选更多内容或升级套餐。
4. 描述。 AnythingMCP 会根据扫描结果起草连接器的描述，例如"销售团队的项目文件夹，报价单和验收报告，PDF 和 Word，2021–2026"。这段文字告诉 Cursor 该文件夹包含什么内容，以及何时应当搜索它。如果服务器上配置了 AI 模型，向导可以用 AI 起草描述，并明确说明会发送哪些内容（文件夹名、文件名、最多 20 个示例文件各自的前 2,000 个字符，个人数据已被屏蔽）；否则将根据文件夹结构生成草稿。你可以随意编辑。
5. 激活。 选择工具前缀、同步间隔以及要接入该连接器的 MCP 服务器，然后点击 Activate。

首次同步会立即开始，并在独立的后台服务中运行：同步期间，Cursor 和你的其他连接器仍会全速响应。连接器的 Files 标签页会显示进度：已发现、已索引和已跳过的文件、上次和下次同步时间，以及一个 Sync now 按钮。

第 2 步 — 复制服务器 URL

在 MCP Servers 中，打开你在向导中选择的服务器并复制其 URL。

第 3 步 — 在 Cursor 中添加连接器

你的服务器 URL： 在 AnythingMCP 中打开 MCP Servers → 该连接器所在的服务器，并复制其 URL（https://cloud.anythingmcp.com/mcp/…）。本指南中出现 YOUR_SERVER_ID 的地方都使用它。

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目：

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. 在 AnythingMCP 的 MCP Servers → 你的服务器 → API keys 下创建一个 MCP API 密钥，并粘贴到 YOUR_MCP_API_KEY 的位置。
2. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP，确认 anythingmcp 已列出且处于已连接状态。
4. 开始聊天：智能体现在可以调用文件搜索工具了。

第 4 步 — 提问

开启一个新对话，询问关于文件内容的问题。Cursor 会先搜索索引，打开匹配的页面，并在回答中给出文件名、页码和文件日期，方便你核对来源。

Cursor 可以用这些文件做什么

<prefix> 是你在向导中选择的工具前缀，例如 pricelists。除 _share_file 外，所有工具都只读。

支持的文件： 可从 100 多种文件类型中提取文本：PDF（逐页）；Word、Excel 和 PowerPoint，包括宏和模板变体以及 .xlsb；OpenDocument；Outlook 的 .msg、.eml 和 .mbox，包括其附件的文本；.rtf、.epub、.xps；Apple Pages、Numbers 和 Keynote（通过其 PDF 预览）；.svg 以及 .dxf CAD 图纸的文本；CSV、Markdown、HTML、XML、JSON、YAML、日历和联系人；以及源代码。其他所有文件仍可按文件名找到，PDF 页面和图片也可以作为图片展示给 AI。没有文本层的扫描版 PDF 可在 Enterprise 套餐中通过 OCR 读取。

在 Cursor 中试试这些提示词

• "找出我们发给 Kessler 的仓库屋顶报价单，并总结其中的价格项目。"
• "哪些项目文件夹中包含今年签署的验收报告？"
• "在会议纪要中搜索关于新 ERP 的决定，并连同日期一起列出。"
• "把员工手册的最新版本以下载链接的形式发给我。"

同步的工作原理

Nextcloud 通过 WebDAV 为每个文件报告一个变更标记（ETag）。AnythingMCP 将其与上次运行时的标记进行比较，只下载新增和已更改的文件。内容与已索引版本相同的文件会通过校验和（SHA-256）被识别，不会再次处理。已删除的文件会从索引中移除。无法读取的文件会在接下来的同步中重试，失败三次后（受密码保护的文件则立即）仍可按文件名找到，原因会显示在 Files 标签页中。

同步在独立的后台服务中运行，与响应 Cursor 的服务器分开：大规模的首次同步不会拖慢你的提问，同步期间搜索也会继续使用最近一次的索引。

当文件夹超出你的套餐限制时，同步会在下载任何内容之前暂停，而不是只索引一部分：Files 标签页会显示该文件夹目前的文件数与你套餐上限的对比，Cursor 会继续搜索已索引的文件，并被告知较新的文件可能缺失，而你可以取消勾选文件夹或升级套餐。暂停的文件夹每天会重新检查一次，一旦符合限制就会自动恢复。

安全

• 只读。 连接器只列出和读取。它没有任何会在你的 Nextcloud 上写入、重命名或删除的工具。
• 仅限你的工作区。 索引按工作区存储，每次查询都被限制在该工作区内，由应用程序和数据库（Row-Level Security）双重保证。
• 凭据以加密形式存储，仅在后台同步服务中解密。Cursor 和你的同事永远看不到它们。
• 谁能看到什么取决于你的 MCP 角色：没有文件工具权限的角色看不到这些工具。在 Enterprise 套餐中，你还可以按角色允许或拒绝特定文件夹。
• 文件内容就是数据。 这些工具会告诉模型，永远不要遵循文件内部出现的指令。
• 应用专用密码。 它可以在 Nextcloud 中单独撤销，而无需更改账户密码。
• 遵循共享设置。 AnythingMCP 看到的就是所连接用户看到的内容：只把应该可搜索的内容共享给该用户。
• AnythingMCP Cloud 只连接公共互联网上的服务器：私有网络中的主机会被拒绝，重定向之后也是如此。位于你办公网络中的服务器必须能从外部访问，或者你在其旁边自托管运行 AnythingMCP。

各套餐的限制

自托管：Starter 包含一个最多 500 个文件的 File Search 连接器，Team 包含三个连接器和 2,000 个文件，Enterprise 没有限制，同步间隔最短可达每 5 分钟；最大文件由 FILES_MAX_FILE_BYTES 设定（默认 100 MB）。自托管的 File Search 需要付费许可证或 30 天试用（其限制与 Team 相同）；免费的 Community 版在试用结束后没有 File Search。查看所有套餐。

常见问题

Cursor 的免费版支持自定义 MCP 服务器吗？ 支持，Hobby、Pro 和 Business 套餐都提供 MCP。

为什么用应用专用密码，而不是我的 Nextcloud 密码？ 应用专用密码可以单独撤销，无需更改账户密码。AnythingMCP 中的 Nextcloud 说明要求使用应用专用密码，绝不使用账户密码。

这与 Nextcloud 连接器有什么区别？ Nextcloud 连接器与 Nextcloud API 对接：用户、群组、共享、服务器状态。File Search 连接器则对你文件的内容建立索引并进行搜索。

我们的 Nextcloud 只能在办公网络中访问。 AnythingMCP Cloud 需要它能通过 HTTPS 从互联网访问。自托管的 AnythingMCP 在管理员把该主机添加到出站白名单后即可访问（Admin → Settings 或 SSRF_ALLOWED_HOSTS）。

AnythingMCP 会复制你的整个 Nextcloud 吗？ 不会。AnythingMCP 保存的是提取出的文本，而不是文件。只有在文件发生变化，或你要求获取文件本身时，才会再次读取该文件。

会使用向量搜索吗？ 不会。公司文档搜索的是精确的名称、编号和数字，在这种场景下，带页面级结果的关键词搜索比嵌入向量更可靠。

相关内容

• 用 AI 搜索公司文件服务器
• 用 AI 在供应商价格表中查找价格
• 用 AI 搜索 Nextcloud 和 WebDAV 文件内部
• 将 AI 聊天中的文件以下载链接形式分享
• 将 Nextcloud 文件连接到 Claude
• 将 Nextcloud 文件连接到 ChatGPT
• 将 Nextcloud 文件连接到 Gemini
• 将 Nextcloud 文件连接到 Microsoft Copilot
• 将 Nextcloud 文件连接到 Muse
• Cursor 中的其他文件来源：SFTP 服务器、FTP / FTPS 服务器、WebDAV 服务器、S3 存储桶、ownCloud、Synology NAS、QNAP NAS、Fritz!Box 存储、Hetzner Storage Box、网络文件夹（自托管）