文档

MCP 服务器

需要账号具备相应权限

仅当已登录 Savebase 账号的当前权益包含 MCP 时,才可使用 MCP 访问。

Savebase 提供一个 Model Context Protocol(MCP) 服务器,让 AI 助手搜索和读取已保存书签。可以这样询问 Claude、ChatGPT 或 Cursor “关于壶铃训练,我收藏过什么?” 它就会直接查询 Savebase 资料库。

概览

MCP 是让 AI 应用连接外部数据源的开放标准。Savebase 提供兼容 MCP 的 HTTP 端点,让 AI 助手以只读方式访问书签、文件夹和标签。

对于 ChatGPT,请安装已发布的 Savebase 插件。Claude、Cursor、VS Code 和其他 MCP 客户端请使用此服务器地址:

text
https://mcp.savebase.space/mcp

使用 Savebase 账号登录,方式与其他应用相同,无需复制 API 密钥或令牌。访问为只读;通过 MCP 连接的工具都不能添加、编辑或删除资料库内容。

要求

  • 当前权限包含 MCP 访问资格的 Savebase 账号
  • 已发布的 Savebase ChatGPT 插件,或 Claude、Cursor、VS Code 等兼容 MCP 客户端

Claude(网页版、桌面版、手机版)

1

打开 Claude 连接器

在 claude.ai 或桌面应用中,前往 设置 → 连接器.
2

添加自定义连接器

点击 添加自定义连接器,将其命名为 Savebase,并粘贴 https://mcp.savebase.space/mcp.
3

连接并登录

点击 添加 → 连接,登录你的 Savebase 账号并授权。此后即可在对话中使用 Savebase 工具。

移动端同样适用

在 claude.ai 上添加的远程连接器可以在 iOS 和 Android 版 Claude 中使用,但无法直接从 Claude 手机应用添加新服务器。请参阅 Anthropic 的 当前远程 MCP 支持说明.

Claude Code

1

添加服务器

在终端中运行以下内容。移除 --scope user 如果只希望它用于当前项目。
bash
claude mcp add --transport http --scope user savebase https://mcp.savebase.space/mcp
2

身份验证

启动 Claude Code 并运行 /mcp。浏览器窗口会打开,登录并授权即可。
3

验证

运行 claude mcp list。Savebase 应显示为已连接。

Cursor

1

打开 MCP 配置

前往 设置 → MCP → 添加新服务器,或编辑 ~/.cursor/mcp.json 直接使用。
2

添加 Savebase 服务器

添加下方配置。请注意,其中不包含 headers 配置块;身份验证在浏览器中完成。
JSON
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

重新加载并授权

重新加载 Cursor。服务器会显示需要登录;点击它,登录并批准。

Cursor 用户注意事项

始终选择 HTTP 作为服务器类型,而非 SSE。如果之前有 Savebase SSE 配置,请删除并以 HTTP 重新添加,再重启 Cursor。

ChatGPT

1

打开 Savebase 插件

访问官方 Savebase 插件页面 在 ChatGPT 中。
2

安装并登录

选择加号按钮安装 Savebase。提示时,使用 Savebase 账号登录,并批准资料库只读访问。
3

在聊天中使用 Savebase

开始新的 ChatGPT Work 对话,并使用以下方式调用 Savebase @Savebase,也可以在需要 ChatGPT 搜索资料库时,从输入框的工具选择器中选用它。

无需开发配置

公开插件替代了 ChatGPT 原先的开发者模式和自定义 MCP 设置。上方 MCP 服务器 URL 仍用于其他兼容客户端。

VS Code

1

添加服务器

打开命令面板,运行 MCP:添加服务器,选择 HTTP,并粘贴 https://mcp.savebase.space/mcp.
2

或直接编辑配置

添加到 .vscode/mcp.json 在工作区中:
JSON
{
  "servers": {
    "savebase": {
      "type": "http",
      "url": "https://mcp.savebase.space/mcp"
    }
  }
}
3

登录

从 MCP 视图启动服务器。浏览器会打开登录窗口;批准后,工具就会出现在 Copilot Chat 的智能体模式中。

管理已连接应用

你登录过的每个应用都会列在 设置 → MCP 服务器 → 已连接应用,同时显示连接日期及最近读取资料库的时间。点击 断开连接 立即撤销访问。

应用能看到什么

已连接的应用仅可读取你的书签、笔记、转录文本、文件夹名称和标签。它们无法看到密码,也不能修改资料库。

只有请求促使已连接助手查询 MCP 服务器时,Savebase 才发送数据;不会在后台将资料库推送到已连接应用,也不会用它训练 Savebase 模型。数据到达助手后,适用该提供商的隐私及数据使用条款。请参阅 Savebase 隐私政策 查看已连接应用可接收内容的完整列表。

进阶:手动访问令牌

部分旧版 MCP 客户端无法通过浏览器登录,需要通过请求头发送令牌。对于这些客户端,请打开 设置 → MCP 服务器 → 高级,输入一个名称,然后点击 生成令牌。令牌以此开头: sb- 并保持有效,直到你撤销。

JSON
{
  "mcpServers": {
    "savebase": {
      "url": "https://mcp.savebase.space/mcp",
      "headers": {
        "Authorization": "Bearer sb-YOUR_MCP_TOKEN"
      }
    }
  }
}

令牌安全

Savebase 从不存储原始令牌,只存储 SHA-256 哈希。令牌生成时仅显示一次,请立即复制。可随时在设置 → MCP 服务器中撤销。

可用工具

连接后,AI 助手可以访问这九项工具。每项都只读取数据,无法更改资料库中的任何内容。

工具描述
search_bookmarks通过关键词搜索标题、内容、笔记、作者、URL 和视频转录。可限定特定字段,并按平台、文件夹、标签、创作者、日期范围或是否有转录筛选。
list_bookmarks无需关键词也可浏览,并可按平台、文件夹、标签和日期筛选
list_recent_bookmarks今天、本周、本月,或过去 7 天和 30 天保存的内容
get_bookmark单个书签的完整详情,包括标签、文件夹和转录预览
get_bookmark_transcript分块读取长视频转录文本,无需一次加载全部内容
find_bookmark_by_url检查链接是否已经保存。会忽略以下跟踪参数: utm_source.
list_folders列出文件夹,包括嵌套结构
list_tags列出所有标签
get_library_stats总量、按平台细分、最活跃文件夹与标签,以及近期保存活动

提示词示例

可以向 AI 助手提出这样的问题:

  • “关于壶铃训练,我收藏过什么?”
  • “显示我上个月从 Reddit 保存的所有内容。”
  • “找到我保存的那个讲解如何设置 Cloudflare Worker 的视频。”
  • “这个链接我已经保存过了吗?” — 粘贴 URL
  • “查找我的‘设计灵感’文件夹中的所有书签。”
  • “哪些文章被我添加了‘AI’标签?”
  • “分析我的资料库:内容数量、来源和最常用的标签。”
  • “总结我上周保存的帖子。”

搜索视频中说过的内容

如果已转录保存的视频,其中的口述内容也可搜索。例如这样的问题 “如何完成 X” 可以找到几个月前保存的视频中口头讲解的某个步骤。

故障排查

问题解决方法
ChatGPT 中找不到 Savebase打开 已发布 Savebase 插件,完成安装,然后开启新的 ChatGPT Work 对话。无需再在开发者模式中创建自定义应用。
应用从不要求你登录核对网址是否与以下内容完全一致: https://mcp.savebase.space/mcp — 拼写错误会导致客户端找不到登录步骤。
登录时出现“MCP 访问不可用”请使用当前权益包含 MCP 访问的账号登录;如果认为权益有误,请联系 Savebase 支持团队。
“此请求已过期”授权请求的有效期为 10 分钟。请从 AI 应用重新发起连接。
连接不再正常工作检查“设置 → MCP 服务器 → 已连接应用”中是否仍显示该应用。如果连接已断开,请从应用中重新连接。
Cursor 中服务器显示“errored”在 Cursor 设置 → MCP 中删除旧的 Savebase 配置。重新添加为 类型:HTTP (而不是 SSE),然后完全重启 Cursor。
工具未显示添加配置后,请重启 AI 客户端。部分客户端需要完全重启才能检测新 MCP 服务器。
结果为空确认 Savebase 资料库中已有已保存书签。MCP 服务器仅搜索你自己的数据。
丢失手动令牌令牌仅显示一次。请在设置 → MCP 服务器 → 高级中撤销旧令牌,再生成新令牌。

快速恢复步骤

如果功能无法正常工作:(1) 在 AI 应用中断开 Savebase,(2) 从设置 → MCP 服务器 → 已连接应用中移除它,(3) 重新添加连接器并登录,(4) 完全重启 AI 客户端。