O que é o Servidor MCP do Emailit?

O Servidor MCP do Emailit é um servidor de código aberto do Protocolo de Contexto de Modelo que conecta assistentes de IA diretamente ao Emailit.

Permite enviar emails, gerenciar contatos, domínios, modelos e muito mais através de linguagem natural — diretamente do Claude, Cursor ou qualquer cliente compatível com MCP.

• Pacote: @emailit/emailit-mcp
• Runtime: Node.js 18+
• Licença: MIT
• Repositório: github.com/emailit/emailit-mcp

Pré-requisitos

• Uma conta Emailit
• Uma chave de API
• Um domínio de envio verificado
• Node.js 18 ou superior

Modos de transporte

O servidor suporta dois modos de transporte:

Stdio (padrão)

O cliente MCP inicia o servidor como um subprocesso e se comunica através de entrada/saída padrão. A chave de API é passada via variável de ambiente ou argumento CLI. Esta é a opção mais simples e funciona com todos os principais clientes.

HTTP (HTTP Streamable)

Para integrações remotas ou baseadas na web, o servidor executa como um servidor HTTP usando transporte HTTP Streamable. Os clientes se autenticam por sessão passando sua chave de API como token Bearer no cabeçalho Authorization. O endpoint é exposto em /mcp.

Instalação e configuração

Claude Code (Stdio)

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

Claude Code (HTTP)

Primeiro inicie o servidor:

npx -y @emailit/emailit-mcp --http --port 3000

Depois registre-o:

claude mcp add emailit \
  --transport http http://127.0.0.1:3000/mcp \
  --header "Authorization: Bearer sua_chave_api"

Cursor (Stdio)

Abra a paleta de comandos e escolha Cursor Settings → MCP → Add new global MCP server, depois cole:

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

Cursor (HTTP)

Inicie o servidor, depois adicione:

{
  "mcpServers": {
    "emailit": {
      "url": "http://127.0.0.1:3000/mcp",
      "headers": {
        "Authorization": "Bearer sua_chave_api"
      }
    }
  }
}

Claude Desktop (Stdio)

Abra Configurações do Claude Desktop → aba Developer → Edit Config, depois cole:

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

Opções CLI

Variáveis de ambiente

Dica: Se você não fornecer um endereço de email remetente, o servidor MCP pedirá um a cada envio de email.

Ferramentas disponíveis

O servidor expõe 47 ferramentas em 8 categorias.

Emails (10 ferramentas)

Domínios (6 ferramentas)

Chaves de API (5 ferramentas)

Audiências (5 ferramentas)

Contatos (5 ferramentas)

Modelos (6 ferramentas)

Supressões (5 ferramentas)

Webhooks (5 ferramentas)

Exemplos de uso

Enviar um email simples

Peça ao seu assistente de IA:

“Envie um email de boas-vindas para john@example.com com o assunto ‘Bem-vindo!’”

A IA chama send-email com:

{
  "from": "ola@meudominio.com",
  "to": "john@example.com",
  "subject": "Bem-vindo!",
  "html": "<h1>Bem-vindo!</h1><p>Obrigado por se cadastrar.</p>"
}

Enviar com modelo e variáveis

“Envie o modelo welcome-email para sarah@example.com com o nome dela como Sarah.”

{
  "from": "ola@meudominio.com",
  "to": "sarah@example.com",
  "template": "welcome-email",
  "variables": { "name": "Sarah" }
}

Agendar um email

“Agende um email de lembrete para equipe@empresa.com para amanhã às 9h.”

{
  "from": "lembretes@meudominio.com",
  "to": "equipe@empresa.com",
  "subject": "Lembrete da Reunião Diária",
  "text": "Não se esqueçam da reunião às 9:30!",
  "scheduled_at": "amanhã às 9h"
}

Enviar com anexos

“Envie um email para contabilidade@empresa.com com o PDF da fatura anexado.”

{
  "from": "faturamento@meudominio.com",
  "to": "contabilidade@empresa.com",
  "subject": "Fatura Mensal",
  "html": "<p>Segue em anexo a fatura.</p>",
  "attachments": [
    {
      "filename": "fatura-2026-05.pdf",
      "url": "https://example.com/faturas/2026-05.pdf"
    }
  ]
}

Gerenciar domínios

“Adicione meu domínio mail.example.com e me mostre os registros DNS.”

A IA chama create-domain e exibe os registros DNS necessários para você configurar com seu provedor DNS.

“Verifique meu domínio.”

A IA chama verify-domain para verificar a propagação DNS e reporta o status de verificação.

Gerenciar contatos

“Adicione Jane Smith (jane@example.com) à audiência aud_abc123.”

{
  "email": "jane@example.com",
  "first_name": "Jane",
  "last_name": "Smith",
  "audiences": ["aud_abc123"]
}

Gerenciar modelos

“Crie um modelo de newsletter com alias newsletter-mensal.”

{
  "name": "Newsletter Mensal",
  "alias": "newsletter-mensal",
  "subject": "Atualização {{mes}}",
  "html": "<h1>Atualização de {{mes}}</h1>..."
}

Gerenciar supressões

“Suprima bounced@example.com por muitos bounces duros.”

{
  "email": "bounced@example.com",
  "type": "bounce",
  "reason": "muitos bounces duros"
}

Configurar webhooks

“Crie um webhook que envie eventos de entrega e bounce para meu endpoint.”

{
  "name": "Rastreador de Entrega",
  "url": "https://meuapp.com/webhooks/email",
  "events": ["email.delivered", "email.bounced"]
}

Notas de segurança

• Chaves de API nunca devem ser commitadas no controle de versão.
• No modo stdio, a chave de API é armazenada na configuração do cliente MCP.
• No modo HTTP, clientes passam a chave de API por sessão via token Bearer.
• URLs de webhook são validadas contra SSRF antes da criação.
• Operações de exclusão fazem a IA confirmar com você primeiro.

Solução de problemas

“Chave de API obrigatória para modo stdio” Configure a variável de ambiente EMAILIT_API_KEY ou passe --key.

Domínio não verificado Configure os registros DNS da saída de create-domain, depois chame verify-domain.

Email rejeitado / não enviando Certifique-se de que o domínio está verificado e o endereço remetente usa esse domínio.

Email agendado não pode ser cancelado Deve ser pelo menos 3 minutos antes do horário agendado.

Retry falha Apenas emails com falha grave, erro, retidos ou suprimidos podem ser tentados novamente.

Desenvolvimento local

git clone https://github.com/emailit/emailit-mcp.git
cd emailit-mcp
npm install

# Executar em modo stdio
EMAILIT_API_KEY=sua_chave node src/index.js

# Executar em modo HTTP
node src/index.js --http --port 3000

Para mais detalhes, veja o repositório GitHub.