# Referência CLI

Sintaxe geral:

mpm [FLAGS GLOBAIS] <comando> [subcomando] [args]

# Flags globais

Valem para qualquer comando.

# init

Cria config.toml interativamente.

mpm init

# instance

Gerencia instâncias (containers Mautic).

mpm instance add <nome> --container <docker> --mautic-version <4|5|6|7> [--url <url>]
mpm instance list
mpm instance status <nome>
mpm instance discover            # acha containers Mautic rodando
mpm instance remove <nome>

# catalog

Navega o catálogo de plugins licenciados.

mpm catalog refresh              # atualiza o cache local
mpm catalog search <query>       # busca por nome ou tag
mpm catalog info <plugin>        # detalhes de um plugin

# install

Instala um plugin (pipeline de 14 etapas com rollback).

mpm install <plugin> -i <instance> [--version <x>] [--from-file <zip>] [--force]

• --version — fixa uma versão (default: latest).
• --from-file — instala de um ZIP local em vez do CDN.
• --force — instala mesmo com falhas de validação.

# update

Atualiza um plugin ou todos.

mpm update <plugin|all> -i <instance> [--force]

# remove / rollback

mpm remove <plugin> -i <instance>      # remove o plugin
mpm rollback <plugin> -i <instance>    # restaura o backup anterior

# list / check / status

mpm list -i <instance> [--upgradable]  # o que está instalado
mpm check -i <instance|all>            # há updates?
mpm status <plugin> -i <instance>      # estado detalhado de um plugin

# console

Roda um comando do Mautic dentro do container.

mpm console -i <instance> -- <args do bin/console>
# ex.: mpm console -i prod -- cache:clear

# configure

Ajusta settings de um plugin.

mpm configure <plugin> -i <instance> [--set key=value]... [--saas-config <arquivo.json>]

# validate

Valida um ZIP de plugin sem instalar.

mpm validate <plugin.zip> [--mautic-version <n>]

# report

Inventário (cron-friendly).

mpm report generate -i <instance>
mpm report send -i <instance> --webhook <url>

# self-update

Atualiza o próprio mpm.

mpm self-update [--check] [--force] [--channel <stable|rc>]

# mcp

Integração com o Claude Code via MCP.

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