Conecte o SuperMailbox ao seu CRM
Cada usuário do CRM recebe uma conexão OAuth segura com as caixas de e-mail que escolher. Seu CRM pode localizar conversas com clientes, mostrar contexto de e-mail verificado e preparar ou enviar respostas pelo servidor MCP do SuperMailbox.
Como a conexão funciona
Conecte uma caixa de e-mail
O usuário conecta Gmail, Outlook ou outra caixa compatível ao SuperMailbox. O login no provedor de e-mail é separado da autorização do CRM.
Autorize o CRM
O CRM abre o OAuth do SuperMailbox no navegador. O usuário entra, confere o cliente e as permissões solicitadas e aprova a conexão.
Use as ferramentas MCP
O CRM chama o servidor MCP remoto com o token do usuário. O usuário escolhe uma caixa autorizada, e o CRM opera dentro dessa permissão.
Configurações da conexão
Use um cliente ou SDK MCP com suporte a Streamable HTTP remoto e descoberta de OAuth. Ele deve gerenciar a autorização no navegador e enviar o token de acesso nas solicitações MCP.
- URL do servidor MCP
https://api.supermailbox.app/mcp- Autorização
- OAuth 2.0 · Authorization Code · PKCE S256
- Permissões
openid email mail.accounts.read mail.messages.read mail.send
Solicite somente os acessos necessários ao fluxo. Um CRM que lê conversas e envia respostas pode solicitar:
Encontre e verifique uma conversa
- Chame list_mail_accounts para o usuário escolher uma caixa disponível. canSend é apenas uma indicação; a permissão de envio é conferida novamente na execução.
- Busque candidatos com search_emails ou search_threads_by_recipient. A busca por destinatário retorna apenas metadados; obtenha e verifique a conversa antes de vinculá-la a um registro do CRM.
- Os resultados podem ser limitados ou incompletos. Considere os campos coverage e completeness; um resultado parcial vazio não prova que não há mensagens.
- Os IDs de caixas, mensagens e conversas são opacos e pertencem à autorização do usuário atual. Resolva e valide tudo na mesma conexão.
Prepare e envie respostas com segurança
- Antes da confirmação do envio, mostre no CRM a caixa, o destinatário e o texto da resposta selecionados.
- send_email e reply_to_email retornam uma operação na fila. Consulte get_mail_action com o mesmo ID de operação e as permissões necessárias até um estado final.
- O recibo de fila não comprova a entrega. Se o envio estiver incerto, verifique a mesma operação; nunca repita automaticamente com um novo ID.
Segurança e controle de acesso
- Use o fluxo OAuth authorization-code com PKCE S256 pela descoberta suportada pelo cliente MCP. Mantenha segredos e tokens no servidor; não os exponha ao código do navegador nem aos logs.
- Crie uma conexão separada para cada usuário do CRM. Não compartilhe tokens ou IDs opacos de e-mail entre usuários.
- Solicite mail.send somente se o CRM precisar enviar mensagens. O usuário pode revogar a conexão do CRM nas configurações de aplicativos conectados do SuperMailbox.

