# Apresentamos o servidor MCP do Emailit

> Conecte o Claude, o Cursor e outros assistentes de IA diretamente ao Emailit. Envie e-mails e gerencie contatos, domínios, templates e muito mais em linguagem natural.

2026-05-19 · George (https://x.com/thegeorge, https://www.linkedin.com/in/jiri-zizka/)

Estamos lançando o **servidor MCP do Emailit**, um servidor de código aberto do [Model Context Protocol](https://modelcontextprotocol.io/) que dá a assistentes de IA como o Claude, o Cursor e qualquer outro cliente compatível com MCP acesso completo à plataforma do Emailit. Envie e-mails, gerencie contatos, configure domínios e crie templates, tudo em linguagem natural.

## O que isso possibilita

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

- **“Envie um e-mail de boas-vindas para **[**sarah@example.com**](mailto:sarah@example.com)** usando o template de onboarding”**: a IA escolhe o template certo, preenche as variáveis e envia.
- **“Mostre todos os e-mails que deram bounce esta semana”**: liste e inspecione e-mails sem sair do seu editor.
- **“Adicione mail.example.com como domínio de envio e mostre os registros DNS”**: crie o domínio e receba exatamente os registros que você precisa configurar.
- **“Agende um lembrete para a equipe amanhã às 9h”**: o servidor aceita agendamento em linguagem natural (em inglês), como “tomorrow at 9am” ou “next Monday at 2pm”.

O servidor MCP expõe **47 ferramentas** em 8 categorias: e-mails, domínios, chaves de API, listas de contatos, contatos, templates, supressões e webhooks. Ele cobre toda a API do Emailit.

## Como funciona

O [Model Context Protocol](https://modelcontextprotocol.io/) é um padrão aberto que permite que assistentes de IA se conectem a serviços externos por meio de uma interface estruturada de ferramentas. O servidor MCP do Emailit implementa esse protocolo, então qualquer cliente compatível pode descobrir e chamar as 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. É 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 o transporte Streamable HTTP. É útil para configurações remotas, ambientes compartilhados ou clientes web.

## Como começar

Você só precisa de uma conta no Emailit, uma chave de API e Node.js 18+.

### Claude Code

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

### Cursor

Abra **Cursor Settings → MCP → Add new global MCP server** e cole:

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

### Claude Desktop

Abra **Settings → Developer → Edit Config** e cole o mesmo bloco JSON acima.

Pronto. Depois da conexão, a IA descobre automaticamente as 47 ferramentas e você já pode começar a usá-las.

## Exemplos

Algumas coisas que você já pode fazer logo de cara:

### Enviar e-mails com templates e variáveis

> “Envie o template welcome-email para [john@example.com](mailto:john@example.com) com o nome John”

A IA encontra o template pelo alias, substitui a variável `{{name}}` e envia:

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

### Anexar arquivos a partir de uma URL

> “Envie a fatura mensal para [accounting@company.com](mailto:accounting@company.com) com o PDF do nosso bucket S3”

```json
{
  "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 a sua infraestrutura de envio

> “Crie uma nova lista chamada ‘Usuários Beta’, adicione [jane@example.com](mailto:jane@example.com) a ela e depois crie um webhook que me envie os eventos de entrega”

A IA encadeia várias ferramentas (`create-audience`, `create-contact` e `create-webhook`) em uma única conversa.

### Suprimir endereços e remover a supressão

> “Suprima [bounced@example.com](mailto:bounced@example.com) por excesso de hard bounces, com expiração em 30 dias”

```json
{
  "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 o endereço do remetente toda vez.
- **Use templates para e-mails recorrentes.** Crie templates com `{{variables}}` e use-os pelo alias: é mais rápido e mais consistente do que escrever HTML no chat.
- **O agendamento em linguagem natural funciona.** Você pode usar expressões como “tomorrow at 9am” ou “next Friday at noon”, ou passar um timestamp ISO 8601; o servidor entende os dois.
- **Operações destrutivas são protegidas.** As ferramentas de exclusão orientam a IA a confirmar com você antes de continuar, então você não vai excluir um domínio ou contato sem querer.
- **Modo HTTP para configurações compartilhadas.** Se várias pessoas da equipe ou vários serviços precisam de acesso, rode o servidor no modo HTTP: cada cliente se autentica com a própria chave de API via token Bearer.

## Código aberto

O servidor MCP do Emailit tem licença MIT e está disponível no [GitHub](https://github.com/emailit/emailit-mcp). É 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 do Emailit](https://emailit.com/docs/guides/emailit-mcp-server): instalação, configuração, as 47 ferramentas, exemplos de uso e solução de problemas

## Comece agora

Instale o servidor MCP com um único comando:

```bash
npx -y @emailit/emailit-mcp
```

Leia o [guia completo](https://emailit.com/docs/guides/emailit-mcp-server) ou confira o [repositório no GitHub](https://github.com/emailit/emailit-mcp) para começar.

---

Source: https://emailit.com/pt/blog/introducao-servidor-mcp-emailit/