說明文件

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 用戶端。