如何将网络文件夹或 Windows 文件服务器连接到 Muse

Muse 中的网络文件夹

仅限自托管。 网络文件夹仅存在于自托管的 AnythingMCP 中。在 AnythingMCP Cloud 上,请改用 SFTP 或 WebDAV 访问 NAS。

简短回答: 将共享以只读方式挂载到运行你的自托管 AnythingMCP 的服务器上,然后把该文件夹添加为 File Search 连接器。AnythingMCP 会为每个受支持的文件建立全文索引并保持索引同步,文件不会离开你的网络。然后将 AnythingMCP 连接到 Meta Muse。Muse 可以按文件名和内容查找文件,读取所需的页面,并把文件本身以附件或临时下载链接的形式交给你。共享上不会写入任何内容。

AI 助手无法自行打开网络驱动器,即使可以,也得下载每个文件才能回答一个问题。有了索引,像"当前价格表中 NT-601 号商品的价格是多少?"这样的问题只需几秒钟即可得到答案。

你需要准备什么

• 一个自托管 AnythingMCP,拥有付费许可证或 30 天试用。AnythingMCP Cloud 无法访问网络共享:SMB(端口 445)不应暴露在互联网上。
• 在 Docker 主机上以只读方式挂载的共享,例如挂载到 /mnt/knowledge(SMB/CIFS 或 NFS,Windows 文件服务器或 NAS 卷均可)。
• 对 Docker 主机的 Shell 访问权限,用于编辑 .env 和 docker-compose.yml。

设置步骤

步骤 1 — 挂载共享并启用 File Search

1. 在 Docker 主机上以只读方式挂载共享,例如挂载到 /mnt/knowledge。
2. 将其以只读方式绑定到 app 和 files-worker 容器中(参见 docker-compose.yml 中的注释),并在 .env 中设置 FILE_SOURCE_ROOTS=/mnt/knowledge。向导只会提供这些根目录之下的文件夹。
3. 启用 File Search 服务:在 .env 中添加 FILES_WORKER_URL=http://files-worker:8891、FILES_WORKER_TOKEN 和 FILE_EXTRACTOR_TOKEN(各通过 openssl rand -hex 24 生成)以及 COMPOSE_PROFILES=files。
4. 运行 docker compose up -d。Connectors → New → File Search 会显示 worker 和提取器是否可达。

File Search 文档列出了所有设置。

步骤 2 — 设置 File Search 连接器

在 AnythingMCP 中,打开 Connectors → New → File Search,选择 Network folder(在 Marketplace 中为 Network folder (File Search))。

1. 文件夹。 选择 FILE_SOURCE_ROOTS 之下的文件夹,例如 /mnt/knowledge/Purchasing。
2. 测试。 在保存任何内容之前,AnythingMCP 会列出该文件夹,并显示是否可读。
3. 扫描。 点击 Scan folder。AnythingMCP 会列出文件夹内容但暂不建立索引,并显示一棵树,包含每个子文件夹中的文件数量、文件类型和年份。看起来像归档的文件夹(Alt、Old、Archive、Backup)默认已取消勾选,这样 Muse 就不会引用过时的文档。在你勾选文件夹、文件类型或设置时间上限的同时,一个进度条会将你的选择与你的套餐进行对比;当所选内容超出套餐时,请取消勾选更多内容或升级套餐。
4. 描述。 AnythingMCP 会根据扫描结果起草连接器的描述,例如"采购共享:供应商价格表与条件,PDF 和 Excel,德语,2019–2026"。这段文字告诉 Muse 该文件夹包含什么内容以及何时应搜索它。如果服务器上配置了 AI 模型,向导可以借助 AI 起草描述,并明确说明会发送哪些内容(文件夹名称、文件名、最多 20 个示例文件的前 2,000 个字符,个人数据已脱敏);否则草稿将根据文件夹结构生成。你可以随意编辑。
5. 激活。 选择工具前缀、同步间隔以及使用该连接器的 MCP 服务器,然后点击 Activate。

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

步骤 3 — 复制服务器 URL

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

步骤 4 — 在 Muse 中添加连接器

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

Muse 是从 Meta 的云端而不是你的电脑连接到 MCP 服务器的,因此你的 AnythingMCP 需要一个公网 HTTPS 地址。仓库中的 ./setup.sh 会设置域名、HTTPS 和 OAuth(部署指南)。本步骤中出现 https://anythingmcp.example.com 的地方,请使用该地址;文件本身仍保留在你的服务器上。

Muse 将远程 MCP 服务器添加为自定义连接器,并通过 OAuth 登录。

1. 在 Muse 中,打开 Settings → Connectors,选择 Add custom connector。
2. 粘贴 MCP 服务器 URL https://anythingmcp.example.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://anythingmcp.example.com/mcp/YOUR_SERVER_ID
Auth: OAuth

步骤 5 — 提问

开启一个新对话,询问文件内容相关的问题。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 中试试这些提示词

• "找到 Nordtor 的当前价格表,告诉我 NT-601 875 x 2000 的价格。"
• "共享中的哪些文档提到了三个月的通知期?"
• "在 Purchasing 文件夹中搜索商品编号 4711-200,并显示它出现的每一行。"
• "我们的内部流程对超过 30 天的退货是怎么规定的?请引用该段落和文件。"

同步的工作原理

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

同步在独立的后台服务中运行,与回答 Muse 请求的服务器分开:大规模的首次同步不会拖慢你的提问,同步进行期间搜索仍会使用上一次的索引继续工作。

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

安全

• 只读。 连接器只列出和读取。它没有任何会在共享上写入、重命名或删除的工具。
• 仅限你的工作区。 索引按工作区存储,每次查询都被限制在其中,由应用程序和数据库(行级安全,Row-Level Security)双重保证。
• 文本提取器运行在没有外部路由的内部网络中,没有数据库,也没有任何密钥。
• 谁能看到什么取决于你的 MCP 角色:没有文件工具权限的角色看不到这些工具。在 Enterprise 版中,你还可以按角色允许或拒绝特定文件夹。
• 文件内容仅是数据。 工具会告知模型永远不要执行在文件中发现的指令。
• 文件留在你的网络中。 只有工具针对某个问题返回的内容(匹配列表、某一页的文本)才会传送给你所使用的 AI 提供商。
• 双重只读。 在主机上以只读方式挂载共享,并以只读方式绑定到容器中。

各套餐的限制

最大文件大小由 FILES_MAX_FILE_BYTES 设置(默认 100 MB)。File Search 需要付费许可证(Starter、Team 或 Enterprise)或 30 天试用;免费的 Community 版在试用结束后没有 File Search。所有套餐。

常见问题

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

Meta 会审核此连接器吗? 不会。Meta 不审核自定义连接器。Muse 只能看到你在 AnythingMCP 中为此 MCP 服务器启用的工具,你可以随时在 Settings → Connectors 下断开连接。

为什么 AnythingMCP Cloud 上无法使用? Cloud 通过互联网访问文件,而 SMB(端口 445)不应暴露在互联网上。对于 Cloud,请在 NAS 上使用 SFTP 或 WebDAV,或者将 AnythingMCP 自托管在共享旁边。

需要自托管的 Enterprise 套餐吗? 不需要。Starter 包含一个最多 500 个文件的 File Search 连接器,Team 包含三个、最多 2,000 个文件。Enterprise 取消了限制,并增加了 OCR、按角色的文件夹权限和工作区策略。

AnythingMCP 会复制整个共享吗? 不会。AnythingMCP 保存的是提取出的文本,而不是文件。只有当文件发生变化,或者你请求文件本身时,才会再次读取该文件。

会使用向量搜索吗? 不会。公司文档需要按精确的名称、代码和数字来搜索,在这种场景下,带页面级结果的关键词搜索比嵌入向量更可靠。

相关内容

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