MepMail Docs

Pacotes npm

Os pacotes que o MepMail publica no npm — @mepmail/mcp, @mepmail/cli e o nó do n8n — o que cada um faz e como instalar.

O MepMail publica três pacotes npm. Nenhum é um SDK: a API fala o protocolo do Resend, então enviar e-mail significa usar os SDKs oficiais do Resend apontados para a origem da sua instância (SDKs). Estes cobrem o que aqueles SDKs não fazem — rodar MCP localmente, mover uma conta de provedor e ligar o MepMail ao n8n.

PacoteVersão-fonteNodePapel
@mepmail/mcp0.3.2>=2022 ferramentas da equipe e 6 de caixas Correio, conforme a credencial. Guia.
@mepmail/cli0.2.4>=18Migração de contas com plano, aplicação e relatório. Guia.
n8n-nodes-mepmailConsultar npmn8nWorkflows de envio e caixas Correio. Guia.

O MCP hospedado desta revisão é 0.71.1, com 79 ferramentas anunciadas no server card. A ferramenta adicional list_teams só aparece em grants de todas as equipes. Escopos e permissões podem reduzir a lista efetiva.

Esses valores são gerados dos manifests dos pacotes e registros de ferramentas na revisão-fonte das docs. Os pacotes npm têm ciclo próprio: consulte os links do registro para a versão publicada e confira tools/list no cliente que você usa. Uma versão do código não publica automaticamente um novo pacote npm. O pacote n8n vive em repositório separado e se instala pelo próprio n8n (Settings → Community nodes).

@mepmail/mcp — o servidor MCP local

npx -y @mepmail/mcp

Ele fala stdio, então o seu cliente é quem o inicia e o bloco de configuração é a instalação inteira:

claude_desktop_config.json
{
  "mcpServers": {
    "mepmail": {
      "command": "npx",
      "args": ["-y", "@mepmail/mcp"],
      "env": {
        "MEPMAIL_API_KEY": "ms_...",
        "MEPMAIL_BASE_URL": "https://api.mepmail.dev"
      }
    }
  }
}
VariávelObrigatóriaPadrãoSignificado
MEPMAIL_API_KEYpara ferramentas da equipe—Chave de API do time (ms_...) de Chaves de API no painel. As ferramentas agem com o alcance dessa chave. Pode ser omitida em cliente somente de caixa postal.
MEPMAIL_BASE_URLnãohttps://api.mepmail.devOrigem da API da sua instância. Defina em uma implantação auto-hospedada.
MEPMAIL_MAIL_TOKENpara ferramentas de caixa—Chave de agente Correio (mmb_... para uma caixa ou mmt_... para as caixas selecionadas pela credencial de equipe). Funciona sem chave de API da equipe.
MEPMAIL_MAIL_ORIGINnãohttps://mepmail.devOrigem do painel que serve o Correio. Defina para o serviço de caixas auto-hospedado.

Em um cliente somente de caixa, substitua MEPMAIL_API_KEY na configuração acima por MEPMAIL_MAIL_TOKEN. Ferramentas da equipe usam a origem da API; ferramentas de caixa usam a origem do painel. Ambas autenticam diretamente com a própria chave limitada ao seu escopo, sem OAuth no navegador. A configuração para Claude Desktop, Cursor e VS Code e a lista completa do servidor hospedado estão na página de MCP.

@mepmail/cli — a CLI de migração

npx @mepmail/cli migrate --from resend

Esse é o caminho interativo: conecta ao Resend, permite escolher os recursos, mostra o plano, pede confirmação, aplica e imprime um relatório. Para CI, rode primeiro o plano somente leitura — código de saída 2 significa que há algo a aplicar:

export RESEND_API_KEY=re_...
export MEPMAIL_API_KEY=ms_...

npx @mepmail/cli migrate plan --from resend --out plan.json
npx @mepmail/cli migrate apply plan.json --yes
VariávelSignificado
RESEND_API_KEYChave de origem, acesso total. A ferramenta só lê do Resend.
MEPMAIL_API_KEYChave do MepMail, acesso total.
MEPMAIL_BASE_URLOrigem da API de uma instância auto-hospedada. Sem ela, o alvo é o MepMail Cloud.

As chaves vêm do ambiente (ou do stdin), nunca são gravadas em disco e são mascaradas em toda linha de log. Todas as flags, os arquivos de estado e os códigos de saída estão na página da CLI.

Licença e releases

Os dois pacotes são licenciados em MIT e são publicados do mesmo repositório do servidor, com linha de versão própria. Nenhum dos dois liga para casa: sem telemetria, sem checagem de atualização.

Nesta página