Apresentando o Servidor MCP Emailit

Estamos lançando o Servidor MCP Emailit, um servidor Model Context Protocol de código aberto que oferece aos assistentes de IA como Claude, Cursor e qualquer outro cliente compatível com MCP acesso completo à plataforma Emailit. Envie emails, gerencie contatos, configure domínios, crie modelos, tudo através de linguagem natural.

O que isso possibilita

Em vez de alternar entre seu assistente de IA e o painel do Emailit, agora você pode fazer tudo a partir de uma única conversa:

• “Envie um email de boas-vindas para sarah@example.com usando o modelo de integração” — a IA escolhe o modelo correto, preenche as variáveis e envia.
• “Mostre-me todos os emails que retornaram esta semana” — liste e inspecione emails sem sair do seu editor.
• “Adicione mail.example.com como domínio de envio e mostre-me os registros DNS” — crie o domínio e obtenha os registros exatos que você precisa configurar.
• “Agende um lembrete para a equipe amanhã às 9h” — o servidor aceita agendamento em linguagem natural como “amanhã às 9h” ou “próxima segunda às 14h”.

O Servidor MCP expõe 47 ferramentas em 8 categorias: emails, domínios, chaves de API, audiências, contatos, modelos, supressões e webhooks. Cobre toda a API do Emailit.

Como funciona

O Model Context Protocol é um padrão aberto que permite aos assistentes de IA se conectarem a serviços externos através de uma interface estruturada de ferramentas. O Servidor MCP Emailit implementa este protocolo, então qualquer cliente compatível pode descobrir e executar operações do Emailit automaticamente.

Existem duas formas de conectar:

1. Stdio — O cliente inicia o servidor como um subprocesso e se comunica via stdin/stdout. Esta é a configuração mais simples e funciona com Claude Code, Cursor e Claude Desktop.
2. HTTP — O servidor roda como um serviço HTTP independente com transporte HTTP Streamable. Útil para configurações remotas, ambientes compartilhados ou clientes baseados na web.

Primeiros passos

Tudo que você precisa é uma conta Emailit, uma chave de API e Node.js 18+.

Claude Code

claude mcp add emailit -e EMAILIT_API_KEY=sua_chave_api -- npx -y @emailit/emailit-mcp

Cursor

Abra Configurações do Cursor → MCP → Adicionar novo servidor MCP global e cole:

{
  "mcpServers": {
    "emailit": {
      "command": "npx",
      "args": ["-y", "@emailit/emailit-mcp"],
      "env": {
        "EMAILIT_API_KEY": "sua_chave_api"
      }
    }
  }
}

Claude Desktop

Abra Configurações → Desenvolvedor → Editar Configuração e cole o mesmo bloco JSON acima.

É isso. Uma vez conectado, a IA descobrirá automaticamente todas as 47 ferramentas e você pode começar a usá-las imediatamente.

Exemplos

Aqui estão algumas coisas que você pode fazer desde o início:

Enviar emails com modelos e variáveis

“Envie o modelo welcome-email para john@example.com com o nome dele como John”

A IA resolve o modelo pelo alias, substitui a variável {{name}} e envia:

{
  "template": "welcome-email",
  "to": "john@example.com",
  "variables": { "name": "John" }
}

Anexar arquivos de uma URL

“Envie a fatura mensal para accounting@company.com com o PDF do nosso bucket S3”

{
  "to": "accounting@company.com",
  "subject": "Fatura Mensal",
  "attachments": [
    {
      "filename": "fatura-2026-05.pdf",
      "url": "https://meubucket.s3.amazonaws.com/faturas/2026-05.pdf"
    }
  ]
}

Gerencie toda sua infraestrutura de envio

“Crie uma nova audiência chamada ‘Usuários Beta’, adicione jane@example.com a ela, depois crie um webhook que me envie eventos de entrega”

A IA encadeia múltiplas ferramentas — create-audience, create-contact e create-webhook — em uma única conversa.

Suprimir e remover supressão de endereços

“Suprima bounced@example.com por causa de muitos bounces definitivos, configure para expirar em 30 dias”

{
  "email": "bounced@example.com",
  "type": "bounce",
  "reason": "muitos bounces definitivos",
  "keep_until": "2026-06-18T00:00:00Z"
}

Dicas

• Defina um remetente padrão. Passe --sender voce@seudominio.com ou configure a variável de ambiente SENDER_EMAIL_ADDRESS para que a IA não peça um endereço de remetente toda vez.
• Use modelos para emails repetidos. Crie modelos com {{variáveis}} e referencie-os pelo alias, é mais rápido e consistente do que escrever HTML no chat.
• Agendamento em linguagem natural funciona. Você pode dizer “amanhã às 9h”, “próxima sexta ao meio-dia”, ou passar um timestamp ISO 8601, o servidor lida com ambos.
• Operações destrutivas são protegidas. Ferramentas de exclusão instruem a IA a confirmar com você antes de prosseguir, então você não excluirá acidentalmente um domínio ou contato.
• Modo HTTP para configurações compartilhadas. Se múltiplos membros da equipe ou serviços precisam de acesso, execute o servidor em modo HTTP e cada cliente se autentica com sua própria chave de API via token Bearer.

Código aberto

O Servidor MCP Emailit tem licença MIT e está disponível no GitHub. É JavaScript puro (ESM), não tem etapa de build e depende de apenas quatro pacotes: @modelcontextprotocol/sdk, fastify, minimist e zod.

Contribuições e feedback são bem-vindos, abra uma issue ou envie um PR.

Documentação completa

Publicamos um guia completo de configuração e referência:

• Guia do Servidor MCP Emailit — Instalação, configuração, todas as 47 ferramentas, exemplos de uso e solução de problemas

Comece agora

Instale o servidor MCP com um único comando:

npx -y @emailit/emailit-mcp

Leia o guia completo ou confira o repositório GitHub para começar.