Lettermint

Conecte um cliente de IA ao Lettermint para inspecionar a atividade de e-mail e gerenciar sua configuração de e-mail. O Lettermint hospeda o servidor, então você não precisa instalar um processo local.

Codehttps://api.lettermint.co/mcp

Antes de conectar

Você precisa de:

• Uma conta Lettermint verificada e ativa.
• Pelo menos uma equipe com acesso MCP habilitado.
• Um cliente MCP que suporte servidores remotos Streamable HTTP e OAuth.

Use OAuth para conectar. Tokens de API de projeto e tokens de API de equipe não funcionam com o servidor MCP hospedado.

Conecte seu cliente

Escolha seu cliente. Usuários do Cursor também podem adicionar o Lettermint com um clique.

Os clientes nomeados abaixo registram um cliente OAuth automaticamente. Você não precisa inserir um ID de cliente OAuth ou segredo de cliente.

Execute estes comandos:

Codecodex mcp add lettermint --url https://api.lettermint.co/mcp
codex mcp login lettermint

Use /mcp no Codex ou execute codex mcp list para verificar a conexão.

O aplicativo de desktop ChatGPT, o Codex CLI e a extensão Codex IDE compartilham configurações de MCP para o mesmo host Codex. Um servidor que você adiciona com o Codex CLI está disponível no aplicativo de desktop ChatGPT nesse host. Se você usar o aplicativo de desktop, abra Configurações > Servidores MCP, adicione um servidor Streamable HTTP com a URL acima, salve, reinicie o aplicativo e faça login.

Seu cliente abre um navegador. Entre no Lettermint, revise a conexão e aprove o acesso.

O ChatGPT web usa ferramentas MCP remotas fornecidas por plugins. Ele não carrega as configurações de MCP dos seus clientes Codex locais.

Verifique a conexão

Comece com uma solicitação somente leitura:

Use o Lettermint para listar minhas equipes e projetos. Não altere nada.

O cliente deve chamar list_teams primeiro. Esta ferramenta retorna apenas as equipes às quais você pode acessar via MCP. Ela também retorna as capacidades efetivas para cada equipe.

O que você pode fazer

O Lettermint fornece ferramentas focadas para estas áreas:

Área	Capacidades
Pesquisa de documentação	Encontre orientações sobre produtos e API do Lettermint.
Equipes, funções e membros	Liste equipes e capacidades efetivas. Inspecione funções e membros. Atualize configurações de equipe ou atribuições de membros quando permitido.
Projetos e rotas	Liste, crie, atualize e exclua projetos e rotas.
Domínios e DNS	Gerencie domínios e associações de projetos. Verifique DNS de envio e valide domínios de entrada.
Atividade de e-mail, conteúdo, estatísticas e uso	Pesquise mensagens, inspecione eventos de entrega, leia conteúdo de mensagens permitido, revise estatísticas de entrega e verifique uso.
Envio e e-mail agendado	Envie uma mensagem ou um lote. Agende, reagende ou cancele mensagens.
Webhooks	Gerencie endpoints de webhook, inspecione entregas, envie testes e gire segredos de assinatura.
Supressões	Pesquise, adicione e remova entradas de supressão.

Seu cliente MCP carrega nomes de ferramentas atuais e esquemas de entrada do catálogo ao vivo. Use list_teams para ver as ações que sua função pode usar para cada equipe.

Como o acesso funciona

• A conexão OAuth pertence à sua conta de usuário, não a uma equipe.
• Cada solicitação com escopo de equipe inclui um team_id explícito. Cada solicitação com escopo de projeto também inclui um project_id explícito.
• O Lettermint verifica sua associação atual, acesso ao projeto, permissões de função, requisitos de MFA e configurações de equipe em cada chamada.
• Desabilitar o MCP para uma equipe bloqueia conexões novas e existentes dessa equipe imediatamente. Isso não desconecta o usuário de outras equipes.
• Ler metadados de mensagem e ler conteúdo de mensagem são permissões separadas.
• O conteúdo da mensagem segue a política de retenção de dados.
• As credenciais OAuth do MCP funcionam apenas com o servidor MCP hospedado. Elas não podem chamar /v1 ou /rest/v1.

Consulte Funções e Acesso a projetos para as permissões que o Lettermint aplica.

Filtragem de informações pessoais

A filtragem de informações pessoais está habilitada por padrão para cada equipe. O filtro limita dados que podem identificar uma pessoa e ações que podem confirmar uma identidade.

Área	Resultado enquanto a filtragem está habilitada
Listas e detalhes de mensagens	O Lettermint oculta identidades de remetente e destinatário, nomes de destinatários, assuntos, tags, metadados, nomes de anexos e tipos de mídia. IDs de entrega, datas, status e outros campos operacionais permanecem disponíveis.
Conteúdo de mensagens	Corpos de mensagens e fonte bruta não estão disponíveis.
Pesquisas de identidade	Pesquisas de mensagens por texto livre e pesquisas por valor de supressão não estão disponíveis.
Membros da equipe	Listas de membros, detalhes de membros e alterações de atribuição de membros não estão disponíveis. Definições de funções permanecem disponíveis.
Envio	Envio individual e em lote não estão disponíveis.
Supressões	Valores estão ocultos. Novas entradas e pesquisas por valor não estão disponíveis. A remoção por ID de supressão ainda pode estar disponível.
Configuração	Configuração permitida de equipe, projeto, rota, domínio e webhook permanece disponível.

Um membro com Gerenciar segurança da equipe pode alterar essa configuração em Gerenciar equipe > Configurações.

Se você desativar o filtro, um cliente MCP pode receber informações pessoais e realizar ações relacionadas à identidade permitidas. As verificações normais de função e projeto ainda se aplicam.

Ações de escrita e confirmações

As ações do MCP alteram dados ao vivo do Lettermint quando suas permissões e configurações de equipe permitem.

• Ações destrutivas exigem confirm=true. O Lettermint rejeita a ação sem esse valor.
• Cada envio de e-mail exige um idempotency_key. Consulte Idempotência.
• A criação de webhook retorna o segredo de assinatura uma vez. A rotação de segredo também retorna o novo segredo uma vez e exige confirmação. Ferramentas de leitura de webhook nunca retornam um segredo de assinatura.
• Seu cliente MCP pode exigir sua própria aprovação ou bloquear uma ação de escrita antes que a solicitação chegue ao Lettermint.

Use o endereço de teste do Lettermint ao testar o envio:

Envie um e-mail de teste para ok@lettermint.dev. Use uma nova chave de idempotência. Mostre-me os detalhes da mensagem antes de enviá-la.

Mensagens para este endereço simulam uma entrega bem-sucedida. Elas não chegam a uma caixa de entrada real. Consulte Endereços de e-mail de teste.

Exemplos de prompts

• "Liste as equipes e projetos do Lettermint aos quais posso acessar."
• "Resuma as estatísticas de entrega deste projeto nos últimos sete dias."
• "Encontre mensagens com falha de hoje e explique seus eventos de entrega."
• "Verifique o estado de verificação de DNS para este domínio de envio."
• "Crie um projeto e adicione uma rota para seu tráfego de produção. Mostre-me as mudanças planejadas primeiro."
• "Agende um e-mail para amanhã às 09:00 Europa/Amsterdã. Mostre-me a mensagem e a hora antes de enviá-la."
• "Crie um webhook para eventos de falha e entrega e envie um evento de teste."
• "Pesquise na documentação do Lettermint sobre domínios de envio e DKIM."

Gerencie a conexão

Abra Configurações do usuário > Aplicativos para revisar ou revogar uma conexão. Revogar uma conexão invalida seu acesso MCP em todas as equipes.

Um membro com Gerenciar segurança da equipe pode abrir Gerenciar equipe > Configurações para desabilitar o acesso MCP ou alterar a filtragem de informações pessoais de uma equipe.

Solução de problemas

Problema	O que verificar
O registro OAuth falhou antes	Remova a entrada de conector ou servidor Lettermint com falha. Adicione novamente com https://api.lettermint.co/mcp. Selecione registro automático se o cliente oferecer essa opção.
O Lettermint não aparece no Codex	Execute codex mcp list ou use /mcp. Confirme que o servidor está habilitado e autenticado. Reinicie o aplicativo de desktop ou IDE após adicionar o servidor.
O ChatGPT web não mostra o Lettermint	O ChatGPT web não carrega configurações locais de MCP do Codex. Ele pode usar ferramentas MCP remotas quando um plugin instalado as fornece.
A página de login não está disponível	Confirme que sua conta está ativa e verificada. Confirme que pelo menos uma equipe permite acesso MCP.
Uma equipe ou projeto está ausente	Verifique sua associação, atribuição de projeto, estado de MFA e a configuração Permitir acesso MCP da equipe.
Uma ferramenta retorna erro de permissão	Verifique sua função. Uma nova conexão não altera suas permissões.
Dados pessoais ou envio indisponíveis	Verifique a configuração de filtragem de informações pessoais da equipe.
Envio negado com filtragem desativada	Verifique verificação do remetente, status da equipe, cota, limites de gastos e supressões.
O cliente bloqueia uma ação de escrita	Revise as configurações de aprovação e segurança do cliente. Se o cliente bloquear a ação, o Lettermint não recebe nenhuma chamada de ferramenta.
Um segredo de assinatura de webhook está ausente	O Lettermint retorna o segredo apenas após criação ou rotação. Gire o segredo com confirmação se você não o armazenou.
Um token OAuth não pode chamar /v1 ou /rest/v1	Isso é esperado. As credenciais OAuth do MCP funcionam apenas com o servidor MCP hospedado.

Documentação relacionada

Funções

Revise as permissões que o MCP segue.

Acesso a projetos

Controle quais projetos um membro da equipe pode usar.

Endereços de e-mail de teste

Teste resultados de entrega sem enviar para uma caixa de entrada real.

Segurança de conta e equipe

Revise os controles de segurança de conta e equipe.