SimpleBackups

官方

從任何 AI 助理檢查、除錯並修復你的備份。查看哪些備份失敗及原因、讀取執行日誌，並為你的資料庫、伺服器與儲存空間執行、暫停或繼續備份。

你可以用 SimpleBackups MCP 做什麼？

帳戶健康檢查 — 一次呼叫即可取得整體備份健康摘要，包含數量、失敗的備份與過期的備份。
備份調查 — 深入檢視單一備份、讀取其最近的執行歷史，或檢視涵蓋多個備份的每日狀態格狀圖。
失敗診斷 — 擷取失敗執行的主控台輸出尾段，以查看泛用「備份失敗」訊息背後的確切錯誤行。
隨需執行 — 每次呼叫可觸發最多 20 個備份的執行，並提供試執行選項，先預覽解析後的集合。
暫停與繼續 — 暫停或繼續一個或多個排程備份，支援試執行，可於維護窗口前後使用。
還原準備 — 準備還原並取得各類型專屬指示，且不會向 AI 用戶端暴露憑證。

託管 MCP 伺服器

npx add-mcp 'https://mcp.simplebackups.ai/mcp'

可安裝到 Claude Code、Codex、Cursor 等客戶端

文件

SimpleBackups MCP 伺服器

直接從 Claude、Cursor、Codex 及其他相容於 MCP 的 AI 用戶端管理你的備份。

將 SimpleBackups 連接到 Claude、Cursor 或任何 MCP 用戶端。代理會讀取上下文、提出修正建議，並在同一段對話中執行。建構於 Model Context Protocol 之上，這是一項用於將 AI 助理連接到外部工具的開放標準。

[!note] 注意 SimpleBackups 現已收錄於 Claude 的官方連接器目錄。你可以從該處一鍵新增，無需手動輸入伺服器 URL。

[!note] 注意 可用性

SimpleBackups MCP 伺服器在免費試用期及所有付費方案中皆可使用。請依照下列步驟連接你的用戶端，或從設定 → MCP 連線管理現有連線。

什麼是 MCP？

MCP 是 Model Context Protocol 的縮寫，是一項開放標準，讓 AI 助理能安全地連接到外部工具與資料來源。你的助理不必再來回貼上 API 回應，而是透過單一經過驗證的連線直接與 SimpleBackups 通訊，取得它回答你的問題或代你執行動作所需的確切資料。

此協定受到 Claude（Claude Code、Claude Desktop、網頁版 Claude）、Cursor、OpenAI Codex 以及越來越多其他 AI 用戶端支援。任何相容於 MCP 的用戶端都能使用相同的伺服器 URL 連接到 SimpleBackups。

為什麼要將 SimpleBackups 連接到你的代理？

大多數時候，你並不想管理備份。你想要的是答案。昨晚有東西失敗嗎？為什麼預備環境資料庫備份出錯？你能在我部署前觸發正式環境備份嗎？給我上週五快照的還原連結。 透過 MCP，你的代理會直接回答這些問題並執行這些動作，無需切換情境。

對團隊而言，價值會不斷累積。工程師可以從編輯器調查失敗的備份，待命人員無需開啟儀表板即可分診事件，維運人員只需一句話就能在維護窗口前暫停所有備份，全都使用同一個 SimpleBackups 團隊，以及他們原本就擁有的相同權限。

你可以做什麼

MCP 伺服器提供十四項工具，分為三個領域：

帳戶分診： 一次呼叫即可回答「我的帳戶狀況如何？」：整體計數、失敗的備份、過期的備份，以及需要關注項目的樣本。
備份調查： 深入檢視單一備份、讀取其最近的執行歷史，或取得涵蓋多個備份的每日狀態網格，以找出模式。
安全動作： 觸發隨選執行、暫停或恢復排程備份，並準備還原，附上依類型而定的指示。

每個動作都會以連接帳戶的使用者身分、在你連線時所選的團隊上執行，並遵循你在該團隊中既有的角色。

連接你的助理

無論你以何種方式連接，都會透過標準 OAuth 流程以你的 SimpleBackups 帳戶進行驗證。無需複製 API 權杖、無需與 AI 用戶端分享憑證，也無需管理額外的密碼。助理首次連接時，你會被告知前往 SimpleBackups，若尚未登入則先登入，選擇連線應作用於哪個團隊，然後核准連線。從那一刻起，助理便擁有一個與該團隊綁定的範圍受限權杖。

SimpleBackups MCP consent screen

你可以隨時從設定 → MCP 連線撤銷連線。

Claude — 從連接器目錄（最簡單）

SimpleBackups 已收錄於 Claude 的官方連接器目錄，因此無需手動設定任何內容：

開啟 claude.ai/directory/simplebackups — 或從 Claude 本身瀏覽目錄至 SimpleBackups。
點擊 Connect。
完成 SimpleBackups OAuth 流程，並選擇連線應作用於哪個團隊。

連線會綁定到你的 Claude 帳戶，因此可跨網頁版 Claude、Claude Desktop 和 Claude 行動版使用，無需重複設定。SimpleBackups 工具會出現在你的下一段對話中。

手動新增伺服器 URL

如果你使用的是 Claude Code、API，或任何不透過目錄瀏覽器的用戶端，請直接使用伺服器 URL 連接：

https://mcp.simplebackups.ai/mcp

如需更深入的技術細節，包括 OAuth 流程、動態用戶端註冊、工具結構描述和速率限制，請參閱 MCP 開發者參考。

Claude Code

在終端機中，將連接器新增至你的 Claude Code 設定：

claude mcp add --transport http simplebackups https://mcp.simplebackups.ai/mcp

下次啟動 Claude Code 時，它會提示你在瀏覽器中完成 OAuth 流程。核准後，SimpleBackups 工具會自動出現在工作階段中。

Claude Desktop

目錄是 Claude Desktop 的建議途徑。如果你偏好自行新增伺服器，請開啟 設定 → 連接器 → 新增自訂連接器，給它一個名稱如 SimpleBackups，然後貼上上方的伺服器 URL。Claude 會開啟瀏覽器分頁以完成 OAuth 流程，然後帶你回到連線已就緒的對話。

Claude Desktop add custom connector

Cursor

在 Cursor 中，開啟 設定 → MCP → 新增 MCP 伺服器，選擇 HTTP 傳輸方式，然後貼上伺服器 URL。Cursor 會在你的預設瀏覽器中開啟 OAuth 流程。

或者，直接編輯 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "simplebackups": {
      "url": "https://mcp.simplebackups.ai/mcp"
    }
  }
}

這會使用 Cursor 原生的 HTTP 傳輸，因此無需安裝任何東西：不需要 Node.js、不需要 npx，也不需要額外的代理。如果你看不到 HTTP 傳輸選項，或 "url" 表單被忽略，表示你的 Cursor 版本太舊，無法直接連接到遠端 MCP 伺服器。請更新至最新版 Cursor，或使用疑難排解中所述的 mcp-remote 備援方案。

Codex

在 Codex CLI 中，新增 SimpleBackups MCP 伺服器：

codex mcp add simplebackups --url https://mcp.simplebackups.ai/mcp

Codex 會在你的瀏覽器中開啟 OAuth 流程，並在你核准後儲存連線。

Codex CLI connecting to SimpleBackups

其他 MCP 用戶端

任何支援 streamable-http 傳輸方式以及具備動態用戶端註冊的 OAuth 2.1 的 MCP 相容用戶端，都能使用相同的伺服器 URL 連接。請參閱你用戶端的文件，了解應貼上何處。如果你的用戶端不支援 OAuth，請聯絡我們，我們會協助你找到可行途徑。

疑難排解

我的用戶端無法直接連接到遠端 URL

上述設定使用各用戶端的原生 HTTP 傳輸，無需額外軟體。如果你的用戶端是較舊版本，無法直接連接到遠端 MCP 伺服器，你可以透過 mcp-remote 橋接連線，這是一個小型代理，透過 stdio 將遠端伺服器暴露給你的用戶端：

{
  "mcpServers": {
    "simplebackups": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.simplebackups.ai/mcp"]
    }
  }
}

mcp-remote 會在首次執行時為你處理相同的 OAuth 流程。當你的用戶端支援原生 HTTP 傳輸時，請優先使用它；只有在不支援時才使用 mcp-remote。

mcp-remote 啟動失敗，或我的用戶端顯示 Node 錯誤

mcp-remote 透過 npx 執行，因此需要 Node.js 18 或更新版本（建議 20+）。使用 node --version 檢查你的版本。

問題在於：你的用戶端會使用 PATH 中第一個找到的 Node.js 來啟動 npx。如果你的預設版本是較舊的 Node.js，例如因為像 nvm 這類版本管理工具為舊專案固定了某個版本，那麼即使已安裝較新的 Node.js，連線仍會失敗。以下兩種方式可修正：

將預設 Node.js 升級至 18 或更新版本（nvm install --lts && nvm alias default 'lts/*'），然後重新啟動你的用戶端，或
固定絕對路徑指向較新的 Node.js 及其 npx，讓代理永遠不會使用舊的預設版本：

{
  "mcpServers": {
    "simplebackups": {
      "command": "/Users/you/.nvm/versions/node/v20.20.2/bin/node",
      "args": [
        "/Users/you/.nvm/versions/node/v20.20.2/bin/npx",
        "-y",
        "mcp-remote",
        "https://mcp.simplebackups.ai/mcp"
      ]
    }
  }
}

請將路徑替換為在已啟用現代 Node.js 的 shell 中執行 which node 和 which npx 的輸出。

可用工具

每項工具都限定於你連線時所選的團隊，並以你在該團隊中既有的角色執行。

工具	功能
`whoami`	傳回已連線的使用者、團隊角色與方案、支援 ID，以及儀表板和資源 URL。
`get-backups-overview`	單次呼叫的帳戶健康狀態：彙總計數，加上失敗或過期備份的樣本。
`list-backups`	分頁清單，可依類型、狀態、伺服器、儲存或名稱篩選。包含內嵌的最後狀態和錯誤摘錄。
`find-failing-backups`	僅傳回最近一次執行在可設定時間窗口內失敗的備份。
`get-backup`	單一備份的精簡摘要，包括身分、類型、狀態、伺服器與儲存參照，以及最近一次執行的狀態和錯誤摘錄。
`get-backup-logs`	單一備份的最近執行歷史。
`get-backup-runs-timeline`	單次呼叫中涵蓋多個備份的每日狀態網格，適合找出不穩定的日子或模式。
`get-run-output`	傳回單次備份執行的主控台輸出尾端（stdout 和 stderr），包括備份程序產生的確切錯誤行。這項工具能將籠統的「備份失敗」轉化為實際原因。
`list-storages`	儲存目的地（S3、B2、SFTP、Dropbox……），包含類型、以 GB 計的使用量和連線狀態。絕不會傳回憑證。
`list-servers`	伺服器與來源，包含連線類型、狀態、防火牆與 Docker 旗標，以及工具版本。絕不會傳回主機名稱和憑證。
`run-backups`	每次呼叫可為最多 20 個備份觸發隨選執行。支援 `dry_run` 以預覽解析後的集合。
`pause-backups`	暫停一個或多個備份，使其停止依排程執行。支援 `dry_run`。
`resume-backups`	恢復已暫停的備份，使其再次依排程執行。支援 `dry_run`。
`restore-prep`	準備還原，並提供依類型而定的還原指示。

範例提示

連接後，你可以像對待隊友一樣與你的代理對話。以下幾個提示可供入門：

「過去 7 天內有任何備份失敗嗎？」
「幫我畫出過去 14 天所有正式環境備份的狀態網格。」
「為什麼備份 #28491 昨晚失敗？顯示錯誤給我看。」
「現在觸發預備環境資料庫備份，我即將部署。」
「將所有 MySQL 備份暫停一小時，我正在進行維護。」
「給我備份 #28491 最近一次成功執行的還原連結。」

[!note] 注意提示

對於執行、暫停或還原等隨選動作，你的代理會在執行前與你確認受影響的備份 ID。你始終掌握控制權。

查看真實對話 觀看真實工作流程，包括還原、分診、部署前快照和合規性，在對話中端到端執行。

安全性與權限

MCP 伺服器對待你資料的方式與 SimpleBackups 儀表板相同。

絕不會傳回憑證。 儲存存取金鑰、SSH 私密金鑰、資料庫密碼和 API 權杖都留在 SimpleBackups 內部。工具回應絕不會包含它們，即使在列出儲存或伺服器時亦然。
使用 OAuth，而非 API 金鑰。 每個 AI 用戶端都會取得一個範圍限定於單一團隊的短期存取權杖。沒有需要你手動複製、儲存或輪替的長期密鑰。
還原產物可安全分享。 還原準備只會傳回由你自己操作的安全產物；你的憑證絕不會傳送給 AI 用戶端。
權限與你的儀表板角色一致。 MCP 連線會以你在連線時所選團隊中既有的角色執行，因此僅具調查權限的隊友仍僅具調查權限。
受速率限制並經稽核。 每次呼叫都會依呼叫者進行速率限制，並記錄於你團隊的稽核軌跡中。你可以從設定 → MCP 連線撤銷任何連線或權杖。

[!note] 注意 撤銷存取權

如果你懷疑某個已連接的用戶端遭到入侵，請從設定 → MCP 連線撤銷該連線。存取權杖會立即失效，用戶端必須重新驗證才能重新連接。

常見問題

哪些方案包含 MCP？

MCP 伺服器包含在免費試用版及所有付費方案中。

我的助理會直接看到我的備份資料嗎？

不會。MCP 工具只會回傳中繼資料，包括備份設定、執行歷程、狀態和儲存目的地，不會回傳您備份檔案或資料庫的內容。唯一的例外是 restore-prep，它會回傳一個安全的還原成品，您可以自行決定是否據此採取行動；資料本身是由您擷取，而非由助理擷取。

我的助理可以刪除備份或儲存空間嗎？

不行。刪除備份、移除儲存空間或輪替憑證等破壞性操作，刻意不透過 MCP 開放。可用的動作只有執行、暫停、繼續和準備還原，這些全都是可逆或唯讀的操作。

我可以將多個 AI 用戶端連線到同一個 SimpleBackups 帳戶嗎？

可以。每個用戶端都會註冊為獨立的 MCP 連線，並取得自己的存取權杖。您可以在設定 → MCP 連線中查看所有已連線的用戶端，並個別撤銷其中任何一個。

我可以選擇連線要代表哪個團隊運作嗎？

可以。如果您隸屬於多個 SimpleBackups 團隊，您可以在 OAuth 同意步驟中選擇團隊。連線在其生命週期內都會綁定至該團隊。若要代表其他團隊運作，請新增第二個連線。

如果我的 MCP 用戶端不支援 OAuth 怎麼辦？

大多數現代 MCP 用戶端都開箱即支援 OAuth 2.1 與動態用戶端註冊。如果您的用戶端不支援，請與我們聯絡，我們會協助您找到可行的做法，或在用戶端支援跟上時通知您。

管理 MCP 連線 檢視、稽核並撤銷連線至您 SimpleBackups 帳戶的 AI 用戶端。