Sync_Vault_MCP_配置指南

02 Aug, 2026

{ tag: }

Sync Vault MCP多平台配置教程

前言

今天给大家介绍一个超实用的功能—— Sync Vault MCP Server 。

通过 MCP（Model Context Protocol），你可以让 AI 直接读取和操作网盘中的文件，无论是 Claude Code、Cursor 还是其他支持 MCP 的客户端，都能轻松接入！

💡 提示： 使用前请确保已在 Obsidian 中安装并启动 Sync Vault 插件

什么是 MCP？

MCP（Model Context Protocol）是一种标准化协议，允许 AI 与外部工具和服务进行交互。

Sync Vault MCP 提供以下能力：

• 📂 list_cloud_files - 列出云盘文件
• 🔍 search_cloud_files - 搜索云盘文件
• 📖 read_cloud_file - 读取文件内容
• 🔗 link_cloud_file - 笔记链接云盘文件
• 🖼️ embed_cloud_file - 笔记嵌入媒体，自动识别图片、pdf和音视频，按照适当的语法嵌入

一、Claude Code CLI 配置

步骤1： 打开终端，进入 Claude Code 配置目录：

nano ~/.claude/mcp.json

步骤2： 添加以下配置（将 3000 改为实际的端口号）：

{
  "mcpServers": {
    "sync-vault-mcp": {
      "type": "sse",
      "url": "http://127.0.0.1:3000/sse"
    }
  }
}

步骤3： 保存并退出，重启 Claude Code 即可生效！

二、Claude Desktop 配置

⚠️ 由于 Claude Desktop 只支持 STDIO 方式，需要使用桥接器转接

步骤1： 全局安装 sse-bridge：

npm install -g @mcpwizard/sse-bridge

步骤2： 打开 Claude Desktop，点击 设置 → 开发者 → 编辑配置

步骤3： 添加以下配置：

{
  "mcpServers": {
    "sync-vault-mcp": {
      "command": "npx",
      "args": ["@mcpwizard/sse-bridge", "http://127.0.0.1:3000/sse"]
    }
  }
}

步骤4： 保存配置，重启 Claude Desktop ✨

三、Cursor / Trae 配置

步骤1： 打开 Cursor 或 Trae

步骤2： 进入 MCP 设置

步骤3： 选择 手动添加 MCP Server

步骤4： 填写以下信息：

• 名称： sync-vault-mcp
• 类型：SSE
• URL： http://127.0.0.1:3000/sse

或直接添加 JSON：

{
  "mcpServers": {
    "sync-vault-mcp": {
      "type": "sse",
      "url": "http://127.0.0.1:3000/sse"
    }
  }
}

使用示例

配置完成后，你可以直接对 AI 说：

"帮我列出网盘里的 documents 文件夹"

"搜索一下最近修改的 PDF 文件"

"读取那个 report.docx 的内容"

AI 就能直接读取你的网盘文件啦！🎉

演示：Claude Code CLI嵌入视频到笔记中

常见问题

Q: 提示连接失败怎么办？

A: 确保 Sync Vault 插件已启动，MCP 服务端口（默认 3000）未被占用。

Q: 哪里查看端口号？

A: 在 Obsidian 中打开 Sync Vault 插件设置查看。

Previous

Next