如何将 SFTP 服务器连接到 Microsoft Copilot

Microsoft Copilot 中的 SFTP

简短回答: 将 SFTP 服务器作为 File Search 连接器添加到 AnythingMCP。AnythingMCP 通过 SSH 使用密码或私钥登录,为你选定的文件夹建立全文索引,并保持索引同步。然后通过 Copilot Studio 智能体,将 AnythingMCP 连接到 Microsoft 365 Copilot 和 Teams。Microsoft Copilot 可以按文件名和内容查找文件,读取所需的页面,并把文件本身以附件或临时下载链接的形式交给你。服务器上不会写入任何内容。

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

你需要准备什么

• 服务器上一个能够读取该文件夹的 SSH 账户,最好是除此之外什么都做不了的账户。密码或私钥均可。
• 主机名和 SSH 端口,通常为 22。
• 一个 AnythingMCP 工作区:AnythingMCP Cloud(免费试用 7 天)或你自己自托管的安装。

SFTP 是 SSH 文件传输协议,而不是基于 TLS 的 FTP。如果你的服务器使用 FTP 或 FTPS,请参阅 FTP / FTPS 指南。Hetzner Storage Box、Synology NAS 和 QNAP NAS 在 Marketplace 中都有各自的条目,并带有合适的设置。

设置步骤

步骤 1 — 设置 File Search 连接器

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

1. 连接。 输入主机、端口、用户名,以及密码或私钥,还有要使用的文件夹,例如 /srv/documents。
2. 测试。 在保存任何内容之前,AnythingMCP 会先连接、登录并列出该文件夹,同时显示一份检查清单(地址、可达性、加密、服务器身份、登录、文件夹),并在某一步失败时说明如何修复。它还会以指纹形式显示服务器的 SSH 主机密钥:你只需确认一次,此后 AnythingMCP 会在发送密码之前拒绝不同的密钥,从而保护你免受冒充你服务器的主机攻击。
3. 扫描。 点击 Scan folder。AnythingMCP 会列出文件夹内容但暂不建立索引,并显示一棵树,标明每个子文件夹中的文件数量、文件类型和年份。看起来像归档的文件夹(Alt、Old、Archive、Backup)已默认取消勾选,因此 Microsoft Copilot 不会引用过时的文档。在你勾选文件夹、文件类型或设置时间上限的同时,一个进度条会将你的选择与你的套餐进行比较;当所选内容超出套餐范围时,请取消勾选更多内容或升级套餐。
4. 描述。 AnythingMCP 会根据扫描结果起草连接器的描述,例如“工程团队的项目文档,PDF、Word 和 Excel,2021–2026”。这段文字会告诉 Microsoft Copilot 该文件夹包含什么内容,以及何时应该搜索它。如果服务器上配置了 AI 模型,向导可以用 AI 起草描述,并会准确说明发送了哪些内容(文件夹名、文件名、最多 20 个示例文件的前 2,000 个字符,个人数据已被屏蔽);否则草稿将根据文件夹结构生成。你可以随意编辑。
5. 激活。 选择工具前缀、同步间隔以及接收该连接器的 MCP 服务器,然后点击 Activate。

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

步骤 2 — 复制服务器 URL

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

步骤 3 — 在 Microsoft Copilot 中添加连接器

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

Microsoft Copilot 通过在 Copilot Studio 中构建的智能体来使用 MCP 服务器:你将 AnythingMCP 作为工具添加到智能体,然后把智能体发布到 Microsoft 365 Copilot 和 Teams。Copilot Studio 从 Microsoft 云端通过 Streamable HTTP 进行连接,AnythingMCP 支持这种方式。

1. 在 Copilot Studio 中打开你的智能体(或新建一个),进入 Tools,选择 Add a tool → New tool → Model Context Protocol。
2. 输入 Server name(例如 AnythingMCP)、说明该连接器用途的 Server description(例如“搜索并读取我们 SFTP 服务器上的文档:规格说明、合同、项目文件”),以及 Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID。Copilot Studio 会根据这段描述来决定何时调用该服务器。
3. 在身份验证中选择 API key,将 Type 设为 Header,请求头名称设为 X-API-Key,然后选择 Create。
4. 在 Add tool 中选择 Create a new connection,粘贴来自 AnythingMCP 的 MCP API 密钥(MCP Servers → 你的服务器 → API keys),然后选择 Add to agent。
5. 在智能体的 Test 窗格中试用:提出一个需要用到文件搜索工具的问题。
6. 选择 Publish,然后选择 Channels → Microsoft 365 and Microsoft Teams,保持选中 Make agent available in Microsoft Copilot,并选择 Add channel。See agent in Teams 会为你完成安装;在 Microsoft 365 Copilot 中,输入 @ 并选择该智能体。

想要按用户单独登录?请选择 OAuth 2.0 → Dynamic discovery,而不是 API 密钥:这样每位用户在智能体首次调用 AnythingMCP 时登录,并由该用户的 MCP 角色决定其可使用哪些文件夹和工具。

自托管?请使用你实例的公开 HTTPS 地址,而不是 https://cloud.anythingmcp.com。Copilot Studio 从 Microsoft 云端发起连接,因此 localhost 无法使用。

步骤 4 — 提问

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

Microsoft Copilot 可以对文件做什么

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

在 Microsoft Copilot 中试试这些提示词

• “在项目文件夹中搜索 K-300 系列水泵的规格说明,并总结其运行限制。”
• “哪些文档提到了 Kessler 维护合同,它们最近一次修改是什么时候?”
• “找出所有带有商品编号 NT-601 的 Excel 行,并列出每一行所在的文件和工作表。”
• “把调试检查清单的最新版本以下载链接的形式发给我。”

同步的工作原理

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

同步在独立的后台服务中运行,与响应 Microsoft Copilot 的服务器分开:较大的首次同步不会拖慢你的提问,同步期间搜索会继续使用上一次的索引。

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

安全

• 只读。 连接器只会列出和读取。它没有任何会在服务器上写入、重命名或删除的工具。
• 仅限你的工作区。 索引按工作区存储,每次查询都限定在其中,由应用程序和数据库(Row-Level Security)双重保证。
• 凭据加密存储,仅在后台同步服务中解密。Microsoft Copilot 和你的同事永远看不到它们。
• 谁能看到什么取决于你的 MCP 角色:没有文件工具权限的角色看不到这些工具。在 Enterprise 套餐中,你还可以按角色允许或拒绝特定文件夹。
• 文件内容只是数据。 这些工具会告知模型,绝不要执行文件中出现的任何指令。
• 固定主机密钥。 你确认过的 SSH 主机密钥会在每次连接时检查;不同的密钥会在使用密码或私钥之前被拒绝。
• 密钥登录。 使用私钥时,该账户根本不需要存在密码。
• 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。查看所有套餐。

常见问题

为什么不用 SharePoint? 如果文件已经存放在 SharePoint 或 OneDrive 中,Microsoft 365 Copilot 可以原生搜索它们。本指南适用于不在其中的文件:即 SFTP 服务器上的文档。

向导提示服务器给出了不同的主机密钥。 服务器被重新安装过,或者中间有人在拦截。在确认新指纹之前,请先向服务器管理员核实(Files 面板 → Edit selection → 返回 Test)。

该用密码还是私钥? 两者都可以。为只能读取该文件夹的账户配置私钥,是最干净的设置。

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

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

相关内容

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