# MCP Server

O BackupAlly inclui um servidor MCP (Model Context Protocol) que permite integração com assistentes de IA como Claude.

# O que é MCP?

O Model Context Protocol é um padrão aberto para comunicação entre aplicações e modelos de linguagem. Permite que assistentes de IA:

• Acessem informações do sistema em tempo real
• Executem operações guiadas
• Forneçam assistência contextualizada

# Funcionalidades

O MCP Server do BackupAlly oferece:

# Resources

Fornecem informações sobre o sistema:

• Estáticos: Documentação e instruções
• Dinâmicos: Configuração atual, status, histórico

# Prompts

Workflows guiados para:

• Criar planos de backup
• Diagnosticar problemas
• Configurar targets
• Definir agendamentos

# Configuração

# Habilitar MCP Server

Adicione ao config.toml:

[mcp]
enabled = true
socket_path = "/var/run/backupally/mcp.sock"

# Configurar no Claude Desktop

Adicione ao arquivo de configuração do Claude Desktop (~/.config/claude/config.json):

{
  "mcpServers": {
    "backupally": {
      "command": "backupally",
      "args": ["mcp", "serve"],
      "env": {
        "BACKUPALLY_CONFIG": "/etc/backupally/config.toml"
      }
    }
  }
}

# Configurar no Claude Code

Adicione ao arquivo de configuração do projeto (.claude/settings.json):

{
  "mcpServers": {
    "backupally": {
      "command": "backupally",
      "args": ["mcp", "serve"]
    }
  }
}

# Uso com Claude

Após configurar, o assistente pode:

# Consultar Status

"Qual o status atual dos backups?"

O assistente acessa backupally://scheduler/status e backupally://history/recent.

# Criar Backup

"Preciso configurar backup do MySQL de produção"

O assistente usa o prompt configure_target para guiar a configuração.

# Diagnosticar Problemas

"O backup do MongoDB está falhando"

O assistente usa backupally://instructions/troubleshooting e o prompt diagnose_issue.

# Arquitetura

Claude/AI Assistant
       ↓
   MCP Protocol (JSON-RPC over stdio)
       ↓
BackupAlly MCP Server
       ↓
┌──────────────────────────────────┐
│  Resources    │    Prompts       │
│  (read-only)  │    (workflows)   │
└──────────────────────────────────┘
       ↓
BackupAlly Core (config, scheduler, history)

# Segurança

• MCP Server executa com as mesmas permissões do BackupAlly
• Secrets são sanitizados antes de exposição
• Operações destrutivas requerem confirmação
• Logs de todas as operações MCP

# Comandos MCP

# Iniciar Servidor MCP

backupally mcp serve

# Verificar Status

backupally mcp status

# Listar Resources

backupally mcp resources

# Listar Prompts

backupally mcp prompts

# Próximos Passos

• Resources Disponíveis - Lista completa de recursos
• Prompts Disponíveis - Workflows guiados