Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

백업 및 DR 로컬 MCP 서버 사용

백업 및 DR 로컬 모델 컨텍스트 프로토콜 (MCP) 서버를 사용하면 AI 어시스턴트와 LLM 기반 애플리케이션이 백업 환경과 안전하게 상호작용할 수 있습니다. 서버를 로컬에서 실행하면 생성형 AI를 사용하여 백업 Vault 및 백업 계획 만들기 또는 알림 사용 설정과 같은 백업 및 DR 작업을 자연어 프롬프트를 사용하여 관리하면서 로컬 환경을 제어할 수 있습니다. MCP 서버를 사용하여 서비스 Google Cloud 전반에서 상호작용하는 방법을 자세히 알아보세요.

백업 및 DR 로컬 MCP 서버는 MCP 호환 호스트 (예: Gemini CLI, ChatGPT 또는 Claude Code)와 Google Cloud 백업 및 DR API 간의 브리지 역할을 합니다.

서버가 워크스테이션에서 실행되므로 AI는 로컬 사용자 인증 정보와 네트워크 경로를 사용하여 와 직접 통신할 수 있습니다. Google Cloud

백업 및 DR 로컬 MCP 서버는 다음과 같은 혜택을 제공합니다.

AI 기반 관리: 자연어 프롬프트를 사용하여 복잡한 백업 및 DR 작업을 자동화하고 간소화합니다.
보안: 데이터가 정의된 경계 내에 유지됩니다. 로컬 서버는 기존 gcloud CLI 인증을 사용합니다.
문제 해결 간소화: 백업 및 복원 작업 실패를 식별하고 사용자에게 알리며 오류를 수정하기 위한 해결 단계를 가져옵니다.
중앙 집중식 검색: 동일한 MCP 환경을 사용하여 Cloud Monitoring, Cloud Storage, BigQuery와 같은 여러 Google Cloud 서비스에서 상호작용합니다.

시작하기 전에

백업 및 DR의 로컬 MCP 서버를 설정하기 전에 다음이 있는지 확인하세요.

백업 및 DR, Compute Engine, Cloud SQL API가 사용 설정된 Google Cloud 프로젝트
MCP 호스트(예: Gemini CLI)
다음이 포함된 로컬 환경 :
- Node.js (v20 이상)
- 초기화되고 인증된 Google Cloud SDK (gcloud CLI)

필수 권한

사용자는 로컬 MCP 서버를 사용하여 해당 작업을 수행하는 데 필요한 Identity and Access Management (IAM) 역할 및 권한이 필요합니다. 예를 들면 다음과 같습니다.

roles/backupdr.viewer (메타데이터 정보 및 상태를 쿼리)
roles/backupdr.restoreUser (복원 트리거)

로컬 MCP 서버 설정

Gemini CLI를 설치하고 백업 및 DR 로컬 MCP 서버를 설정하려면 다음 단계를 따르세요.

Gemini CLI 설치

백업 및 DR 로컬 MCP 서버를 Gemini CLI 또는 Gemini Code Assist와 통합하려면 이 설정 명령어를 실행합니다. 이렇게 하면 MCP 서버가 현재 사용자의 Gemini CLI 확장 프로그램으로 설치되어 모든 프로젝트에서 사용할 수 있게 됩니다.
```
npm install -g @google/gemini-cli
```
자세한 내용은 https://geminicli.com/docs/get-started/installation을 참고하세요.
백업 및 DR 로컬 MCP 서버 설정

백업 및 DR MCP 서버를 설치하려면 이 명령어를 실행합니다. 기본적으로 서버는 READ_ONLY 액세스 수준으로 설치됩니다.
```
npx @google-cloud/backupdr-mcp init --agent=gemini-cli
```
설치 프로세스가 끝나면 다음 명령어를 실행하여 백업 및 DR MCP 서버가 올바르게 구성되었는지 확인할 수 있습니다.
```
gemini mcp list
```
출력은 다음과 비슷한 상태를 표시해야 합니다.
```
> ✓ backupdr (from @google-cloud/backupdr-mcp): npx -y backupdr-mcp --access-level READ_ONLY (stdio) - Connected
```
로컬 MCP 서버 구성

다음 플래그를 사용하여 MCP 서버 동작을 맞춤설정할 수 있습니다.
1. 액세스 수준을 구성합니다.
  
  액세스 수준은 AI 에이전트에서 사용할 수 있는 도구를 제어합니다.
  - 플래그: --access-level
  - 값: READ_ONLY (기본값), UPSERT, ALL
  - READ_ONLY: 검색 및 검사를 위한 읽기 전용 도구를 제공합니다.
```
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=READ_ONLY
```
  - UPSERT: 복원을 포함한 검색, 검사, 생성, 업데이트 도구를 제공합니다.
```
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=UPSERT
```
  - ALL: 삭제와 같은 파괴적인 작업을 포함한 모든 도구를 제공합니다.
```
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=ALL
```
2. 환경설정 파일 구성
컨텍스트 파일은 Gemini 모델에 지침 컨텍스트를 제공하는 강력한 기능입니다. 백업 및 DR MCP 서버에는 도구 및 일반적인 워크플로를 사용하는 방법에 관한 컨텍스트 정보가 포함되어 있습니다.
- 플래그: --overwrite-context-file
- 값: true, false (기본값)
- 위치: ~/.gemini/backupdr-mcp/GEMINI.md
기본적으로 환경설정 파일은 아직 없는 경우에만 생성됩니다. 환경설정 파일을 덮어쓰는 방식으로 MCP 서버를 설치하려면 다음 명령어를 실행합니다.
```
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --overwrite-context-file=true
```
--overwrite-context-file이 false로 설정된 경우 확장 프로그램 설치 시 컨텍스트는 디렉터리에 아직 없는 경우에만 생성됩니다.

환경설정 파일을 덮어쓰지 않고 로컬 MCP 서버를 설치하려면 다음 명령어를 실행합니다.
```
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --overwrite-context-file=false
```
자세한 내용은 GEMINI.md 파일로 컨텍스트 제공을 참고하세요.
사용자 인증 및 승인 구성

MCP 서버는 애플리케이션 기본 사용자 인증 정보 (ADC)를 사용하여 작업을 수행합니다. 백업 및 DR에 적용되는 IAM 검사는 ADC에서 실행됩니다. 애플리케이션 기본 사용자 인증 정보에 대한 자세한 내용은 애플리케이션 기본 사용자 인증 정보 설정을 참고하세요.
1. 사용자 인증 정보를 구성하려면 다음 명령어를 실행합니다.
```
gcloud auth application-default login
```
2. 자체 사용자 인증 정보 대신 서비스 계정 사용자 인증 정보를 사용하려면 애플리케이션 기본 사용자 인증 정보 (ADC)를 사용하여 서비스 계정을 가장합니다. 다음 명령어를 실행하여 서비스 계정을 가장합니다.
```
gcloud auth application-default login --impersonate-service-account [SERVICE_ACCOUNT_EMAIL]
```
  참고: 서비스 계정을 사용하려면 서비스 계정에 서비스 계정 토큰 생성자 역할 (roles/iam.serviceAccountTokenCreator)이 있어야 합니다. MCP 서버를 사용하여 수행하려는 작업에 필요한 IAM 역할은 서비스 계정에 할당되어야 합니다.

사용 가능한 도구

백업 및 DR 로컬 MCP 서버에는 다음 도구가 포함되어 있습니다.

읽기 전용 도구

이러한 도구를 사용하면 수정은 허용하지 않고 백업 및 DR 리소스를 검색하고 검사할 수 있습니다.

도구	설명
`list_backup_vaults`	프로젝트 및 위치의 모든 백업 Vault를 나열합니다.
`get_backup_vault`	특정 Backup Vault의 세부정보를 가져옵니다.
`list_backup_plans`	프로젝트 및 위치의 모든 백업 계획을 나열합니다.
`get_backup_plan`	특정 백업 계획의 세부정보를 가져옵니다.
`list_backup_plan_associations`	백업 계획과 리소스 간의 모든 연결을 나열합니다.
`get_backup_plan_association`	특정 백업 계획 연결의 세부정보를 가져옵니다.
`list_datasources`	Backup Vault 내의 모든 데이터 소스를 나열합니다.
`get_datasource`	특정 데이터 소스의 세부정보를 가져옵니다.
`list_backups`	지정된 데이터 소스의 모든 백업을 나열합니다.
`get_backup`	특정 백업의 세부정보를 가져옵니다.
`find_protectable_resources`	보호할 수 있는 리소스 (VM, 디스크, SQL)를 검색합니다.
`get_backupdr_operation`	장기 실행 백업 및 DR 작업의 상태를 가져옵니다.
`get_csql_operation`	장기 실행 Cloud SQL 작업의 상태를 가져옵니다.

Upsert 도구

이러한 도구를 사용하면 복원 작업을 포함하여 리소스를 만들고 업데이트할 수 있습니다.

도구	설명
`create_backup_vault`	지정된 위치에 새 Backup Vault를 만듭니다.
`create_backup_plan`	규칙 및 보관이 포함된 새 백업 계획을 만듭니다.
`update_backup_plan`	기존 백업 계획을 수정합니다.
`create_backup_plan_association`	리소스를 백업 계획과 연결합니다.
`restore_backup`	백업을 대상 Compute Engine 인스턴스 또는 디스크로 복원합니다.
`csql_restore`	Cloud SQL 백업을 대상 인스턴스로 복원합니다.

삭제 도구

이러한 도구에는 리소스를 삭제하는 기능이 포함되어 있습니다. 액세스 수준을 ALL로 설정하여 필요한 경우에만 사용 설정합니다.

도구	설명
`delete_backup_vault`	백업 Vault를 삭제합니다.
`delete_backup_plan`	백업 계획을 삭제합니다.
`delete_backup_plan_association`	리소스에서 보호를 삭제합니다.
`delete_backup`	Vault에서 특정 백업을 삭제합니다.

프롬프트 예시

서버가 연결되면 AI 클라이언트에서 자연어 프롬프트를 사용하여 백업 환경을 관리할 수 있습니다.

프로젝트 전반의 백업 상태 평가

'리전 LOCATION의 프로젝트 PROJECT_ID에서 보호되지 않은 리소스 목록을 표시해 줘.'

다음을 바꿉니다.
- PROJECT_ID: 백업 상태를 확인하려는 프로젝트 ID입니다.
- LOCATION: 리소스가 있는 리전입니다.
Backup Vault 및 백업 계획 만들기

PLAN_NAME 백업 계획을 사용하여 RESOURCE_NAME 리소스를 보호하기 위해 LOCATION에 VAULT_NAME이라는 Backup Vault를 만들어 줘.

다음을 바꿉니다.
- VAULT_NAME: 새 Backup Vault의 이름입니다.
- LOCATION: Vault를 만들려는 리전입니다.
- RESOURCE_NAME: 보호할 리소스의 이름입니다.
- PLAN_NAME: 적용할 백업 계획의 이름입니다.
규정 준수를 위한 백업 감사

'리전 LOCATION의 프로젝트 PROJECT_ID에서 모든 백업을 감사해 줘. 감사가 완료되면 결과를 회사 백업 정책과 비교하여 규정 준수 격차를 파악해 줘.'

다음을 바꿉니다.
- PROJECT_ID: 감사할 프로젝트 ID입니다.
- LOCATION: 감사할 리전입니다.
실패의 근본 원인 분석

이 프롬프트에는 observability 도구가 필요합니다. 이 MCP 도구를 설치하려면 GitHub에서 사용 가능한 MCP 도구 를 참고하세요.

'프로젝트 PROJECT_ID에서 지난 DURATION일 동안 리소스 RESOURCE_NAME 백업 실패의 근본 원인을 파악하고 조사해 줘.'

다음을 바꿉니다.
- RESOURCE_NAME: 백업 실패가 있는 리소스의 이름입니다.
- DURATION: 조사 기간입니다 (예: 7).
- PROJECT_ID: 실패가 발생한 프로젝트 ID입니다.
백업 복원

'프로젝트 PROJECT_ID에서 리소스 RESOURCE_NAME의 마지막으로 성공한 백업을 복원해 줘. 복원된 인스턴스 이름을 NEW_INSTANCE_NAME으로 지정해 줘."

다음을 바꿉니다.
- RESOURCE_NAME: 복원할 리소스의 이름입니다.
- PROJECT_ID: 백업이 포함된 프로젝트 ID입니다.
- NEW_INSTANCE_NAME: 복원된 인스턴스의 이름입니다.
알림 정책 만들기

로그와 추가된 필터의 조합에 대해 알림을 사용 설정할 수 있습니다.

이 프롬프트에는 gcloud 도구가 필요합니다. 이 MCP 도구를 설치하려면 GitHub에서 사용 가능한 MCP 도구 를 참고하세요.

"심각도 ERROR의 backupdr.googleapis.com 로그 항목에서 트리거되는 ALERT_NAME이라는 로그 기반 알림 정책을 만들어 줘. 알림 알림을 EMAIL_ADDRESS로 즉시 보내 줘."

다음을 바꿉니다.
- ALERT_NAME: 새 알림 정책의 이름입니다.
- EMAIL_ADDRESS: 알림을 수신할 이메일입니다.

다른 AI 클라이언트를 사용하여 서버에 액세스

다른 클라이언트와 함께 백업 및 DR MCP 서버를 사용할 수 있습니다.

이렇게 하려면 다음 스니펫을 각 JSON 구성 파일에 추가합니다.

"backupdr": {
  "command": "npx",
  "args": ["-y", "@google-cloud/backupdr-mcp"]
}

많이 사용되는 도구의 안내:

Claude Desktop: Claude > 설정 > 개발자 > 구성 수정을 열고 claude_desktop_config.json을(를) 수정합니다.
Cline: MCP 서버 아이콘을 클릭한 다음 MCP 서버 구성을 클릭하여 cline_mcp_settings.json을(를) 수정합니다.
커서: 단일 프로젝트의 경우 .cursor/mcp.json를 수정하고 모든 프로젝트의 경우 ~/.cursor/mcp.json를 수정합니다.
Gemini CLI (수동 설정): 확장 프로그램을 사용하지 않는 경우 단일 프로젝트의 경우 .gemini/settings.json을 수정하고 모든 프로젝트의 경우 ~/.gemini/settings.json 을 수정합니다.
Visual Studio Code의 경우 단일 프로젝트의 경우 작업공간에서 .vscode/mcp.json 파일을 수정하고 모든 프로젝트의 경우 전역 사용자 설정 파일을 수정합니다.
```
"servers": {
  "backupdr": {
    "command": "npx",
    "args": ["-y", "@google-cloud/backupdr-mcp"]
  }
}
```

면책조항

AI 지원 작업은 아직 발전하고 있습니다. Google은 정확성을 우선시하지만 모델 기반 출력에 부정확한 내용이 포함될 수 있으며 항상 정확성을 검토해야 합니다.

다음 단계

Google Cloud MCP 서버에 대해 자세히 알아보세요.
Gemini CLI 문서를 참고하세요.
애플리케이션 기본 사용자 인증 정보에 대해 자세히 알아보세요.