Compatibilidade de provedores de e-mail com agentes de IA
O que um agente de IA realmente consegue fazer com cada provedor de e-mail e o que é preciso para conectar cada um. Gmail, Fastmail, iCloud Mail, Yahoo Mail, Zoho Mail, Yandex Mail, Outlook / Microsoft 365 e qualquer caixa IMAP genérica. Cada linha é conferida com os conectores que rodam em produção.
Última verificação: 30 de agosto de 2026
Como cada provedor se conecta
Método de login, hosts de e-mail e segurança do transporte, e a falha que de fato faz as pessoas perderem a tarde. Escolha um provedor para ver a configuração passo a passo.
| Provedor | Login | IMAP (entrada) | SMTP (saída) | O que costuma dar errado |
|---|---|---|---|---|
| Gmail (IMAP) | Senha de app | imap.gmail.com993 · TLS | smtp.gmail.com465 · TLS | A opção de senha de app não existe na Conta do Google até que a verificação em duas etapas esteja ativada, e ela desaparece de novo para todos num Workspace cujo administrador desativa as senhas de app para o domínio. O Google mostra a senha em quatro blocos; os espaços servem só para exibição e são removidos antes de o login ser enviado. |
| Gmail (API) | OAuth do Google | API do provedor, sem IMAP | API do provedor, sem IMAP | Nada na camada de transporte: esta linha conversa com gmail.googleapis.com, e não com IMAP. O que dá errado é o consentimento. O app não é verificado pelo Google, então a tela de login mostra um aviso que você precisa ignorar para continuar, e o Google permite que um app não verificado receba consentimento de no máximo 100 contas em toda a sua existência, um contador que não pode ser zerado. Esse teto é o motivo de a senha de app acima ser o caminho padrão. Os limites depois disso são de semântica: marcadores em vez de pastas, sem cópia nativa e sem expunge permanente. |
| Fastmail | Senha de app | imap.fastmail.com993 · TLS | smtp.fastmail.com465 · TLS | A senha normal da conta é recusada na hora. O Fastmail gera uma senha de app de 16 caracteres, e enviar a senha de login no lugar dela é a causa isolada mais comum de falha na conexão. |
| iCloud Mail | Senha de app | imap.mail.me.com993 · TLS | smtp.mail.me.com587 · STARTTLS | A autenticação de dois fatores precisa estar ativada para que a Apple gere uma senha de app. A Apple exibe essa senha em quatro blocos separados por hífens; os hífens servem só para exibição e são removidos antes de o login ser enviado. |
| Yahoo Mail | Senha de app | imap.mail.yahoo.com993 · TLS | smtp.mail.yahoo.com465 · TLS | O Yahoo aceita no máximo 5 conexões simultâneas. A mensagem de rejeição dele, “Incorrect username or password”, cita as duas metades de propósito e não diz qual delas estava errada. |
| Zoho Mail | Senha de app | imap.zoho.com993 · TLS | smtp.zoho.com465 · TLS | O acesso IMAP vem desativado e precisa ser ativado antes. O Zoho também opera seis data centers regionais, e caixas pagas com domínio próprio ficam em imappro/smtppro em vez de imap/smtp, então o host certo depende tanto da região quanto do tipo de conta. |
| Yandex Mail | Senha de app | imap.yandex.com993 · TLS | smtp.yandex.com465 · TLS | O Yandex não implementa o SASL-IR da RFC 4959, então a forma de login inline volta como erro de sintaxe de comando, e não como erro de credencial. Tanto “IMAP” quanto “App passwords and OAuth tokens” precisam estar ativados, e contas do Yandex 360 com domínio próprio podem entrar com um nome de login que não é o endereço. |
| Microsoft 365 / Outlook | OAuth da Microsoft | API do provedor, sem IMAP | API do provedor, sem IMAP | Contas Microsoft pessoais (outlook.com, hotmail.com, live.com, msn.com) se conectam diretamente. Contas corporativas e de estudante são diferentes: a política de consentimento padrão da Microsoft impede que os funcionários aprovem sozinhos permissões de e-mail, então o painel oferece um link de aprovação compartilhável para você enviar ao administrador de TI, que aprova o app uma vez para a organização inteira e não precisa de uma conta MCPEmails; depois disso, todos se conectam normalmente. Uma conta Microsoft sem caixa de correio do Exchange Online é recusada, com a dica de conectar o endereço por IMAP. A Microsoft pode bloquear temporariamente o envio de uma conta outlook.com recém-criada que envia em rajadas, como parte das suas próprias verificações contra abuso. |
| IMAP genérico | Senha da caixa de correio | As configurações do seu provedor de hospedagem993 / 143 · TLS / STARTTLS | As configurações do seu provedor de hospedagem465 / 587 · TLS / STARTTLS | Uma porta e um modo de segurança que não combinam. Escolher STARTTLS mantendo a porta 993 abre um socket em texto puro para um listener que só aceita TLS, e a conexão simplesmente expira. Transportes que falham agora são tentados de novo automaticamente na outra combinação padrão. |
Gmail (IMAP) e Gmail (API): uma caixa do Google se conecta com senha de app via imap.gmail.com. Uma caixa conectada com login do Google usa a API do Gmail em vez de IMAP e continua funcionando. O caminho escolhido define o que o agente pode fazer depois, então a tabela de recursos abaixo tem uma coluna para cada um: Gmail (IMAP) para a senha de app e Gmail (API) para o login com o Google.
Detecção automática de transporte: uma conexão que nunca chegou a estabelecer uma sessão é tentada de novo no outro transporte padrão (IMAP 993/TLS e 143/STARTTLS; SMTP 465/TLS, 587/STARTTLS e 25). Uma senha recusada nunca é tentada de novo, porque reenviá-la conta para o bloqueio do próprio provedor.
Mecanismo de login: a maioria dos servidores aceita AUTH PLAIN em uma única ida e volta. Servidores que anunciam apenas GSSAPI, NTLM e LOGIN, sendo o Microsoft Exchange o caso mais comum, respondem com 504 5.7.4, e o cliente passa sozinho para AUTH LOGIN.
Outros provedores: IONOS, Hostinger, OVH, OVH Hosted Exchange, DreamHost, Titan Email, Namecheap Private Email, Migadu, InMotion Hosting, OpenSRS, GMX e mail.com são reconhecidos pelo endereço ou pelo host de e-mail que você digita, e os hosts, as portas e a segurança do transporte são preenchidos para você.
Dados brutos: os hosts, as portas, os mecanismos de login e os limites de tamanho que testamos em cada provedor estão publicados como um conjunto de dados aberto, com downloads gratuitos em JSON e CSV.
O que o agente pode fazer depois de conectado
As operações que um cliente MCP pode executar em cada provedor: ler, buscar, enviar, responder, encaminhar, mover, sinalizar, pastas, rascunhos, envio agendado e anexos.
Gmail (IMAP), Fastmail, iCloud, Yahoo, Zoho, Yandex e IMAP genérico se conectam pelo mesmo transporte IMAP/SMTP (Gmail, Fastmail e iCloud usam uma senha de app) e têm exatamente os mesmos recursos, inclusive a sintaxe de busca IMAP. As colunas aparecem separadas para maior clareza. Gmail (API) é a única coluna do Gmail que não é IMAP: a mesma caixa de correio, acessada pelo login com o Google e pela API do Gmail. O Outlook também não é IMAP: ele se conecta com login da Microsoft e funciona pelo Microsoft Graph.
Cada caixa de entrada informa um perfil versionado ao agente MCP:
exact significa que a operação normalizada mantém o seu significado, different significa que o provedor usa uma semântica alternativa documentada, e unavailable significa que o MCPEmails não vai enfraquecer a requisição em silêncio. Os perfis descrevem o comportamento do conector sem inspecionar nem armazenar e-mails.| Recurso | Gmail (IMAP) | Gmail (API) | Outlook | Fastmail | iCloud | Yahoo | Zoho | Yandex | IMAP genérico |
|---|---|---|---|---|---|---|---|---|---|
| Essencial | |||||||||
| Baixar original (.eml) | |||||||||
| Ler e-mails | |||||||||
| Buscar | |||||||||
| Enviar e-mails | |||||||||
| Responder | |||||||||
| Encaminhar | |||||||||
| Sinalizadores e status | |||||||||
| Lido/não lido + estrela | |||||||||
| Pastas e marcadores | |||||||||
| Pastas | |||||||||
| Marcadores / tags | |||||||||
| Mover | |||||||||
| Copiar | |||||||||
| Exclusão | |||||||||
| Excluir / lixeira | |||||||||
| Exclusão permanente (expunge) | |||||||||
| Rascunhos | |||||||||
| Rascunhos (criar / editar / enviar) | |||||||||
| Contatos | |||||||||
| Busca de contatos (varredura ao vivo) | |||||||||
| Agendamento | |||||||||
| Envio agendado | |||||||||
| Assinaturas | |||||||||
| Assinaturas (aplicadas automaticamente no envio) | |||||||||
| Busca | |||||||||
| Sintaxe de busca | IMAP | Gmail | KQL | IMAP | IMAP | IMAP | IMAP | IMAP | IMAP |
Pastas x marcadores no Gmail: o Gmail usa um sistema plano de marcadores em vez de pastas hierárquicas. "Mover" é implementado como adicionar/remover marcador. A cópia nativa não está disponível pela API REST do Gmail. Estas linhas do Gmail descrevem o conector da API do Gmail: uma caixa Gmail conectada com senha de app via IMAP segue as colunas IMAP, inclusive na cópia.
Outlook (Microsoft Graph): a busca usa KQL. Um critério de texto (from, to, cc, subject, body, text ou query) não pode ser combinado com os filtros unread, has_attachment, flagged ou de data: quando os dois são enviados, esses filtros não são aplicados e o resultado informa quais foram descartados, enquanto uma ferramenta que age sobre todas as mensagens encontradas recusa a combinação. O Outlook tem pastas, não marcadores, então as ferramentas de marcadores são exclusivas do Gmail; a ação label de uma automação aplica uma categoria do Outlook. Anexos: até 10 MB por mensagem no envio, e até 25 MB ao baixar um anexo ou encaminhar um original.
Exclusão permanente: a API do Gmail move uma mensagem excluída para a Lixeira e não oferece expunge permanente. O Microsoft Graph oferece: permanent: true numa caixa Outlook usa o permanentDelete dele, que pula os Itens Excluídos. Toda caixa IMAP (Gmail com senha de app, Fastmail, iCloud, Yahoo, Zoho, Yandex, Genérico) suporta tanto lixeira quanto expunge definitivo.
Busca de contatos (varredura ao vivo): todos os provedores suportam contact_search, que encontra correspondentes com uma varredura ao vivo, só dos cabeçalhos, de uma janela recente dos seus e-mails correspondentes. Não existe tabela de contatos: nada é armazenado entre as chamadas, e as contagens refletem só as mensagens encontradas na janela varrida.
Agendamento: suportado em todos os provedores por meio de uma fila scheduled_sends no servidor. Use as ações create, list e cancel da ferramenta schedule. A entrega usa o caminho de envio já existente de cada provedor, então nenhuma API de agendamento nativa do provedor é necessária.
Assinaturas: uma assinatura por caixa de entrada é adicionada no servidor em todo envio, resposta, encaminhamento, rascunho e mensagem agendada. Isso funciona em todos os provedores. As assinaturas aceitam formatação HTML rica (negrito, itálico, títulos, listas, cores, alinhamento, links) e um logo/imagem hospedado; defina-as no editor rico do painel ou pela ferramenta MCP signature (que aceita signature_html). As imagens são referenciadas como URLs https hospedadas e aparecem em todos os provedores, embora alguns clientes (ex.: Gmail) possam ocultá-las até o destinatário clicar em "exibir imagens", o que é normal em qualquer assinatura com imagem hospedada. Use signature_reply_mode para controlar se a assinatura aparece em respostas e encaminhamentos. Por chamada, passe include_signature: false em email_compose ou draft para omiti-la. Na mesma área da caixa de entrada, o painel também tem o campo Nome do remetente, o nome de exibição que os destinatários veem ao lado do endereço em tudo o que a caixa envia.
Encaminhamento: em todos os provedores, um encaminhamento repassa a mensagem original byte a byte: HTML, imagens inline, anexos e estrutura MIME chegam exatamente como foram enviados, abaixo da sua nota e do cabeçalho habitual de mensagem encaminhada. Originais de até 25 MB. as_attachment envia o original inteiro como uma parte .eml, e include_attachments: false deixa os arquivos anexados para trás.
Pronto para conectar sua caixa de entrada?
Plano Free: uma caixa de entrada conectada, para sempre, sem cartão.