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。
点击连接。
完成 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 客户端。