O que é o mpm
O mpm (Mautic Plugin Manager) é um binário único, escrito em Rust, que
gerencia o ciclo de vida de plugins licenciados do marketplace MTC Codes
em instâncias Mautic. Ele conversa com o container Docker do Mautic via
docker exec/docker cp e com a Delivery API (mng.mtc.codes) para
resolver, baixar e validar os plugins.
Por que existe
Instalar um plugin Mautic à mão tem muitos passos: baixar o ZIP, extrair no diretório certo, ajustar permissões, limpar e aquecer o cache, rodar as migrações Doctrine, recarregar os plugins e conferir se o site continua de pé. Errar a ordem deixa o Mautic fora do ar. O mpm faz tudo isso numa transação com backup e rollback.
Funções principais
| Função | Comando | O que faz |
|---|---|---|
| Instalar mpm | init.sh |
Baixa o binário e cria config.toml |
| Registrar instância | instance add |
Vincula um container Docker a um nome |
| Descobrir instâncias | instance discover |
Acha containers Mautic rodando |
| Navegar catálogo | catalog search/info |
Lista plugins que você tem direito |
| Instalar plugin | install |
Pipeline de 14 etapas com rollback |
| Atualizar plugin | update |
Um plugin ou all |
| Remover/voltar | remove / rollback |
Tira o plugin ou volta o backup |
| Inventário | list / status |
O que está instalado e em qual versão |
| Conferir updates | check |
Compara instalado vs catálogo |
| Console do Mautic | console |
Roda bin/console dentro do container |
| Relatório | report |
Gera/envia inventário (cron-friendly) |
| Auto-update | self-update |
Atualiza o próprio mpm |
| Integração Claude | mcp serve |
Servidor MCP para o Claude Code |
Detalhe de cada um na Referência CLI.
O pipeline de install (14 etapas)
Toda instalação passa por estas etapas. As que tocam o container só rodam depois do backup — antes disso, qualquer falha aborta sem efeito.
PRÉ-INSTALL (valida antes de tocar no container)
1. RESOLVE origem (API ou arquivo local)
2. VALIDATE compatibilidade de versão Mautic/PHP
3. DOWNLOAD baixa o ZIP do CDN (signed URL)
4. VERIFY checksum SHA256
5. EXTRACT descompacta em diretório temporário
6. INSPECT 10 checagens (bundle, namespace, config.php, migrações...)
INSTALL (ponto sem volta — backup ANTES)
7. BACKUP copia o plugin existente pra fora
8. DEPLOY copia os arquivos novos pra dentro
9. PERMISSIONS chown + chmod
PÓS-INSTALL (ativa o plugin no Mautic)
10. CACHE rm -rf var/cache/prod
11. WARMUP cache:warmup --env=prod
12. MIGRATE doctrine:migration:migrate
13. RELOAD mautic:plugins:reload
14. HEALTHCHECK HTTP + checagem de logSe a etapa 8+ falhar, o mpm restaura o backup da etapa 7 automaticamente.
O que ele NÃO faz
- Não substitui o painel web do Mautic.
- Não instala o próprio Mautic nem gerencia o banco fora das migrações do plugin.
- Não publica plugins (isso é o GitOps Worker no lado do marketplace).
- Não funciona sem uma API key válida e licença ativa.