# FAQ

Perguntas frequentes sobre o mpm.

# Geral

# O que é o mpm?

O mpm (Mautic Plugin Manager) é um CLI em Rust que instala, atualiza e remove plugins licenciados do marketplace MTC Codes dentro de instâncias Mautic em Docker. Ele cuida de download, validação, backup, deploy, cache, migrações e reativação — com rollback.

# Preciso de Docker?

Sim. O mpm fala com o Mautic via docker exec e docker cp. Ele roda no host, não dentro do container.

# Funciona sem internet?

Não para instalar do catálogo (precisa baixar do CDN). Mas você pode instalar de um ZIP local com --from-file.

# Posso usar em produção?

Sim. Toda instalação faz backup antes de tocar no container e reverte em caso de falha no deploy.

# Qual a diferença pro composer?

O composer instala dependências PHP do projeto. O mpm gerencia plugins licenciados do marketplace, com controle de licença, fingerprint e o pipeline completo de ativação no Mautic.

# Instalação e atualização

# Onde fica o binário e a config?

Binário em /opt/mpm/mpm (symlink /usr/local/bin/mpm). Config em /opt/mpm/config.toml.

# Como atualizo o mpm?

mpm self-update                # estável
mpm self-update --channel rc   # release candidate

# Instalei com `--api-key` mas a key não foi gravada

Isso era um bug em versões antigas quando o config.toml já existia. Corrigido: o instalador agora grava/atualiza a key num config existente. Atualize com mpm self-update.

# Como passo a API key?

Em ordem de precedência: flag --api-key, env MPM_API_KEY, vault cnf dentro do Mautic, ou config.toml. Ver API key e fingerprint.

# Instâncias

# O que é um "instance"?

Um apelido para um container Docker do Mautic. Registre com mpm instance add e referencie com -i <nome>.

# Tenho vários Mautics no mesmo servidor

Registre cada um como uma instância e use -i para escolher, ou -i all em check. Use mpm instance discover para achar os containers.

# Qual versão Mautic devo informar?

A real (4, 5, 6, 7). Ela define os defaults de console e plugins. Versão errada pode apontar paths errados.

# Plugins

# Instalei mas não aparece no Mautic

Quase sempre é o layout docroot (Mautic 5/6 composer): o plugin foi pra um diretório que o Mautic não lê. Desde a v0.2.1 o mpm detecta e corrige sozinho. Atualize o mpm e reinstale. Detalhes em Layout do Mautic.

# Plugin falhou na validação por "Missing fields: name, version"

Bug de versões antigas: o validador não reconhecia config.php com aspas duplas. Corrigido na v0.2.1. Atualize o mpm. Como último recurso, --force ignora a validação.

# Posso instalar um ZIP que não está no catálogo?

Sim: mpm install <nome> -i <instance> --from-file ./plugin.zip.

# Como volto uma atualização ruim?

mpm rollback <plugin> -i <instance> restaura o backup da última operação.

# O que o `--force` faz?

Pula as falhas de validação e instala mesmo assim. Use só quando souber que o aviso é benigno (ex.: um WARN de isEnabled()).

# Saída e automação

# Tem saída em JSON?

Sim: -o json (ou -o yaml) em qualquer comando. Bom para cron e scripts.

# Dá pra integrar com o Claude Code?

Sim, via MCP: mpm mcp install registra a config e mpm mcp serve inicia o servidor.

# Segurança

# Por que minha key foi revogada?

A key é presa a uma instalação no primeiro uso (fingerprint). Usá-la em outro ambiente revoga permanentemente. Use uma key por instalação. Ver API key e fingerprint.

# O que significa erro 426?

fingerprint_required: seu mpm é antigo e não envia o header de fingerprint. Rode mpm self-update.