Conecte sua caixa de entrada ao n8n
com o MCP Client Tool
Dê ao AI Agent do seu workflow no n8n uma caixa de correio real. Ele pode ler, pesquisar, rascunhar, enviar, responder, encaminhar e arquivar e-mails por um único endpoint MCP, com uma chave limitada exatamente ao que o workflow deve fazer.
O único valor de que você precisa
No seu workflow do n8n, adicione um node MCP Client Tool à entrada Tool do AI Agent. Defina Endpoint como https://mcpemails.com/api/mcp, Server Transport como HTTP Streamable e Authentication como Bearer Auth, depois cole uma chave de API do seu painel do MCPEmails como Bearer Token.
| Campo | Valor |
|---|---|
| URL do servidor MCP | https://mcpemails.com/api/mcp |
| Transporte | Streamable HTTP (MCP 2025-06-18) |
| Autenticação | Authorization: Bearer, com uma chave de API de permissões limitadas do seu painel. |
Como o n8n se conecta: uma credencial Bearer Auth com uma chave com escopo
O node MCP Client Tool envia qualquer credencial que você anexar a ele. Este guia usa a credencial Bearer Auth do n8n, que coloca sua chave no header Authorization de cada solicitação. Crie a chave no seu painel e marque só os escopos de que o workflow precisa. Um workflow muitas vezes roda num agendamento sem ninguém olhando, então esses escopos são o limite que importa. Conexões por chave e por OAuth chegam ao mesmo endpoint e recebem o mesmo catálogo de ferramentas.
Como conectar o n8n à sua caixa de entrada
Quatro passos. Os dois primeiros são iguais para todos os clientes, os demais são específicos deste.
Crie uma conta grátis e conecte uma caixa de correio
Crie sua conta em mcpemails.com, sem cartão, e conecte sua caixa de correio no painel, em Caixas de entrada.
Crie uma chave de API com escopo
No painel, em Chaves de API, clique em Criar chave. Dê a ela o nome do workflow e marque só os escopos de que ele precisa: read:email, search:email, send:email, manage:folders, delete:email, manage:drafts, manage:contacts, schedule:email e manage:automations. A chave tem o formato mcpe_ seguido de 64 caracteres hexadecimais e aparece uma única vez, então copie antes de fechar a janela.
Adicione o MCP Client Tool ao seu AI Agent
Abra o workflow, clique no mais abaixo da entrada Tool do node AI Agent e escolha MCP Client Tool. Cole https://mcpemails.com/api/mcp em Endpoint e defina Server Transport como HTTP Streamable.
Anexe uma credencial Bearer Auth
Defina Authentication como Bearer Auth, crie uma credencial nova e cole a chave em Bearer Token, sem nada na frente. Deixe Tools to Include em All, ou mude para Selected e escolha só as ferramentas que este workflow deve ver.
Documentação oficial do n8n sobre servidores MCP remotos: https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.toolmcp/
Na dúvida sobre qual caixa de correio conectar primeiro? Veja a tabela de compatibilidade de provedores
Onde as pessoas costumam tropeçar no n8n
Cole a chave sem a palavra Bearer
A credencial Bearer Auth do n8n adiciona Bearer e um espaço para você. Digitar isso por conta própria envia a palavra duas vezes e a chamada falha com um 401. Se você usar Header Auth, é o contrário: Name é Authorization e Value é Bearer, um espaço e depois a chave.
Um campo chamado SSE Endpoint indica um node antigo
A versão 1 do node MCP Client Tool tinha um único campo SSE Endpoint e nenhuma escolha de transporte. As versões atuais mostram Endpoint mais Server Transport. Este servidor usa Streamable HTTP, então se você só vê SSE Endpoint, adicione um node novo ou atualize o n8n. Se Server Transport estiver em Server Sent Events (Deprecated), mude para HTTP Streamable.
Mantenha o timeout padrão
O node espera 60.000 ms por uma chamada de ferramenta, definido em Options, Timeout. Isso basta até para trabalho em massa: mover ou excluir numa pasta grande para no limite de tempo do próprio servidor antes disso e devolve um resultado marcado como partial, com as mensagens não processadas listadas em remaining_message_ids, para que o agente chame de novo com esses ids. Baixar muito o Timeout pode cortar uma chamada antes de esse resultado chegar, e o agente fica sem saber o que foi feito.
Tools to Include esconde ferramentas; os escopos da chave as proíbem
O node só lista as ferramentas para as quais sua chave tem escopo, porque o servidor deixa o resto fora de tools/list. Escolher um subconjunto em Tools to Include restringe isso ainda mais, o que ajuda o modelo a escolher, mas não muda o que a chave pode fazer. Defina o limite na chave e use Tools to Include para manter o agente focado.
Limites que vale a pena conhecer
- As solicitações têm limite de taxa por chave, em janelas por minuto, por hora e por dia dimensionadas para o seu plano, então uma chave pode usar todo o teto por minuto do plano e várias chaves o dividem. Um workflow que percorre muitos itens em loop deve respeitar o Retry-After e controlar o próprio ritmo.
- O servidor funciona só com solicitação e resposta. Não há webhooks nem eventos iniciados pelo servidor, então um e-mail novo nunca inicia um workflow sozinho. Para reagir a e-mails que chegam, inicie o workflow com um Schedule Trigger e faça o agente verificar as mensagens não lidas.
- Os e-mails são buscados ao vivo no seu provedor a cada chamada e nunca armazenados. Só o token OAuth ou a senha de app criptografados ficam guardados, então um token revogado ou uma senha da caixa de correio alterada encerra o acesso na hora.
n8n e e-mail: perguntas e respostas
Como conecto o e-mail a um AI Agent do n8n?
Adicione um node MCP Client Tool à entrada Tool do AI Agent. Defina Endpoint como https://mcpemails.com/api/mcp e Server Transport como HTTP Streamable, escolha Bearer Auth e cole uma chave de API do painel, em Chaves de API, como Bearer Token. O agente passa a ter ferramentas para ler, pesquisar, rascunhar, enviar, responder, encaminhar, organizar e agendar e-mails.
Posso chamar uma ferramenta de e-mail sem um AI Agent?
Sim. O node MCP Client avulso do n8n executa uma ferramenta MCP como um passo comum do workflow, sem um modelo decidindo o que chamar. Aponte o MCP Endpoint URL dele para o mesmo endereço, anexe a mesma credencial Bearer Auth, escolha uma ferramenta e preencha os parâmetros, por exemplo email_read com action definido como list e unread como true. Isso serve para pipelines fixos em que os passos nunca mudam.
Por que Bearer Auth e não a credencial MCP OAuth2?
O n8n também oferece uma credencial MCP OAuth2. Este guia usa Bearer Auth porque os escopos de uma chave são fixados quando você a cria e ficam visíveis no seu painel, o que é mais fácil de acompanhar num workflow que roda sem supervisão. Revogar a chave no painel, em Chaves de API, para o workflow na próxima chamada.
O workflow pode enviar e-mails sem ninguém conferir?
Só se você deixar. Enviar exige o escopo send:email, então uma chave sem ele não consegue enviar nada. Você também pode ativar a aprovação para uma caixa de entrada no painel: envios, respostas, encaminhamentos, envios de rascunho e envios agendados ficam retidos, o agente recebe um resultado pendente e um membro do espaço de trabalho aprova ou rejeita cada um antes que qualquer coisa saia.
Quais caixas de correio um workflow do n8n alcança?
Outlook.com e Microsoft 365 com Entrar com a Microsoft, em que uma conta de trabalho pode precisar que um administrador de TI aprove o app uma vez; Gmail, iCloud, Fastmail, Yahoo, Zoho e Yandex com uma senha específica de app; e qualquer outra caixa de correio que fale IMAP e SMTP nas portas padrão. Com várias caixas de entrada conectadas, o agente chama inbox_list para encontrar o id de cada uma, então não há UUIDs para fixar no workflow.
Meus e-mails ficam armazenados nos seus servidores?
Não. Cada mensagem é buscada ao vivo no seu provedor para a solicitação que a pediu e entregue direto ao n8n. Só o token OAuth ou a senha de app criptografados ficam guardados, para que as próximas chamadas possam autenticar. Excluir a caixa de entrada no painel, ou revogar o acesso no seu provedor, encerra a conexão na hora.
Dê ao seu agente do n8n uma caixa de entrada real
Um endpoint, uma credencial Bearer Auth, uma chave com escopo. Sem cartão.