# Casos de uso

Receitas prontas para os cenários mais comuns. Todos pressupõem o mpm instalado e uma instância registrada como prod.

# 1. Subir um cliente novo do zero

Servidor recém-provisionado, Mautic já rodando em Docker.

curl -sL https://mpm.mtc.codes/init.sh | sudo bash -s -- --api-key mpm_live_xxx
mpm instance add prod --container mautic_app --mautic-version 6 --url https://cliente.com.br
mpm catalog refresh
mpm install queryreport -i prod
mpm install consolelog -i prod
mpm list -i prod

# 2. Instalar um pacote de plugins do cliente

Vários plugins de uma vez, conferindo cada um.

for p in queryreport consolelog customtokens suppressionlist; do
  mpm install "$p" -i prod || echo "FALHOU: $p"
done
mpm list -i prod

# 3. Manutenção mensal — atualizar tudo

mpm catalog refresh
mpm check -i prod            # mostra o que tem update
mpm update all -i prod       # atualiza todos

Cada update faz backup antes; se um falhar, ele volta sozinho e os outros seguem.

# 4. Plugin quebrou — voltar pra versão anterior

mpm rollback queryreport -i prod
mpm status queryreport -i prod

O rollback restaura o backup criado na última instalação/atualização.

# 5. Testar um ZIP antes de publicar

Validação local, sem tocar em nenhuma instância.

mpm validate ./QueryReportBundle.zip --mautic-version 6

Mostra as 10 checagens (bundle, namespace, config.php, migrações, arquivos perigosos). Útil pra quem desenvolve plugin.

# 6. Instalar de um arquivo local (sem CDN)

Build de desenvolvimento ou plugin fora do catálogo.

mpm install meuplugin -i prod --from-file ./MeuPluginBundle.zip

# 7. Fixar uma versão específica

mpm install queryreport -i prod --version 6.3.4

# 8. Rodar um comando do Mautic sem entrar no container

mpm console -i prod -- cache:clear
mpm console -i prod -- mautic:segments:update
mpm console -i prod -- doctrine:query:sql "SELECT bundle FROM plugins"

# 9. Inventário para auditoria/cron

mpm report generate -i prod
mpm report send -i prod --webhook https://hooks.exemplo.com/xyz
mpm list -i prod -o json          # saída para máquina

# 10. Vários Mautics no mesmo host

mpm instance discover
mpm instance add cliente_a --container mautic_a --mautic-version 6
mpm instance add cliente_b --container mautic_b --mautic-version 5
mpm check -i all                  # checa updates em todas

# 11. Frota — atualizar via MCP/Claude Code

O mpm expõe um servidor MCP para automação assistida:

mpm mcp install      # registra no Claude Code
mpm mcp serve        # inicia o servidor (stdio JSON-RPC)