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

Gemini 中的网络文件夹

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

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

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

你需要准备什么

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

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

步骤 3 — 复制服务器 URL

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

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

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

Gemini 运行在你的电脑上，因此也可以访问你自己网络中的 AnythingMCP。本步骤中出现 https://anythingmcp.example.com 的地方，请使用你的实例地址。

Gemini CLI 从 ~/.gemini/settings.json 读取 MCP 服务器（在 Windows 上为 %USERPROFILE%\.gemini\settings.json）。添加：

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://anythingmcp.example.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. 保存文件并重启 gemini。
3. 在 Gemini CLI 中运行 /mcp（或在 Shell 中运行 gemini mcp list）：anythingmcp 应显示为已连接。
4. 开始提问：Gemini CLI 现在可以调用文件搜索工具了。

步骤 5 — 提问

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

Gemini 可以对这些文件做什么

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

在 Gemini 中试试这些提示词

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

同步的工作方式

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

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

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

安全

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

各套餐的限制

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

常见问题

Gemini CLI 在哪里查找 MCP 服务器？ 对当前用户而言在 ~/.gemini/settings.json 中，对项目而言在项目内的 .gemini/settings.json 中。gemini mcp list 会显示每个服务器以及它是否连接成功。

为什么 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 文件服务器连接到 Microsoft Copilot
• 将网络文件夹或 Windows 文件服务器连接到 Cursor
• 将网络文件夹或 Windows 文件服务器连接到 Muse
• Gemini 中的其他文件来源：SFTP 服务器、FTP / FTPS 服务器、WebDAV 服务器、S3 存储桶、Nextcloud、ownCloud、Synology NAS、QNAP NAS、Fritz!Box 存储、Hetzner Storage Box