如何将 S3 存储桶连接到 Claude

Claude 中的 S3 存储桶

简短回答: 将存储桶作为 File Search 连接器添加到 AnythingMCP,并使用只能列出和读取该存储桶的密钥。AnythingMCP 会为你所选前缀下的文档建立全文索引,并保持索引同步。然后将 AnythingMCP 连接到 claude.ai、Claude 桌面应用和 Claude Code。Claude 可以按文件名和内容查找文件,读取所需的页面,并把文件本身交给你,可以作为附件,也可以是临时下载链接。不会向存储桶写入任何内容。

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

你需要准备什么

• 端点(endpoint):Amazon S3 留空;例如 DigitalOcean Spaces 为 https://fra1.digitaloceanspaces.com,或填写你自己的 MinIO 的 URL。
• **区域(region)和存储桶(bucket)**名称。
• 一个只能列出和读取该存储桶的访问密钥。
• 一个 AnythingMCP 工作区:AnythingMCP Cloud(免费试用 7 天)或你自己自托管的安装。

S3 没有真正的文件夹:向导中看到的"文件夹"其实是键前缀,你选择的前缀决定了哪些内容会被索引。Amazon S3、DigitalOcean Spaces、MinIO、Wasabi、Hetzner Object Storage 和 Backblaze B2 均可使用。

设置步骤

第 1 步 — 设置 File Search 连接器

在 AnythingMCP 中打开 Marketplace,选择 S3 bucket (File Search),或者打开 Connectors → New → File Search 并选择 S3。一个简短的向导会引导你完成设置,无需填写冗长的表单。

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

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

第 2 步 — 复制服务器 URL

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

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

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

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

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

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

第 4 步 — 提问

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

Claude 可以对文件做什么

<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 中尝试的提示词

• "在 invoices 前缀下搜索 Nordtor 在 2025 年的所有发票,并汇总总金额。"
• "找到订单 4711-200 的送货单,告诉我送了什么。"
• "存储桶中哪些文档提到了 Kessler 框架协议?"
• "把最新月度报告的 PDF 以下载链接的形式发给我。"

同步的工作原理

每个对象都带有 ETag。AnythingMCP 会将其与上次运行时的值比较,只下载新增和已更改的对象。内容与已索引版本完全相同的文件会通过校验和(SHA-256)识别,不会被再次处理。已删除的文件会从索引中移除。无法读取的文件会在后续同步中重试,失败三次后(受密码保护的文件则立即)仅保留按文件名查找的能力,原因会显示在 Files 标签页中。

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

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

安全

• 只读。 连接器只会列出和读取。它没有任何会对存储桶执行写入、重命名或删除的工具。
• 仅限你的工作区。 索引按工作区存储,每次查询都被限制在工作区内,由应用程序和数据库(Row-Level Security)双重保证。
• 凭据以加密形式存储,仅在后台同步服务中解密。Claude 和你的同事都看不到它们。
• 谁能看到什么取决于你的 MCP 角色:没有文件工具权限的角色看不到这些工具。在 Enterprise 套餐中,你还可以按角色允许或拒绝特定文件夹。
• 文件内容只是数据。 这些工具会告诉模型,绝不要执行在文件内部发现的指令。
• 单个存储桶专用密钥。 请给 AnythingMCP 一个只能列出和读取该存储桶的密钥,而不是你账户的主密钥。
• AnythingMCP Cloud 只连接公共互联网上的服务器:私有网络中的主机会被拒绝,重定向之后也一样。你办公网络中的服务器必须能从外部访问,或者你将 AnythingMCP 自托管在它旁边。

各套餐限制

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

常见问题

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

它能用于 DigitalOcean Spaces、MinIO 或 Wasabi 吗? 可以。输入服务商的端点,例如 Spaces 为 https://fra1.digitaloceanspaces.com,或你的 MinIO 的 URL;Amazon S3 则留空。

密钥需要哪些权限? 列出和读取该存储桶,仅此而已。连接器绝不会向存储桶写入。

AnythingMCP Cloud 能访问我们办公网络中的 MinIO 吗? 不能。在 Cloud 上,端点必须位于公共互联网。请将 AnythingMCP 自托管在私有 MinIO 旁边。

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

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

相关内容

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