SimpleBackups

공식

AI 어시스턴트에서 백업을 확인, 디버그 및 수정하세요. 어떤 백업이 실패하고 그 이유가 무엇인지 확인하고, 실행 로그를 읽고, 데이터베이스, 서버 및 스토리지의 백업을 실행, 일시 중지 또는 재개하세요.

SimpleBackups MCP(으)로 무엇을 할 수 있나요?

계정 상태 점검 — 한 번의 호출로 전체 백업 상태 요약을 요청하여 개수, 실패한 백업, 오래된 백업을 확인합니다.
백업 조사 — 단일 백업을 자세히 살펴보고, 최근 실행 기록을 읽거나, 여러 백업에 걸친 일별 상태 그리드를 확인합니다.
실패 진단 — 실패한 실행의 콘솔 출력 마지막 부분을 가져와 일반적인 "backup failed" 뒤에 있는 정확한 오류 줄을 확인합니다.
온디맨드 실행 — 호출당 최대 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 클라이언트에 연결하세요. 에이전트는 컨텍스트를 읽고, 수정 사항을 제안하며, 하나의 대화에서 이를 실행합니다. AI 어시스턴트를 외부 도구에 연결하기 위한 개방형 표준인 Model Context Protocol을 기반으로 구축되었습니다.

[!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 서버는 세 영역으로 그룹화된 14개의 도구를 제공합니다:

계정 분류: 한 번의 호출로 "내 계정 상태는 어떤가요?"에 답합니다: 전체 개수, 실패한 백업, 오래된 백업, 주의가 필요한 항목의 샘플.
백업 조사: 단일 백업을 자세히 살펴보고, 최근 실행 기록을 읽거나, 여러 백업에 걸친 일별 상태 그리드를 가져와 패턴을 파악합니다.
안전한 작업: 온디맨드 실행을 트리거하고, 예약된 백업을 일시 중지하거나 재개하며, 유형별 지침과 함께 복원을 준비합니다.

모든 작업은 계정을 연결한 사용자로서, 연결 시 선택한 팀에서 실행되며, 해당 팀에서의 기존 역할을 존중합니다.

어시스턴트 연결하기

어떤 방식으로 연결하든, 표준 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 서버에 직접 연결할 수 없는 이전 버전인 경우, 원격 서버를 stdio를 통해 클라이언트에 노출하는 작은 프록시인 mcp-remote을 통해 연결을 브리지할 수 있습니다:

{
  "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를 실행합니다. 예를 들어 nvm과 같은 버전 관리자가 레거시 프로젝트를 위해 이전 버전을 고정해 두어 기본값이 이전 Node.js인 경우, 더 새로운 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가 활성화된 셸에서 which node 및 which npx의 출력으로 바꾸세요.

사용 가능한 도구

각 도구는 연결 시 선택한 팀으로 범위가 지정되며 해당 팀에서의 기존 역할로 실행됩니다.

도구	기능
`whoami`	연결된 사용자, 팀 역할 및 플랜, 지원 ID, 대시보드 및 리소스 URL을 반환합니다.
`get-backups-overview`	단일 호출 계정 상태: 집계 개수와 실패하거나 오래된 백업의 샘플.
`list-backups`	유형, 상태, 서버, 스토리지 또는 이름으로 필터링된 페이지네이션 목록. 인라인 마지막 상태와 오류 발췌를 포함합니다.
`find-failing-backups`	구성 가능한 기간 내에 가장 최근 실행이 실패한 백업만 반환합니다.
`get-backup`	ID, 유형, 상태, 서버 및 스토리지 참조, 가장 최근 실행 상태 및 오류 발췌를 포함한 단일 백업의 간결한 요약.
`get-backup-logs`	단일 백업의 최근 실행 기록.
`get-backup-runs-timeline`	단일 호출로 여러 백업에 걸친 일별 상태 그리드로, 불안정한 날이나 패턴을 파악하는 데 유용합니다.
`get-run-output`	한 백업 실행에 대한 콘솔 출력 꼬리(stdout 및 stderr)를 반환하며, 백업 프로세스가 생성한 정확한 오류 줄을 포함합니다. 일반적인 "백업 실패"를 실제 원인으로 바꿔주는 도구입니다.
`list-storages`	유형, GB 단위 사용량, 연결 상태가 포함된 스토리지 대상(S3, B2, SFTP, Dropbox, …). 자격 증명은 절대 반환되지 않습니다.
`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 내부에 유지됩니다. 스토리지나 서버를 나열할 때도 도구 응답에는 절대 포함되지 않습니다.
API 키가 아닌 OAuth. 각 AI 클라이언트는 단일 팀으로 범위가 지정된 단기 액세스 토큰을 받습니다. 복사, 저장 또는 수동으로 교체해야 하는 장기 비밀은 없습니다.
복원 아티팩트는 공유해도 안전합니다. 복원 준비는 사용자가 직접 처리하는 안전한 아티팩트만 반환하며, 자격 증명은 AI 클라이언트로 절대 전송되지 않습니다.
권한은 대시보드 역할과 일치합니다. MCP 연결은 연결 시 선택한 팀에서의 역할과 동일하게 실행되므로, 조사 전용 팀원은 조사 전용으로 유지됩니다.
속도 제한 및 감사. 모든 호출은 호출자별로 속도가 제한되며 팀의 감사 추적에 기록됩니다. 설정 → MCP 연결에서 모든 연결이나 토큰을 해지할 수 있습니다.

[!note] 참고 액세스 해지

연결된 클라이언트가 침해되었다고 의심되는 경우 설정 → MCP 연결에서 연결을 해지하세요. 액세스 토큰은 즉시 무효화되며 클라이언트는 다시 연결하려면 재인증해야 합니다.

자주 묻는 질문

어떤 플랜에 MCP가 포함되나요?

MCP 서버는 무료 체험판과 모든 유료 요금제에 포함되어 있습니다.

어시스턴트가 제 백업 데이터 자체를 볼 수 있나요?

아니요. MCP 도구는 백업 구성, 실행 기록, 상태, 스토리지 대상 등 메타데이터만 반환하며, 백업된 파일이나 데이터베이스의 내용은 반환하지 않습니다. 유일한 예외는 restore-prep로, 이는 사용자가 직접 조치할 수 있는 안전한 복원 아티팩트를 반환합니다. 데이터 자체는 어시스턴트가 아닌 사용자가 가져옵니다.

어시스턴트가 백업이나 스토리지를 삭제할 수 있나요?

아니요. 백업 삭제, 스토리지 제거, 자격 증명 교체와 같은 파괴적인 작업은 의도적으로 MCP를 통해 노출되지 않습니다. 사용 가능한 작업은 실행, 일시 중지, 재개, 복원 준비뿐이며, 모두 되돌릴 수 있거나 읽기 전용입니다.

동일한 SimpleBackups 계정에 여러 AI 클라이언트를 연결할 수 있나요?

예. 각 클라이언트는 별도의 MCP 연결로 등록되며 자체 액세스 토큰을 받습니다. 설정 → MCP 연결에서 연결된 모든 클라이언트를 확인하고 개별적으로 해지할 수 있습니다.

연결이 작동할 팀을 선택할 수 있나요?

예. 여러 SimpleBackups 팀에 속해 있는 경우 OAuth 동의 단계에서 팀을 선택합니다. 그러면 해당 연결은 수명 동안 그 팀에 바인딩됩니다. 다른 팀에서 작동하려면 두 번째 연결을 추가하세요.

MCP 클라이언트가 OAuth를 지원하지 않으면 어떻게 하나요?

대부분의 최신 MCP 클라이언트는 동적 클라이언트 등록을 포함한 OAuth 2.1을 기본적으로 지원합니다. 지원하지 않는 경우 문의해 주시면 실행 가능한 방법을 찾도록 도와드리거나 클라이언트 지원이 따라잡을 때 알려드리겠습니다.

MCP 연결 관리 SimpleBackups 계정에 연결된 AI 클라이언트를 확인, 감사, 해지하세요.