如何将 Nextcloud 文件连接到 Claude

在 Claude 中使用 Nextcloud 文件

简短回答： 将你的 Nextcloud 作为 File Search 连接器添加到 AnythingMCP，通过 WebDAV 使用应用专用密码。AnythingMCP 会为你选定的文件夹建立全文索引，并保持索引同步。然后将 AnythingMCP 连接到 claude.ai、Claude 桌面应用和 Claude Code。Claude 可以按文件名和内容查找文件，读取所需的页面，并把文件本身交给你，可以作为附件，也可以是临时下载链接。系统不会向你的 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 中打开应用市场，选择 Nextcloud (File Search)：它会打开带有 Nextcloud 设置的 File Search 向导。（或者打开 Connectors → New → File Search，选择 WebDAV 和 Nextcloud 快捷方式。）

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

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

步骤 2 — 复制服务器 URL

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

步骤 3 — 在 Claude 中添加连接器

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

推荐方式：可在 claude.ai 网页版使用，无需编辑任何配置文件。

1. 在 Claude 中打开 Customize → Connectors。
2. 点击 +，然后点击 Add custom connector。
3. 输入名称，例如 Nextcloud files，以及远程 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID，然后点击 Add。
4. 点击 Connect，并登录 AnythingMCP（OAuth）以授予访问权限。

同一个连接器也会出现在 Claude 桌面应用中。在 Claude Code 中：claude mcp add --transport http anythingmcp https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID --header "X-API-Key: <your MCP API key>"。

步骤 4 — 提问

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

Claude 可以用这些文件做什么

<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 读取。

可以在 Claude 中试试的提示词

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

同步的工作原理

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

同步运行在独立的后台服务中，与回答 Claude 的服务器分开：大规模的首次同步不会拖慢你的提问，同步期间搜索仍会使用上一次的索引正常工作。

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

安全性

• 只读。 连接器只列出和读取。它没有任何会在你的 Nextcloud 上写入、重命名或删除的工具。
• 仅限你的工作区。 索引按工作区存储，每次查询都限定在其中，由应用程序和数据库（Row-Level Security）双重保证。
• 凭据加密存储，仅在后台同步服务中解密。Claude 和你的同事都看不到它们。
• 谁能看到什么取决于你的 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。查看所有套餐。

常见问题

Claude 免费版可以用吗？ 可以。免费版可以添加一个自定义连接器，无论你在服务器上放了多少个连接器，AnythingMCP 都只算一个。

为什么用应用专用密码，而不是我的 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 文件连接到 ChatGPT
• 将 Nextcloud 文件连接到 Gemini
• 将 Nextcloud 文件连接到 Microsoft Copilot
• 将 Nextcloud 文件连接到 Cursor
• 将 Nextcloud 文件连接到 Muse
• Claude 中的其他文件来源：SFTP 服务器、FTP / FTPS 服务器、WebDAV 服务器、S3 存储桶、ownCloud、Synology NAS、QNAP NAS、Fritz!Box 存储、Hetzner Storage Box、网络文件夹（自托管）