如何将 Nextcloud 文件连接到 Muse

Muse 中的 Nextcloud 文件

简短回答: 通过 WebDAV 和应用密码,把你的 Nextcloud 作为 File Search 连接器添加到 AnythingMCP。AnythingMCP 会为你选定的文件夹建立全文索引,并保持索引同步。然后将 AnythingMCP 连接到 Meta Muse。Muse 可以按文件名和内容查找文件,读取所需的页面,并把文件本身以附件或临时下载链接的形式交给你。你的 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):它会打开带有 Nextcloud 设置的 File Search 向导。(或者打开 Connectors → New → File Search,选择 WebDAV 和 Nextcloud 快捷方式。)

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

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

第 2 步 — 复制服务器 URL

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

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

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

Muse 以自定义连接器的形式添加远程 MCP 服务器,并通过 OAuth 登录。

1. 在 Muse 中打开 设置 → 连接器,选择 添加自定义连接器。
2. 粘贴 MCP 服务器 URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。
3. Muse 会打开 AnythingMCP 登录页面:登录并批准访问。
4. 在聊天中,向 Muse 提出需要用到文件搜索工具的问题。

你也可以在聊天中完成设置,无论是网页版、iOS 和 Android 应用还是 WhatsApp。把下面这条消息发送给 Muse:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

自托管?请使用你实例的公网 HTTPS 地址代替 https://cloud.anythingmcp.com。Muse 从 Meta 的云端发起连接,因此 localhost 无法使用。

第 4 步 — 提问

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

Muse 能对文件做什么

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

在 Muse 中可以尝试的提示词

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

同步的工作原理

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

同步在独立的后台服务中运行,与响应 Muse 的服务器分离:首次大规模同步不会拖慢你的提问,同步期间搜索仍使用最近一次的索引正常工作。

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

安全

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

各套餐的限制

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

常见问题

Muse 在哪些地区可用? Meta 目前在美国和加拿大提供 Muse,支持网页版、iOS 和 Android 应用以及 WhatsApp。

Meta 会审核这个连接器吗? 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为该 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 文件连接到 Cursor
• Muse 中的其他文件来源:SFTP 服务器、FTP / FTPS 服务器、WebDAV 服务器、S3 存储桶、ownCloud、Synology NAS、QNAP NAS、Fritz!Box 存储、Hetzner Storage Box、网络文件夹(自托管)