GoodSender
Um servidor MCP local gratuito e baseado em consentimento para envio de e-mails em texto simples, HTML e Markdown, além de templates transacionais, com tratamento automático de consentimento do destinatário.
Documentação
Recursos
- 🛡️ Servidor local
- Conteúdos de e-mail, templates personalizados, grupos de destinatários e identidades de remetente são armazenados apenas na sua máquina.
- ✉️ Envie e-mails em texto simples, HTML ou Markdown para um ou mais destinatários.
- ✅ Envie e-mails transacionais sem consentimento usando templates integrados (OTP, MFA, Conclusão de Pedido, etc.)
- 🤝 Fluxo de consentimento automático.
- Destinatários adicionados via MCP recebem o e-mail de consentimento.
- E-mails são enfileirados localmente até que o destinatário conceda o consentimento para recebê-los.
- 📝 Crie, edite e armazene templates personalizados com variáveis dinâmicas.
- Pré-visualização interativa de templates para iteração rápida de design.
- Envie e-mail de teste para verificar a renderização do template.
- 👥 Organize destinatários em grupos e referencie todos pelo nome do grupo.
- 🏷️ Gerencie identidades de remetente (cabeçalho
From:) e referencie-as pelo nome. - 📊 Monitore métricas de saúde do e-mail.
- 📰 Mantenha o blog: configurações, domínio personalizado, rascunhos, publicação, pré-visualização e transmissão por e-mail.
Instalação
MCP Bundle (arquivo `.mcpb`, mais fácil)
-
Pegue o arquivo
goodsender.mcpbna última versão. -
Clique duas vezes no arquivo
goodsender.mcpbpara abri-lo no seu cliente de IA.Nota: Nem todo cliente de IA suporta bundles MCP ou servidores MCP locais ainda. Use um método de instalação diferente se nada acontecer ao clicar duas vezes.
Imagem Docker / auto-hospedagem
Execute via
docker run -d -e GOODSENDER_API_KEY=<Your API Key> -v goodsender-mcp-data:/data ghcr.io/good-sender/mcp:latest
Se seu objetivo é executar o agente usando este MCP de forma totalmente autônoma, defina GOODSENDER_DISABLE_ACTION_GUARDS=true para pular todas as confirmações de ação completamente. Veja Confirmação de ação.
ou adicione ao docker-compose.yaml no seu servidor doméstico
services:
goodsender-mcp:
image: ghcr.io/good-sender/mcp:latest
ports:
- "9889:9889"
environment:
GOODSENDER_API_KEY: <Your API Key>
# GOODSENDER_DISABLE_ACTION_GUARDS: "true" # skip all action confirmations
volumes:
- goodsender-mcp-data:/data
restart: unless-stopped
volumes:
goodsender-mcp-data:
e execute via
docker compose up -d
Configuração manual (JSON)
-
Pegue o arquivo
binaries.zipna última versão (inclui binários MCPgoodsender-mcp-*e CLIgoodsender-*). -
Descompacte-o em algum lugar de fácil referência.
-
Modifique o arquivo de configuração do seu cliente de IA, adicionando a configuração do servidor MCP (exemplo para Claude Desktop e Cursor no macOS):
{ ... "mcpServers": { "GoodSender": { "command": "<path to the unzipped binaries>/goodsender-mcp-darwin-arm64", "env": { "GOODSENDER_API_KEY": "<Your API key>" } } } ... }Para outras plataformas, você deve referenciar um binário correspondente em vez de
darwin(macOS)Se seu objetivo é executar o agente usando este MCP de forma totalmente autônoma, defina
GOODSENDER_DISABLE_ACTION_GUARDS=truepara pular todas as confirmações de ação completamente. Veja Confirmação de ação.
Confirmação de ação
Por padrão, ferramentas de mutação (criar, publicar, enviar e similares) não são executadas imediatamente. Elas retornam um token de confirmação. O agente deve chamar confirm_action após sua aprovação.
Defina GOODSENDER_DISABLE_ACTION_GUARDS=true no ambiente do servidor MCP para pular essa etapa. As ferramentas então são executadas quando o cliente as chama. Use isso para loops não supervisionados (agendamentos Cowork, CI). Deixe sem definir se você quiser que cada envio e publicação aguarde sua aprovação no chat.
Exemplos
Exemplos de prompts
Adicione 'John Doe <john.doe@example.com>' e 'Jane Doe <jane.doe@example.com>' ao grupo de assinantes do boletim de IA
ℹ️ Isso irá:
- Criar/atualizar os destinatários no banco de dados
- Adicioná-los ao grupo de destinatários "AI newsletter subscribers", criando-o se necessário
Crie um template GoodSender para um resumo semanal de notícias de IA enviado ao grupo de assinantes do boletim de IA
ℹ️ Isso irá:
- Criar um rascunho de template de e-mail no formato GoodSender seguindo as melhores práticas para criação de templates de e-mail
- Exibir pré-visualização interativa deste rascunho de template (se o cliente de IA suportar)
Aumente o número de notícias no resumo para 5
ℹ️ Feito durante a criação/edição do rascunho do template, isso irá:
- Modificar o template de acordo
- Exibir pré-visualização interativa deste rascunho de template (se o cliente de IA suportar)
Envie um e-mail de teste para mim: 'Good Sender <good.sender@example.com>'
ℹ️ Feito durante a criação/edição do rascunho do template, isso irá:
- Enviar um e-mail com dados simulados gerados a partir do rascunho atual do template apenas para você
Salve o template como "Weekly AI news"
ℹ️ Feito durante a criação/edição do rascunho do template, isso irá:
- Converter o rascunho atual do template em um template persistente armazenado no banco de dados local
- Permitir o envio de e-mails apenas mencionando o nome do template
Reúna as notícias de IA desta semana e envie-as usando o template "Weekly AI news"
ℹ️ Isso irá:
- Criar e enfileirar um e-mail personalizado baseado em template para cada destinatário no grupo de assinantes do boletim de IA
- Para todos os destinatários que não receberam um e-mail com solicitação de consentimento, solicitará seu consentimento para receber e-mails seus
- Enviar e-mails para todos os destinatários que concederam seu consentimento de e-mail
- Monitorar todos os destinatários com consentimento pendente e enviar o e-mail assim que eles o concederem
Publique uma postagem de blog 'Why consent-based emailing wins' e envie por e-mail para o grupo de assinantes do boletim de IA
ℹ️ Isso irá:
- Criar um rascunho de postagem a partir do título e corpo
- Mostrar uma URL de pré-visualização assinada
- Publicar a postagem
- Transmiti-la para o grupo (o fluxo de consentimento ainda se aplica)
Telemetria e privacidade
A telemetria está habilitada por padrão. O servidor MCP envia métricas agregadas de uso e confiabilidade para a GoodSender para ajudar a melhorar o produto.
Sinais típicos incluem:
- Nomes de ferramentas MCP, contagens de chamadas e latência.
- Taxas de sucesso e erro.
- Trechos curtos de erro em falhas.
- Códigos de erro e frequência de trabalhos em segundo plano.
Nós não coletamos intencionalmente corpos de e-mail, endereços de destinatários ou conteúdos de templates como parte desta telemetria.
Você pode optar por não participar da coleta de telemetria definindo GOODSENDER_TELEMETRY=false no ambiente do servidor MCP.
Veja a Política de Privacidade da GoodSender para saber como os dados pessoais são tratados pelo serviço.