O servidor local do Protocolo de Contexto de Modelo (MCP) do Backup e DR permite que assistentes de IA e aplicativos com tecnologia de LLM interajam com segurança com seu ambiente de backup. Ao executar o servidor localmente, você pode usar a IA generativa para gerenciar tarefas do Backup e DR, como criar backup vaults e planos de backup ou ativar notificações de alerta, usando comandos de linguagem natural e mantendo o controle sobre seu ambiente local. Saiba como usar servidores MCP para interagir com os serviços do Google Cloud .
O servidor MCP local do Backup e DR atua como uma ponte entre um host compatível com MCP (como a CLI do Gemini, o ChatGPT ou o Claude Code) e a API Google Cloud Backup e DR.
Como o servidor é executado na sua estação de trabalho, a IA pode usar suas credenciais locais e o caminho de rede para se comunicar diretamente com o Google Cloud.
O servidor MCP local de Backup e DR oferece os seguintes benefícios:
- Gerenciamento com tecnologia de IA: use comandos de linguagem natural para automatizar e simplificar tarefas complexas do Backup e DR.
- Segurança: seus dados permanecem dentro dos perímetros definidos. O servidor local usa sua autenticação atual da Google Cloud CLI.
- Solução de problemas simplificada: identifique e avise os usuários sobre falhas de jobs de backup e restauração, além de receber etapas de correção para resolver erros.
- Descoberta centralizada: interaja com vários serviços do Google Cloud , como Cloud Monitoring, Cloud Storage e BigQuery, usando o mesmo ambiente do MCP.
Antes de começar
Antes de configurar o servidor MCP local para o Backup e DR, verifique se você tem o seguinte:
- Um projeto na nuvem do Google Cloud com as APIs Backup e DR, Compute Engine e Cloud SQL ativadas.
- Um host do MCP, como a CLI do Gemini.
- Um ambiente local com o seguinte:
- Node.js (v20+)
- O SDK Google Cloud (Google Cloud CLI) inicializado e autenticado.
Permissões necessárias
Os usuários precisam de papéis e permissões relevantes do Identity and Access Management (IAM) para realizar as tarefas correspondentes usando o servidor MCP local. Exemplo:
roles/backupdr.viewer(para consultar informações e status de metadados)roles/backupdr.restoreUser(para acionar restaurações)
Configurar o servidor MCP local
Para instalar a CLI do Gemini e configurar o servidor MCP local do Backup e DR, siga estas etapas:
Instalar a CLI do Gemini
Para integrar o servidor MCP local do Backup e DR à CLI do Gemini ou ao Gemini Code Assist, execute este comando de configuração. Isso vai instalar o servidor MCP como uma extensão da CLI do Gemini para o usuário atual, disponibilizando-o para todos os seus projetos.
npm install -g @google/gemini-cliPara mais informações, consulte https://geminicli.com/docs/get-started/installation.
Configurar o servidor MCP local do Backup e DR
Para instalar o servidor MCP do Backup e DR, execute este comando. Por padrão, ele instala o servidor no nível de acesso
READ_ONLY.npx @google-cloud/backupdr-mcp init --agent=gemini-cliApós o processo de instalação, verifique se o servidor MCP do Backup e DR está configurado corretamente executando o seguinte comando:
gemini mcp listA saída vai mostrar um status semelhante a este:
> ✓ backupdr (from @google-cloud/backupdr-mcp): npx -y backupdr-mcp --access-level READ_ONLY (stdio) - ConnectedConfigurar o servidor MCP local
É possível personalizar o comportamento do servidor MCP usando as seguintes flags.
Configure o nível de acesso.
O nível de acesso controla quais ferramentas estão disponíveis para o agente de IA.
- Flag:
--access-level Valores:
READ_ONLY(padrão),UPSERT,ALLREAD_ONLY: fornece ferramentas somente leitura para descoberta e inspeção.
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=READ_ONLYUPSERT: oferece ferramentas de descoberta, inspeção, criação e atualização (incluindo restaurações).
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=UPSERTALL: fornece todas as ferramentas, incluindo operações destrutivas, como exclusão.
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --access-level=ALL
- Flag:
Configurar o arquivo de contexto
Os arquivos de contexto são um recurso eficiente para fornecer contexto instrucional ao modelo do Gemini. O servidor MCP de backup e DR vem com algumas informações de contexto sobre como usar ferramentas e fluxos de trabalho comuns.
- Flag:
--overwrite-context-file - Valores:
true,false(padrão) - Local:
~/.gemini/backupdr-mcp/GEMINI.md
Por padrão, o arquivo de contexto só é criado se ainda não existir. Para instalar o servidor MCP substituindo o arquivo de contexto, execute o seguinte comando:
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --overwrite-context-file=trueQuando
--overwrite-context-fileé definido como "false", na instalação da extensão, o contexto só será criado se ainda não existir no diretório.Para instalar o servidor MCP local sem substituir o arquivo de contexto, execute o seguinte comando:
npx @google-cloud/backupdr-mcp init --agent=gemini-cli --overwrite-context-file=falsePara mais detalhes, consulte Fornecer contexto com arquivos GEMINI.md.
Configurar a autenticação e a autorização do usuário
O servidor MCP usa o Application Default Credentials (ADC) para realizar operações. As verificações do IAM aplicáveis ao serviço de Backup e DR são realizadas no ADC. Para mais informações sobre credenciais padrão do aplicativo, consulte Configurar o Application Default Credentials.
Para configurar suas credenciais, execute o seguinte comando:
gcloud auth application-default loginPara usar credenciais de conta de serviço em vez das suas, represente uma conta de serviço usando Application Default Credentials (ADC). Execute o comando a seguir para representar uma conta de serviço:
gcloud auth application-default login --impersonate-service-account [SERVICE_ACCOUNT_EMAIL]
Ferramentas disponíveis
O servidor MCP local do Backup e DR inclui as seguintes ferramentas.
Ferramentas somente leitura
Essas ferramentas permitem a descoberta e a inspeção de recursos do Backup e DR sem permitir edições.
| Ferramenta | Descrição |
|---|---|
list_backup_vaults |
Lista todos os cofres de backup em um projeto e local. |
get_backup_vault |
Recebe detalhes de um backup vault específico. |
list_backup_plans |
Lista todos os planos de backup em um projeto e local. |
get_backup_plan |
Recebe detalhes de um plano de backup específico. |
list_backup_plan_associations |
Lista todas as associações entre planos de backup e recursos. |
get_backup_plan_association |
Recebe detalhes de uma associação de plano de backup específica. |
list_datasources |
Lista todas as fontes de dados em um backup vault. |
get_datasource |
Recebe detalhes de uma fonte de dados específica. |
list_backups |
Lista todos os backups de uma determinada fonte de dados. |
get_backup |
Recebe detalhes de um backup específico. |
find_protectable_resources |
Descobre recursos (VMs, discos, SQL) que podem ser protegidos. |
get_backupdr_operation |
Recupera o status de uma operação de longa duração do Backup e DR. |
get_csql_operation |
Recupera o status de uma operação de longa duração do Cloud SQL. |
Ferramentas de upsert
Essas ferramentas permitem criar e atualizar recursos, incluindo operações de restauração.
| Ferramenta | Descrição |
|---|---|
create_backup_vault |
Cria um novo backup vault em um local especificado. |
create_backup_plan |
Cria um novo plano de backup com regras e retenção. |
update_backup_plan |
Modifica um plano de backup. |
create_backup_plan_association |
Associa um recurso a um plano de backup. |
restore_backup |
Restaura um backup para uma instância ou disco de destino do Compute Engine. |
csql_restore |
Restaura um backup do Cloud SQL para uma instância de destino. |
Excluir ferramentas
Essas ferramentas incluem a capacidade de excluir recursos. Ative-os apenas quando
necessário, definindo o nível de acesso como ALL.
| Ferramenta | Descrição |
|---|---|
delete_backup_vault |
Exclui um backup vault. |
delete_backup_plan |
Exclui um plano de backup. |
delete_backup_plan_association |
Remove a proteção de um recurso. |
delete_backup |
Exclui um backup específico de um cofre. |
Exemplos de comandos
Depois que o servidor estiver conectado, use comandos em linguagem natural no cliente de IA para gerenciar o ambiente de backup.
Avaliar a integridade do backup em um projeto
Show the list of unprotected resources in project PROJECT_ID for region LOCATION.Substitua:
PROJECT_ID: o ID do projeto em que você quer verificar a integridade do backup.LOCATION: a região em que seus recursos estão localizados.
Criar um backup vault e um plano de backup
Create a backup vault named VAULT_NAME in LOCATION to protect resource RESOURCE_NAME using backup plan PLAN_NAME.Substitua:
VAULT_NAME: o nome do novo backup vault.LOCATION: a região em que você quer criar o cofre.RESOURCE_NAME: o nome do recurso a ser protegido.PLAN_NAME: o nome do plano de backup a ser aplicado.
Auditar backups para conformidade
Audit all backups in the project PROJECT_ID in the region LOCATION. Once the audit is complete, compare the findings against my corporate backup policy to identify any compliance gaps.Substitua:
PROJECT_ID: o ID do projeto a ser auditado.LOCATION: a região a ser auditada.
Análise da causa raiz para falhas
Esse comando requer a ferramenta
observability. Para instalar essa ferramenta MCP, consulte Ferramentas MCP disponíveis no GitHub.Identify and investigate the root cause of the resource RESOURCE_NAME backup failure in the last DURATION days in project PROJECT_ID.Substitua:
RESOURCE_NAME: o nome do recurso com falhas de backup.DURATION: o período da investigação (por exemplo,7).PROJECT_ID: o ID do projeto em que a falha ocorreu.
Restaurar um backup
Restore the last successful backup for resource RESOURCE_NAME from project PROJECT_ID. Name the restored instance NEW_INSTANCE_NAME.Substitua:
RESOURCE_NAME: o nome do recurso a ser restaurado.PROJECT_ID: o ID do projeto que contém o backup.NEW_INSTANCE_NAME: um nome para a instância restaurada.
Criar uma política de alertas
É possível ativar alertas para qualquer combinação de registros e filtros adicionados.
Esse comando requer a ferramenta
gcloud. Para instalar essa ferramenta MCP, consulte Ferramentas MCP disponíveis no GitHub.Create a log-based alert policy named ALERT_NAME to trigger on any log entry from `backupdr.googleapis.com` with severity `ERROR`. Send notification of the alerts immediately to EMAIL_ADDRESS.Substitua:
ALERT_NAME: um nome para a nova política de alertas.EMAIL_ADDRESS: o e-mail para receber notificações.
Acessar o servidor usando outros clientes de IA
É possível usar o servidor MCP do Backup e DR com outros clientes.
Para fazer isso, adicione o snippet a seguir aos respectivos arquivos de configuração JSON:
"backupdr": { "command": "npx", "args": ["-y", "@google-cloud/backupdr-mcp"] }
Instruções para ferramentas conhecidas:
- Claude para computador: abra o Claude > Configurações > Desenvolvedor > Editar configuração e
edite
claude_desktop_config.json. - Cline: clique no ícone "Servidores MCP" e em "Configurar servidores MCP" para editar
cline_mcp_settings.json. - Cursor: edite
.cursor/mcp.jsonpara um único projeto ou~/.cursor/mcp.jsonpara todos os projetos. CLI do Gemini (configuração manual): se você não estiver usando extensões, edite
.gemini/settings.jsonpara um único projeto ou~/.gemini/settings.jsonpara todos os projetos.Para o Visual Studio Code, edite o arquivo
.vscode/mcp.jsonno seu espaço de trabalho para um único projeto ou o arquivo de configurações globais do usuário para todos os projetos:"servers": { "backupdr": { "command": "npx", "args": ["-y", "@google-cloud/backupdr-mcp"] } }
Exoneração de responsabilidade
As operações assistidas por IA ainda estão evoluindo. Embora priorizemos a precisão, lembre-se de que as saídas baseadas em modelos podem incluir imprecisões e sempre precisam ser revisadas para garantir a correção.
A seguir
- Saiba mais sobre os servidores MCP doGoogle Cloud .
- Consulte a documentação da CLI do Gemini.
- Saiba mais sobre o Application Default Credentials.