Ligar o Madmail ao seu assistente de IA

Depois de ligar, você pede no chat e o assistente faz na sua conta: “como foi a campanha de sexta?”, “monta uma promoção de frete grátis para quem comprou nos últimos 90 dias”. Ele lê as suas listas, escreve o e-mail e mostra a prévia.

Por baixo, isso é um servidor MCP (Model Context Protocol) — mas você não precisa saber disso para usar.

Antes de começar

No catálogo de marketing do Madmail, o conector MCP está incluído no Pro e no Enterprise. O plano gratuito de marketing não inclui MCP. Os créditos de IA do plano são um limite separado e não indicam, por si só, acesso ao conector. Confira o tipo de envio e o plano na tabela de preços.

A assinatura do seu assistente de IA é separada do plano Madmail. Confira no fornecedor do assistente os requisitos atuais para adicionar conectores.

O endereço de ligação é sempre este:

https://mcp.madmail.com.br/mcp

Não é um site: abrir no navegador não leva a lugar nenhum. Ele serve para colar dentro do aplicativo de IA.

Entrar com a sua conta

Recomendado no dia a dia. Você entra com a sua conta Madmail e não precisa guardar nenhuma senha extra.

{
  "mcpServers": {
    "madmail": {
      "url": "https://mcp.madmail.com.br/mcp"
    }
  }
}

claude mcp add --transport http madmail https://mcp.madmail.com.br/mcp

[mcp_servers.madmail]
url = "https://mcp.madmail.com.br/mcp"

{
  "servers": {
    "madmail": {
      "type": "http",
      "url": "https://mcp.madmail.com.br/mcp"
    }
  }
}

A tela de permissão

O Madmail abre uma tela mostrando quem está pedindo acesso e para onde esse acesso vai.

Nessa tela também tem a caixinha “Também deixar que ele envie e-mail de verdade”. Ela vem desmarcada: assim o assistente monta e agenda tudo, mas quem aperta enviar é você. Marque só se quiser que ele dispare sozinho.

Para quem programa: usar sem fazer login

Onde não dá para abrir uma janela de login — um servidor seu, um robô que roda sozinho, uma esteira de build — use uma chave fixa. Crie em Integrações → Assistente de IA → Nova chave, escolhendo ali o que ela pode fazer. Ela começa com msk_ e aparece uma única vez.

{
  "mcpServers": {
    "madmail": {
      "url": "https://mcp.madmail.com.br/mcp",
      "headers": { "Authorization": "Bearer msk_sua_chave_aqui" }
    }
  }
}

claude mcp add --transport http madmail https://mcp.madmail.com.br/mcp \
  --header "Authorization: Bearer msk_sua_chave_aqui"

curl https://mcp.madmail.com.br/mcp \
  -H "Authorization: Bearer msk_sua_chave_aqui" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

O que o assistente consegue fazer

Ele só enxerga o que você liberou. Agrupado por consequência:

Ver — não muda nada

Listas e contatos, campanhas e seus resultados (enviados, entregues, aberturas, cliques, devoluções), modelos de e-mail, segmentos, domínios de envio, saúde de entregabilidade e consumo da conta.

Montar — dá para desfazer

Cria e edita listas, importa contatos em lote, salva modelos de e-mail, monta segmentos e cria campanhas em rascunho. Nada sai nessa etapa.

Enviar — não dá para desfazer

Dispara ou agenda campanha, envia e-mail avulso, retoma campanha pausada. Só funciona se a conexão tiver permissão de envio.

Parar

Se algo sair errado no meio de um disparo, peça: “pausa a campanha”. O assistente interrompe os envios que ainda não saíram. Também dá para cancelar um e-mail avulso que estava agendado.

Nada sai sem confirmar

As ações que falam com gente real — disparar campanha, agendar, enviar e-mail avulso, retomar campanha — pedem confirmação. Na primeira vez, o assistente recebe só um resumo (campanha, assunto, remetente, quantas pessoas) e mostra a você. Só depois do seu “pode enviar” a ação acontece.

Frases para experimentar

• “Quais domínios eu posso usar para enviar?”
• “Como foi a campanha de sexta? Quantos abriram e clicaram?”
• “Monta um segmento com quem é de São Paulo e está inscrito, e me diz quantas pessoas são.”
• “Cria uma campanha de Black Friday pra minha lista VIP e me mostra antes de enviar.”
• “Minha conta está saudável? Tem muita devolução?”

Desligar

Em Integrações → Assistente de IA, tudo que tem acesso à sua conta aparece na lista — o que você ligou pelo ChatGPT ou Claude e as chaves fixas. Clique na lixeira para desligar. O acesso cai em até um minuto.