如何将 Synology NAS 连接到 Cursor

Cursor 中的 Synology NAS

简短回答: 在 NAS 上启用 SFTP,创建一个只能读取共享文件夹的用户,然后将 NAS 作为 File Search 连接器添加到 AnythingMCP。AnythingMCP 会为该文件夹建立全文索引并保持索引同步。接着把 AnythingMCP 连接到 Cursor。Cursor 可以按文件名和内容查找文件,读取所需的页面,并把文件本身以附件或临时下载链接的形式交给你。NAS 上不会写入任何内容。

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

你需要准备什么

• 在 DSM 中启用 SFTP(控制面板 → 文件服务 → FTP → SFTP),或者如果你更喜欢 WebDAV,安装 WebDAV Server 套件。
• 一个对该共享文件夹拥有只读权限的 DSM 用户。
• 使用 AnythingMCP Cloud 时:NAS 需要能从互联网访问,并在路由器上转发 SFTP 端口。自托管的 AnythingMCP 可以通过本地网络访问 NAS。
• 一个 AnythingMCP 工作区:AnythingMCP Cloud(免费试用 7 天)或你自己的自托管安装。

AnythingMCP 还提供一个 Synology DSM 连接器,用于系统和存储健康状态、任务以及 File Station 目录树。它不会读取文档内部的内容;读取内容由 File Search 完成。Cloud 版无法访问 SMB(端口 445):该端口不应暴露在互联网上。

设置步骤

第 1 步 — 设置 File Search 连接器

在 AnythingMCP 中打开 Marketplace,选择 Synology NAS (File Search):它会打开 File Search 向导,并预设好 SFTP 以及适用于 Synology 的设置。(或者打开 Connectors → New → File Search,使用 Synology 快捷方式。)

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

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

第 2 步 — 复制服务器 URL

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

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

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

Cursor 从 ~/.cursor/mcp.json 读取 MCP 服务器。添加以下条目:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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. 保存文件并重启 Cursor。
3. 打开 Cursor → Settings → MCP,检查 anythingmcp 是否已列出并处于已连接状态。
4. 开始聊天:Agent 现在可以调用文件搜索工具了。

第 4 步 — 提问

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

Cursor 可以用这些文件做什么

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

在 Cursor 中试试这些提示词

• “在共享文件夹中搜索 Kessler 合同,告诉我通知期是多久。”
• “文件夹中 2025 年有哪些 Nordtor 的发票?”
• “找到订单 4711-200 的送货单,告诉我送了什么。”
• “把采购文件夹中最新的价格表以下载链接的形式发给我。”

同步的工作原理

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

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

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

安全

• 只读。 连接器只会列出和读取。它没有任何会在 NAS 上写入、重命名或删除的工具。
• 仅限你的工作区。 索引按工作区存储,每次查询都被限制在其中,由应用程序和数据库(Row-Level Security)双重保证。
• 凭据经加密存储,仅在后台同步服务中解密。Cursor 和你的同事永远看不到它们。
• 谁能看到什么取决于你的 MCP 角色:没有文件工具权限的角色看不到这些工具。在 Enterprise 版中,你还可以按角色允许或拒绝特定文件夹。
• 文件内容是数据。 这些工具会告知模型,永远不要执行文件内部出现的指令。
• 只读用户。 只授予 DSM 用户对那一个共享文件夹的读取权限,不要授予其他权限。
• 主机密钥已固定。 每次连接都会检查 NAS 的 SSH 主机密钥。
• 端口转发。 只转发 SFTP 端口,并且仅在使用 AnythingMCP Cloud 时才需要;在路由器允许的情况下,将其限制为 Cloud 的出站地址。
• 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。所有套餐。

常见问题

Cursor 的免费版支持自定义 MCP 服务器吗? 支持,Hobby、Pro 和 Business 套餐均可使用 MCP。

Synology 上用 SFTP 还是 WebDAV? 两者都可以。SFTP 在 控制面板 → 文件服务 → FTP → SFTP 中启用;WebDAV 需要 WebDAV Server 套件。Marketplace 中的条目会以 SFTP 打开向导。

我必须把 NAS 开放到互联网吗? 使用 AnythingMCP Cloud 时,是的:需要转发 SFTP 端口。同一网络中自托管的 AnythingMCP 无需端口转发即可访问 NAS。

这与 Synology DSM 连接器有什么区别? Synology DSM 连接器读取的是 NAS 的状态。File Search 连接器搜索的是你文档的内容。

AnythingMCP 会复制整个 NAS 吗? 不会。AnythingMCP 保存的是提取出的文本,而不是文件。只有在文件发生更改,或你请求文件本身时,才会重新读取该文件。

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

相关内容

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