MailBeast
Execute campanhas de cold email diretamente pelo seu assistente de IA: lance campanhas com sequências A/B, gerencie leads e caixas de envio aquecidas, leia e responda respostas, e veja análises de campanhas no MailBeast. Login via OAuth com acesso somente leitura ou leitura + escrita.
Servidor MCP hospedado
npx add-mcp 'https://mcp.mailbeast.ai/mcp'Instala no Claude Code, Codex, Cursor e outros
Documentação
Servidor MCP
Conecte Claude, ChatGPT, Cursor e outros assistentes de IA ao seu workspace MailBeast.
O servidor MCP do MailBeast permite que um assistente de IA trabalhe no seu workspace: criar e lançar campanhas, adicionar leads, verificar caixas de entrada e aquecimento, ler e responder mensagens, e obter análises — apenas perguntando em linguagem natural.
https://mcp.mailbeast.ai/mcp
Adicione esta URL ao seu aplicativo de IA e faça login com sua conta MailBeast. Você escolhe o workspace e o que o assistente pode fazer; não é necessário copiar chave de API.
Requisitos
- Um workspace MailBeast no plano Pro+ (ou um plano empresarial com acesso à API) — o mesmo acesso da API REST.
- Você é proprietário ou administrador desse workspace. Outros cargos não podem conectar aplicativos.
- Para enviar e-mails (campanhas, respostas, e-mails de teste): pelo menos uma caixa de envio conectada.
- Um aplicativo de IA que suporte servidores MCP remotos: Claude (web, desktop, mobile, Claude Code), ChatGPT, Cursor ou qualquer outro cliente MCP que fale Streamable HTTP e OAuth.
Como funciona a conexão
Adicione `https://mcp.mailbeast.ai/mcp` no seu aplicativo de IA (passos por aplicativo abaixo). O aplicativo abre uma página do MailBeast no seu navegador. Faça login se ainda não estiver. Escolha o workspace e depois as permissões: visualizar campanhas, leads, caixas de entrada, inbox e análises está sempre incluído, e **Fazer alterações e enviar e-mails** está ativado por padrão — desative se o assistente deve apenas visualizar. A página mostra qual aplicativo está solicitando e para onde você será redirecionado. Selecione **Permitir acesso**. Você retorna ao aplicativo e as ferramentas do MailBeast estão prontas.Por trás disso, é OAuth 2.1 padrão com PKCE: o aplicativo descobre nosso login a partir da
resposta 401 do servidor e seu
metadata. Cada
conexão aprovada aparece como uma chave de API chamada " (MCP)" — por exemplo
"Claude (MCP)" — em Configurações → Chaves de API.
Conecte seu aplicativo
Adicione em claude.ai ou no Claude Desktop; depois funciona também nos aplicativos móveis do Claude.1. Abra **Personalizar → Conectores** ([claude.ai/customize/connectors](https://claude.ai/customize/connectors)).
2. Selecione **Adicionar conector personalizado**, nomeie como `MailBeast` e insira
`https://mcp.mailbeast.ai/mcp`. Deixe o ID do cliente OAuth e o segredo vazios.
3. Selecione **Adicionar**, depois **Conectar**, e aprove o acesso no navegador.
4. Em um chat, ative o MailBeast em **+ → Conectores**.
Nos planos **Team e Enterprise**, um proprietário da organização primeiro adiciona o conector em
**Configurações da organização → Conectores** (**Adicionar → Personalizado**, mesma URL); depois cada
membro abre **Personalizar → Conectores** e seleciona **Conectar**.
Servidores MCP personalizados no ChatGPT dependem do seu plano e das configurações do workspace. No
Business, apenas administradores e proprietários do workspace podem adicioná-los; no Pro, o ChatGPT conecta
servidores personalizados apenas para leitura. Veja
[o artigo de ajuda da OpenAI](https://help.openai.com/en/articles/12584461).
Inicie o Claude Code, execute `/mcp`, selecione **mailbeast** e **Autenticar**. Seu
navegador abre; aprove o acesso e retorne ao terminal.
Ou adicione em `~/.cursor/mcp.json` (todos os projetos) ou `.cursor/mcp.json` (um projeto):
```json theme={null}
{
"mcpServers": {
"MailBeast": {
"url": "https://mcp.mailbeast.ai/mcp"
}
}
}
```
Em **Configurações do Cursor → MCP**, o MailBeast mostra **Requer login** — selecione e
aprove o acesso no navegador.
Permissões
| Você aprova | O assistente pode | Por trás |
|---|---|---|
| Visualizar (sempre incluído) | Ler campanhas, sequências, leads, caixas de entrada e sua saúde, e-mails e respostas, análises, buscas do Lead Finder, uso do plano | Chave de API com all:read |
| Visualizar + Fazer alterações e enviar e-mails | Tudo acima, mais: criar, alterar, iniciar, pausar e excluir campanhas; adicionar, atualizar e excluir leads; alterar, pausar e remover caixas de entrada; conectar caixas do Google / Microsoft por link; marcar conversas como lidas; responder e encaminhar e-mails; enviar e-mails de teste | Chave de API com all:all |
Somente leitura significa somente leitura: o assistente não pode alterar nada ou enviar e-mails. Ele ainda vê o conteúdo que lê — seus e-mails, respostas e dados de leads — e o repassa ao aplicativo de IA que você usa.
Seja o que for que você aprove, o assistente não pode:
- criar ou ver chaves de API, ou alterar seu plano e cobrança;
- ver qualquer senha — em uma conexão por login, ele não aceita senhas SMTP/IMAP de forma alguma (conecte essas caixas de entrada no painel);
- ultrapassar os limites do plano do seu workspace e o limite de taxa — chamadas de ferramentas contam contra ele como requisições diretas à API (120 por minuto por workspace).
Para alterar permissões, conecte novamente com a outra opção e exclua a antiga chave "(MCP)".
Desconectar
- No MailBeast — exclua a chave do aplicativo ("Claude (MCP)", "ChatGPT (MCP)", …) em Configurações → Chaves de API. O acesso termina imediatamente: a próxima chamada do aplicativo é recusada e ele precisa fazer login novamente.
- No aplicativo — remova o conector (Claude: Personalizar → Conectores → … →
Remover; ChatGPT: remova o plugin em Plugins; Claude Code:
claude mcp remove mailbeast; Cursor e outros clientes: remova das configurações ou arquivo de configuração do MCP).
Remover o conector apenas no aplicativo pode deixar a chave no MailBeast — exclua-a lá para revogar o acesso com certeza.
Conectar com uma chave de API
Para scripts, CI e clientes sem login OAuth. Crie uma chave em
Configurações → Chaves de API — uma chave separada para
MCP, apenas com os escopos que você precisa (all:read para somente leitura, all:all para
tudo) — e envie-a como cabeçalho:
Authorization: Bearer mb_live_…
O assistente vê apenas as ferramentas que os escopos da chave permitem.
Uma conexão por chave também oferece connect_mailboxes (SMTP/IMAP com senhas) e
alterações de credenciais em update_mailbox, o que conexões por login não oferecem.
Aviso
Nunca coloque uma chave de API na URL do servidor. Configurações antigas que usavam uma URL contendo a chave continuam funcionando por enquanto, mas mude para login ou o cabeçalho acima e exclua essa chave — URLs acabam em logs, histórico do navegador e capturas de tela.
Ferramentas
Acesso mostra o que uma ferramenta precisa: Leitura funciona em toda conexão; Escrita precisa de Fazer alterações e enviar e-mails; Envia e-mails precisa de Fazer alterações e enviar e-mails e envia e-mails reais para destinatários reais. Cada ferramenta chama o endpoint correspondente da API REST (veja a aba Referência da API) — o servidor MCP não adiciona permissões próprias.
Workspace
| Ferramenta | O que faz | Acesso |
|---|---|---|
get_workspace | Nome do workspace e fuso horário, plano e uso contra cada limite do plano | Leitura |
Caixas de entrada
| Ferramenta | O que faz | Acesso |
|---|---|---|
list_mailboxes | Caixas de envio com status, pontuação de saúde, aquecimento e limites | Leitura |
get_mailbox | Uma caixa de entrada: status e por que falhou pela última vez, aquecimento, limites; opcionalmente o teste de conexão mais recente | Leitura |
start_oauth_connect | Inicia a conexão de uma caixa do Google Workspace ou Microsoft 365: retorna um link que você abre para fazer login — sem senha | Escrita |
check_oauth_connect | Verifica se esse login terminou | Leitura |
update_mailbox | Altera nome do remetente, limite diário, intervalo de envio, assinatura, responder-para, CCO, domínio de rastreamento, aquecimento, idioma | Escrita |
pause_mailbox / resume_mailbox | Para uma caixa de enviar / reativa (uma que falhou recebe um novo teste de conexão) | Escrita |
bulk_update_mailboxes | Uma alteração — status ou configurações compartilhadas — para até 1000 caixas | Escrita |
delete_mailbox | Remove uma caixa de entrada do workspace | Escrita |
connect_mailboxes | Conecta caixas SMTP/IMAP com senhas — apenas conexões por chave de API | Escrita |
Campanhas
| Ferramenta | O que faz | Acesso |
|---|---|---|
list_campaigns | Campanhas com status e contagem de leads | Leitura |
get_campaign | Uma campanha: agendamento, configurações, métricas, caixas de entrada, cada etapa da sequência e variante A/B, se está dentro da janela de envio | Leitura |
create_campaign | Cria uma campanha como rascunho (nada é enviado): agendamento, configurações, sequência com variantes A/B, tags, e-mails de leads | Escrita |
update_campaign | Altera uma campanha; uma nova sequência, lista de caixas ou lista de tags substitui a atual | Escrita |
send_test_email | Envia uma prévia de uma etapa da sequência para um endereço (12 por dia por workspace) | Envia e-mails |
start_campaign | Inicia o envio de uma campanha rascunho para seus leads no agendamento definido | Envia e-mails |
pause_campaign | Pausa uma campanha — nada mais é enviado até ser retomada | Escrita |
resume_campaign | Retoma uma campanha pausada — o envio continua no agendamento | Envia e-mails |
delete_campaign | Exclui permanentemente uma campanha e interrompe seu envio | Escrita |
Leads
| Ferramenta | O que faz | Acesso |
|---|---|---|
add_leads | Adiciona até 100 leads por chamada a uma campanha (deduplicados por e-mail) | Escrita |
list_leads | Leads de uma campanha com status e engajamento (abriu, clicou, respondeu) | Leitura |
get_lead | Um lead com campos personalizados e progresso na sequência | Leitura |
find_lead_by_email | Encontra leads por e-mail em todas as campanhas | Leitura |
update_lead | Altera campos, tags, campos personalizados ou status de um lead | Escrita |
bulk_set_lead_status | Define o mesmo status em até 1000 leads | Escrita |
bulk_add_lead_tags | Adiciona tags a até 1000 leads | Escrita |
bulk_remove_lead_tags | Remove tags de até 1000 leads | Escrita |
delete_leads | Exclui leads de uma campanha por ids, por filtro ou todos | Escrita |
E-mails
| Ferramenta | O que faz | Acesso |
|---|---|---|
list_emails | E-mails de todas as caixas (inbox unificado), mais recentes primeiro, sem corpos | Leitura |
get_email | Um e-mail com seu corpo como texto simples; includeHtml: true adiciona a versão HTML (retornada mesmo assim quando o e-mail não tem parte de texto; htmlOmitted marca que foi omitida). Corpos acima de 25.000 caracteres são cortados e marcados bodyTruncated | Leitura |
count_unread_emails | Número de e-mails não lidos | Leitura |
reply_to_email | Envia uma resposta na conversa, da caixa de entrada que a possui | Envia e-mails |
forward_email | Encaminha um e-mail para destinatários que você escolher | Envia e-mails |
mark_thread_read | Marca uma conversa como lida | Escrita |
Análises e Lead Finder
| Ferramenta | O que faz | Acesso |
|---|---|---|
get_campaign_analytics | Envios, aberturas, cliques, respostas, rejeições e taxas de uma campanha, por caixa, etapa ou tipo de rejeição, opcionalmente ao longo do tempo | Leitura |
get_workspace_analytics | Totais e taxas em todas as campanhas para um período | Leitura |
list_lead_searches / get_lead_search | Buscas do Lead Finder e seu progresso (buscas são iniciadas no painel) | Leitura |
Segurança
- Campanhas começam como rascunhos. Iniciar é sempre uma etapa separada, para que você possa revisar a sequência e receber um e-mail de teste primeiro.
- Sem senhas no chat. Caixas de correio do Google Workspace e Microsoft 365 conectam-se por meio de
start_oauth_connect- um link que você mesmo abre. Caixas SMTP/IMAP são conectadas no painel (ou com uma conexão por chave de API); as senhas são armazenadas criptografadas e nunca retornadas. - Seu aplicativo de IA recebe o que as ferramentas retornam. Conteúdo de e-mail, dados de leads e análises que o assistente lê vão para o provedor de IA que você usa (Anthropic, OpenAI, …) e são tratados sob os termos dele. O MailBeast vê apenas as chamadas de ferramenta, não a sua conversa. Consulte nossa Política de Privacidade.
- Trate e-mails recebidos como não confiáveis. Uma resposta de um lead pode conter texto escrito para direcionar um assistente de IA. Verifique o que o assistente propõe antes de aprovar um envio, uma exclusão ou uma alteração em massa.
Solução de problemas
| Sintoma | O que fazer |
|---|---|
| "MCP está disponível no plano Pro+" ao lado de um workspace | O MCP precisa do Pro+ (ou enterprise com acesso à API). Escolha outro workspace ou altere o plano no painel |
| "Apenas proprietários e administradores do workspace podem conectar aplicativos" | Peça a um proprietário ou administrador desse workspace para conectar, ou para alterar seu papel |
| "Esta solicitação de conexão expirou" | Uma solicitação de login dura 30 minutos e funciona uma vez - comece a conectar novamente pelo aplicativo |
| O assistente não tem ferramentas para criar, alterar ou enviar | Você conectou com Fazer alterações e enviar e-mail desativado. Conecte novamente com ele ativado e exclua a chave antiga |
connect_mailboxes está ausente | Conexões de login não usam senhas. Use start_oauth_connect para Google / Microsoft, ou conecte SMTP/IMAP no painel |
O aplicativo mostra Reconectar / "Falha na autorização" / 401 | A chave foi excluída ou a conexão expirou. Conecte novamente |
| Claude: "Não foi possível alcançar o servidor MCP" | Verifique se sua rede permite mcp.mailbeast.ai, depois reconecte. Se persistir, envie-nos a referência ofid_… que o Claude mostra |
| Claude Code: o navegador não abriu | Copie a URL que o Claude Code imprime, abra-a, aprove e execute /mcp novamente |
429 / "Muitas solicitações" | O limite de taxa do workspace (compartilhado com a API REST) - aguarde o tempo indicado na mensagem |
402 / "limite do plano atingido" | Um limite do plano foi usado - pergunte "o que resta no meu plano?" (get_workspace) |
Ainda com problemas? Escreva para support@mailbeast.ai ou use o chat no aplicativo.
Exemplos de prompts
- "Quantos e-mails ainda posso enviar este mês?"
- "Mostre-me as taxas de resposta das minhas campanhas desta semana."
- "Crie uma campanha de 3 etapas para esses leads, em dias úteis das 9 às 17 no horário deles, e envie-me um teste da etapa 1."
- "Quais caixas de correio estão falhando e por quê?"
- "Resuma as respostas não lidas de hoje e rascunhe respostas para as interessadas."
- "Compare as taxas de resposta das minhas últimas três campanhas por etapa da sequência."
Nota
https://developer.mailbeast.ai/mcpé um servidor diferente: ele pesquisa esta documentação e não toca no seu workspace. É útil para agentes que escrevem código contra a API.
Esta documentação é construída e hospedada no Mintlify, uma plataforma de documentação para desenvolvedores.