Acesso somente leitura

O que uma conexão somente leitura pode fazer

• Ela tem a permissão read:email e, opcionalmente, search:email, que não acrescenta nada além disso.
• Ela pode listar, ler e pesquisar mensagens, baixar anexos e listar caixas de entrada e pastas.
• Ela não pode enviar, responder, criar rascunhos, mover, sinalizar, marcar como lido, excluir, agendar nem criar automações.

Como escolher esse acesso

• Quando você conecta um cliente de IA, a tela de consentimento oferece níveis de acesso. Escolha Somente leitura ("Lê e pesquisa seus e-mails. Não envia, altera nem exclui nada.") ou abra Personalizar permissões e conceda só leitura. Você também pode limitar a conexão a algumas das suas caixas de entrada.
• O ChatGPT abre essa tela em Acesso total, porque não consegue voltar depois para pedir mais acesso. Selecione Somente leitura antes de clicar em Permitir acesso.
• Chaves de API criadas no painel podem ser limitadas às mesmas permissões.

Como os limites são aplicados

• Cada chamada de ferramenta é verificada contra as permissões da conexão antes de entrarmos em contato com o seu servidor de e-mail. Uma chamada fora do que foi concedido é recusada com insufficient_scope.
• Em caixas de correio IMAP, uma conexão somente leitura abre cada pasta com EXAMINE, a forma somente leitura de SELECT. Assim, o próprio provedor de e-mail recusa qualquer mudança de sinalização, movimentação ou exclusão nessa sessão, independentemente do que o nosso código faça.
• As mensagens são buscadas com BODY.PEEK, então ler uma mensagem nunca a marca como lida. Isso vale para todas as conexões, não só as somente leitura.
• A ferramenta de leitura nunca altera sua caixa de correio. A antiga opção mark_as_read foi removida; marcar como lido é uma ação separada que exige a permissão manage:folders.
• Clientes de IA que entram com OAuth veem a lista completa de ferramentas, para poderem pedir mais acesso a você. Essas chamadas continuam falhando até você conceder o acesso.

O que acontece quando você conecta

• Abrimos uma conexão TLS, verificamos o certificado do servidor, fazemos login uma vez para conferir sua senha ou senha de app e saímos.
• Nada é baixado, copiado ou indexado. As mensagens são buscadas no seu provedor só quando uma ferramenta as solicita.
• Só há trabalho em segundo plano para recursos que você ativa. Automações, envios agendados, lembretes de acompanhamento e sonecas exigem permissões de escrita que uma conexão somente leitura não tem. O resumo matinal e os webhooks de e-mail novo são configurações do painel, não permissões da conexão: o resumo lê a sua caixa de entrada e adiciona uma mensagem a ela, e os webhooks verificam se há e-mail novo. Os dois ficam desativados até você ativá-los.
• Se você nunca quiser enviar a partir do endereço, escolha Configurações avançadas → Tipo de conexão → Só receber (IMAP) ao conectá-lo. Nenhum servidor SMTP é configurado ou contatado.

Pesquisa em caixas de correio grandes

• Em caixas de correio IMAP, a pesquisa roda no servidor do seu provedor com o SEARCH do IMAP. Baixamos só a página de resultados solicitada, com até 100 mensagens, e a IA percorre o restante página por página.
• A pesquisa cobre a caixa de entrada, a menos que uma pasta seja indicada, porque pesquisar todas as pastas de uma conta grande é lento.
• Cada pesquisa tem um limite de 30 segundos. Em uma caixa de correio com dezenas de milhares de mensagens, refine uma pesquisa ampla por remetente, assunto ou data.

Confira você mesmo

O MCPEmails é de código aberto. Estes arquivos implementam e testam o que esta página descreve:

• imap-read-only.ts EXAMINE para conexões somente leitura
• imap-read-only.test.ts Testes do EXAMINE, incluindo o provedor recusando uma mudança de sinalização
• scopes.ts A lista de permissões
• argument-aliases.ts Remoção do mark_as_read da ferramenta de leitura
• imap-client.ts O cliente IMAP: toda busca de conteúdo usa BODY.PEEK