如何将 FTP 或 FTPS 服务器连接到 Gemini

Gemini 中的 FTP 和 FTPS

简短回答: 将 FTP 服务器作为 File Search 连接器添加到 AnythingMCP,优先使用 FTPS(带 TLS 的 FTP)。AnythingMCP 会为你选定的文件夹建立全文索引并保持索引同步。然后将 AnythingMCP 连接到 Gemini CLI。Gemini 可以按文件名和内容查找文件,读取所需的页面,并把文件本身以附件或临时下载链接的形式交给你。服务器上不会写入任何内容。

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

你需要准备什么

• 一个对该文件夹有读取权限的 FTP 账户。只读账户是最佳选择。
• 主机名和模式:显式 FTPS 通常使用 21 端口,隐式 FTPS 使用 990 端口,普通 FTP 使用 21 端口。
• 一个 AnythingMCP 工作区:AnythingMCP Cloud(7 天免费)或你自己的自托管安装。

FTPS 还是普通 FTP? 只要服务器支持,就使用 FTPS。普通 FTP 会以未加密方式发送密码:AnythingMCP 只有在你确认这一点后才会接受,而且 Enterprise 工作区策略可以禁止使用。Fritz!Box 在 Marketplace 中有专门的条目,已包含正确的设置。

设置步骤

步骤 1 — 设置 File Search 连接器

在 AnythingMCP 中打开 Marketplace,选择 FTP / FTPS (File Search),或者打开 Connectors → New → File Search,然后选择 FTPS(显式或隐式)或 FTP。一个简短的向导会引导你完成,无需填写冗长的表单。

1. 连接。 输入主机、端口、用户名、密码以及要使用的文件夹,例如 /exports。如果使用普通 FTP,请确认密码将以未加密方式传输。
2. 测试。 在保存任何内容之前,AnythingMCP 会先连接、登录并列出该文件夹,并显示一份检查清单(地址、可达性、加密、服务器身份、登录、文件夹),某一步失败时会说明该如何修复。由公共机构签发的证书会直接被接受。自签名证书会以指纹形式显示:你确认一次之后,AnythingMCP 会在发送密码之前拒绝任何不同的证书。
3. 扫描。 点击 Scan folder。AnythingMCP 会列出文件夹内容但暂不建立索引,并显示一棵树,标明每个子文件夹中的文件数量、文件类型和年份。看起来像归档的文件夹(Alt、Old、Archive、Backup)默认已取消勾选,这样 Gemini 就不会引用过时的文档。在你勾选文件夹、文件类型或设置时间上限时,一个进度条会将你的选择与你的套餐进行比较;如果所选内容超出套餐限额,请取消勾选更多内容或升级套餐。
4. 描述。 AnythingMCP 会根据扫描结果起草连接器的描述,例如"供应商门户的价格表和数据表,PDF 和 Excel,2022–2026"。这段文字会告诉 Gemini 该文件夹包含什么内容以及何时进行搜索。如果服务器上配置了 AI 模型,向导可以使用 AI 起草,并会准确说明发送了哪些内容(文件夹名称、文件名、最多 20 个示例文件的前 2,000 个字符,个人数据已被屏蔽);否则,草稿将根据文件夹结构生成。你可以随意编辑。
5. 激活。 选择工具前缀、同步间隔以及使用该连接器的 MCP 服务器,然后点击 Activate。

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

步骤 2 — 复制服务器 URL

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

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

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

Gemini CLI 从 ~/.gemini/settings.json 读取 MCP 服务器(Windows 上为 %USERPROFILE%\.gemini\settings.json)。添加:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.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 现在可以调用文件搜索工具了。

步骤 4 — 提问

开启一个新对话,询问关于文件内容的问题。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 的价格。"
• "哪些数据表提到了 T30 防火等级?"
• "列出 exports 文件夹中所有包含折扣组 12 的 Excel 行。"
• "文件夹中本月有哪些文件被修改过?"

同步如何工作

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

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

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

安全

• 只读。 连接器只列出和读取内容。它没有任何会在服务器上写入、重命名或删除的工具。
• 仅限你的工作区。 索引按工作区存储,每次查询都限定在该工作区内,由应用程序和数据库(Row-Level Security)双重保证。
• 凭据经加密存储,仅在后台同步服务中解密。Gemini 和你的同事都看不到它们。
• 谁能看到什么遵循你的 MCP 角色:没有文件工具权限的角色看不到这些工具。在 Enterprise 上,你还可以按角色允许或拒绝特定文件夹。
• 文件内容只是数据。 这些工具会告知模型,绝不要执行文件内部出现的任何指令。
• 证书固定。 你确认过的自签名证书会在每次连接时、发送密码之前进行检查。
• 被动模式仅限于该服务器。 数据连接只会连到服务器自身的地址。
• 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。所有套餐。

常见问题

Gemini CLI 在哪里查找 MCP 服务器? 用户级配置在 ~/.gemini/settings.json,项目级配置在项目内的 .gemini/settings.json。gemini mcp list 会显示每个服务器及其是否连接成功。

显式 FTPS 还是隐式 FTPS? 服务器支持哪种就用哪种。显式 FTPS 从常规 FTP 端口(通常是 21)开始,然后切换到 TLS;隐式 FTPS 从一开始就使用 TLS,通常在 990 端口。

我的服务器只支持普通 FTP。 你确认密码将以未加密方式传输后,AnythingMCP 就会连接。此时请优先使用只读账户,并询问服务器能否启用 FTPS。

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

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

相关内容

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