连接器指南阅读约 4 分钟10 个 MCP 工具7 种语言

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

让 Claude 搜索挂载到自托管 AnythingMCP 中的 Windows 文件服务器、NAS 或网络共享(SMB/CIFS 或 NFS):对 PDF、Excel、Word 和 Outlook 文件建立全文索引,并在后台同步。仅限自托管。

HC作者:HelpCode 团队更新于 4 分钟阅读 在 GitHub 开源

开源 · AGPL-3.0 · 运行在您自己的服务器上

Network folder (File Search)

Network folder (File Search)

Search inside a Windows file server, NAS or network share mounted into a self-hosted AnythingMCP: full-text index of PDF, Excel, Word and Outlook files, synced in the background. Self-hosted only.

个工具

10

区域

INTL

类别

文件存储

身份验证

Local server

用 Docker 自托管

开源 · AGPL-3.0 · 运行在您自己的服务器上

  • 7 天免费试用
    无需信用卡
  • 符合 GDPR,SOC 2 就绪
    数据驻留欧盟,审计日志
  • 在 GitHub 开源
    开源 · AGPL-3.0
  • 支持 ChatGPT、Claude、Gemini
    任何兼容 MCP 的客户端

摘要

让 Claude 搜索挂载到自托管 AnythingMCP 中的 Windows 文件服务器、NAS 或网络共享(SMB/CIFS 或 NFS):对 PDF、Excel、Word 和 Outlook 文件建立全文索引,并在后台同步。仅限自托管。

试试这样问

Network folder (File Search) 的示例提示

点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。

Network folder (File Search) · 通过 MCP 实时
分享
Opus 4.7

Claude 是 AI,可能会出错。请核对回答。

Claude 中的网络文件夹

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

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

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

准备工作

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

设置步骤

  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 文档列出了所有设置项。

在 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)已默认取消勾选,这样 Claude 就不会引用过时的文档。在你勾选文件夹、文件类型或设置时间上限时,会有一个进度条将你的选择与套餐进行对比;当所选内容超出套餐限制时,请取消勾选更多内容或升级套餐。
  4. 描述。 AnythingMCP 会根据扫描结果起草连接器的描述,例如“采购共享:供应商价目表和条件,PDF 和 Excel,德语,2019–2026”。这段文字会告诉 Claude 文件夹里有什么以及何时应该搜索它。如果服务器上配置了 AI 模型,向导可以用 AI 起草描述,并会明确说明发送了哪些内容(文件夹名称、文件名、最多 20 个示例文件的前 2,000 个字符,个人数据已被屏蔽);否则草稿将根据文件夹结构生成。你可以随意编辑。
  5. 激活。 选择工具前缀、同步间隔以及使用该连接器的 MCP 服务器,然后点击 Activate。

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

步骤 3 — 复制服务器 URL

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

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

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

claude.ai 和 Claude 桌面应用是从 Anthropic 的云端而不是你的电脑连接自定义连接器的,因此你的 AnythingMCP 需要一个公网 HTTPS 地址。仓库中的 ./setup.sh 会配置域名、HTTPS 和 OAuth(部署指南)。在本步骤中出现 https://anythingmcp.example.com 的地方使用该地址;文件本身仍保留在你的服务器上。Claude Code 运行在你的电脑上,也可以使用你自己网络中的地址。

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

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

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

步骤 5 — 提问

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

Claude 能对这些文件做什么

工具功能
<prefix>_guide如何搜索此文件夹
<prefix>_search对所有已索引页面进行全文搜索:返回文件及其最佳页面、摘要和日期;可按文件夹、文件类型和日期筛选,也可按需让最新的排在前面
<prefix>_find按文件名(容错拼写错误)或模式查找文件
<prefix>_list显示一个文件夹:子文件夹及数量,文件及大小和日期
<prefix>_read以文本形式读取文件,可按页("1-3,7")或按字符窗口读取
<prefix>_grep精确搜索代码和数字,附带上下各两行内容;电子表格的行会附带其列名
<prefix>_status同步状态、数量、暂停原因以及内容摘要
<prefix>_view_page以图片形式显示 PDF 的某一页或图像文件:图纸、印章、照片以及文本无法捕获的表格
<prefix>_get_file将文件本身作为临时下载链接提供给工作区成员(图像也会作为附件)
<prefix>_share_file临时链接(内部或公开);安装时默认关闭

<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 中试试这些提示词

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

同步的工作原理

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

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

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

安全性

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

各套餐的限制

30 天试用StarterTeamEnterprise
File Search 连接器313无限制
已索引文件(所有连接器合计)2,0005002,000无限制
自动同步每日每日每日最短每 5 分钟
每日手动同步次数313无限制
OCR、按角色的文件夹权限、工作区策略–––✓

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

常见问题

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

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

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

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

是否使用向量搜索? 不使用。对公司文档的搜索针对的是精确的名称、代码和数字,在这类场景中,带页面级结果的关键词搜索比嵌入向量更可靠。

相关内容

这份指南对你有帮助吗?

你的 Network folder 智能体只差一次点击。

安装连接器,粘贴密钥,向 Claude 提问。免费试用 7 天,无需信用卡。

相关指南

企业

面向 AI 文件搜索的按角色文件夹权限:谁能在 Claude 和 ChatGPT 中看到哪些文件夹

让销售、采购和服务团队共用一个覆盖公司共享盘的 AI 文件搜索,同时让每个角色只能看到自己的文件夹。了解 AnythingMCP Enterprise 文件夹权限的工作方式(允许、拒绝、拒绝优先)、如何规划规则,以及不使用 Enterprise 时的替代方案。

连接器

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

让 ChatGPT 搜索挂载到自托管 AnythingMCP 中的 Windows 文件服务器、NAS 或网络共享(SMB/CIFS 或 NFS):对 PDF、Excel、Word 和 Outlook 文件建立全文索引,并在后台同步。仅限自托管。

连接器

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

让 Microsoft Copilot 在挂载到自托管 AnythingMCP 的 Windows 文件服务器、NAS 或网络共享(SMB/CIFS 或 NFS)中进行搜索:对 PDF、Excel、Word 和 Outlook 文件建立全文索引,并在后台持续同步。仅限自托管。

连接器

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

让 Cursor 搜索挂载到自托管 AnythingMCP 中的 Windows 文件服务器、NAS 或网络共享(SMB/CIFS 或 NFS):对 PDF、Excel、Word 和 Outlook 文件建立全文索引,并在后台同步。仅限自托管。

连接器

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

让 Gemini 搜索挂载到自托管 AnythingMCP 中的 Windows 文件服务器、NAS 或网络共享(SMB/CIFS 或 NFS):对 PDF、Excel、Word 和 Outlook 文件建立全文索引,并在后台同步。仅限自托管。

连接器

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

让 Muse 搜索挂载到自托管 AnythingMCP 中的 Windows 文件服务器、NAS 或网络共享(SMB/CIFS 或 NFS):对 PDF、Excel、Word 和 Outlook 文件建立全文索引,并在后台同步。仅限自托管。