Lettermint

Correo electrónico transaccional europeo

Documentación

Conecta un cliente de IA a Lettermint para inspeccionar la actividad de correo electrónico y gestionar tu configuración de correo. Lettermint aloja el servidor, por lo que no necesitas instalar un proceso local.

Codehttps://api.lettermint.co/mcp

Antes de conectarte

Necesitas:

  • Una cuenta de Lettermint verificada y activa.
  • Al menos un equipo donde el acceso MCP esté habilitado.
  • Un cliente MCP que admita servidores HTTP Streamable remotos y OAuth.

Usa OAuth para conectarte. Los tokens de API de proyecto y los tokens de API de equipo no funcionan con el servidor MCP alojado.

Conecta tu cliente

Elige tu cliente. Los usuarios de Cursor también pueden añadir Lettermint con un clic.

Los clientes nombrados a continuación registran un cliente OAuth automáticamente. No necesitas introducir un ID de cliente OAuth ni un secreto de cliente.

Ejecuta estos comandos:

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

Usa /mcp en Codex o ejecuta codex mcp list para comprobar la conexión.

La aplicación de escritorio de ChatGPT, Codex CLI y la extensión de IDE de Codex comparten la configuración de MCP para el mismo host de Codex. Un servidor que añadas con Codex CLI estará disponible en la aplicación de escritorio de ChatGPT en ese host. Si usas la aplicación de escritorio, abre Configuración > Servidores MCP, añade un servidor HTTP Streamable con la URL anterior, guárdalo, reinicia la aplicación e inicia sesión.

Tu cliente abre un navegador. Inicia sesión en Lettermint, revisa la conexión y aprueba el acceso.

ChatGPT web usa herramientas MCP remotas proporcionadas por plugins. No carga la configuración de MCP desde tus clientes locales de Codex.

Comprueba la conexión

Comienza con una solicitud de solo lectura:

Usa Lettermint para listar mis equipos y proyectos. No cambies nada.

El cliente debería llamar a list_teams primero. Esta herramienta devuelve solo los equipos a los que puedes acceder a través de MCP. También devuelve las capacidades efectivas para cada equipo.

Lo que puedes hacer

Lettermint proporciona herramientas enfocadas para estas áreas:

ÁreaCapacidades
Búsqueda de documentaciónEncuentra guías de producto y API de Lettermint.
Equipos, roles y miembrosLista equipos y capacidades efectivas. Inspecciona roles y miembros. Actualiza la configuración del equipo o las asignaciones de miembros cuando esté permitido.
Proyectos y rutasLista, crea, actualiza y elimina proyectos y rutas.
Dominios y DNSGestiona dominios y asociaciones de proyectos. Comprueba el DNS de envío y verifica dominios de entrada.
Actividad de correo, contenido, estadísticas y usoBusca mensajes, inspecciona eventos de entrega, lee el contenido de mensajes permitido, revisa estadísticas de entrega y comprueba el uso.
Envío y correo programadoEnvía un mensaje o un lote. Programa, reprograma o cancela mensajes.
WebhooksGestiona endpoints de webhook, inspecciona entregas, envía pruebas y rota secretos de firma.
SupresionesBusca, añade y elimina entradas de supresión.

Tu cliente MCP carga los nombres de herramientas y esquemas de entrada actuales desde el catálogo en vivo. Usa list_teams para ver las acciones que tu rol puede usar para cada equipo.

Cómo funciona el acceso

  • La conexión OAuth pertenece a tu cuenta de usuario, no a un equipo.
  • Cada solicitud con ámbito de equipo incluye un team_id explícito. Cada solicitud con ámbito de proyecto también incluye un project_id explícito.
  • Lettermint comprueba tu membresía actual, acceso a proyectos, permisos de rol, requisitos de MFA y configuración del equipo en cada llamada.
  • Deshabilitar MCP para un equipo bloquea conexiones nuevas y existentes de ese equipo de inmediato. No desconecta al usuario de otros equipos.
  • Leer metadatos de mensajes y leer contenido de mensajes son permisos separados.
  • El contenido de los mensajes sigue la política de retención de datos.
  • Las credenciales OAuth de MCP funcionan solo con el servidor MCP alojado. No pueden llamar a /v1 ni /rest/v1.

Consulta Roles y Acceso a proyectos para conocer los permisos que aplica Lettermint.

Filtrado de información personal

El filtrado de información personal está habilitado por defecto para cada equipo. El filtro limita los datos que pueden identificar a una persona y las acciones que pueden confirmar una identidad.

ÁreaResultado mientras el filtrado está habilitado
Listas y detalles de mensajesLettermint oculta identidades de remitentes y destinatarios, nombres de destinatarios, asuntos, etiquetas, metadatos, nombres de archivos adjuntos y tipos de medios. Los IDs de entrega, fechas, estado y otros campos operativos permanecen disponibles.
Contenido de mensajesLos cuerpos de mensajes y la fuente original no están disponibles.
Búsquedas de identidadLas búsquedas de mensajes de texto libre y las búsquedas por valor de supresión no están disponibles.
Miembros del equipoLas listas de miembros, detalles de miembros y cambios de asignación de miembros no están disponibles. Las definiciones de roles permanecen disponibles.
EnvíoEl envío individual y por lotes no está disponible.
SupresionesLos valores están ocultos. Las nuevas entradas y las búsquedas por valor no están disponibles. La eliminación por ID de supresión puede seguir estando disponible.
ConfiguraciónLa configuración permitida de equipos, proyectos, rutas, dominios y webhooks permanece disponible.

Un miembro con Gestionar seguridad del equipo puede cambiar esta configuración en Gestionar equipo > Configuración.

Si desactivas el filtro, un cliente MCP puede recibir información personal y realizar acciones relacionadas con la identidad permitidas. Las comprobaciones normales de rol y proyecto siguen aplicándose.

Acciones de escritura y confirmaciones

Las acciones de MCP cambian datos en vivo de Lettermint cuando tus permisos y la configuración del equipo lo permiten.

  • Las acciones destructivas requieren confirm=true. Lettermint rechaza la acción sin este valor.
  • Cada envío de correo requiere un idempotency_key. Consulta Idempotencia.
  • La creación de webhooks devuelve el secreto de firma una vez. La rotación de secretos también devuelve el nuevo secreto una vez y requiere confirmación. Las herramientas de lectura de webhooks nunca devuelven un secreto de firma.
  • Tu cliente MCP puede requerir su propia aprobación o bloquear una acción de escritura antes de que la solicitud llegue a Lettermint.

Usa la dirección de prueba de Lettermint cuando pruebes el envío:

Envía un correo de prueba a ok@lettermint.dev. Usa una nueva clave de idempotencia. Muéstrame los detalles del mensaje antes de enviarlo.

Los mensajes a esta dirección simulan una entrega exitosa. No llegan a una bandeja de entrada real. Consulta Direcciones de correo de prueba.

Ejemplos de indicaciones

  • "Lista los equipos y proyectos de Lettermint a los que puedo acceder."
  • "Resume las estadísticas de entrega de este proyecto de los últimos siete días."
  • "Encuentra mensajes fallidos de hoy y explica sus eventos de entrega."
  • "Comprueba el estado de verificación de DNS para este dominio de envío."
  • "Crea un proyecto y añade una ruta para su tráfico de producción. Muéstrame los cambios planificados primero."
  • "Programa un correo para mañana a las 09:00 Europa/Ámsterdam. Muéstrame el mensaje y la hora antes de enviarlo."
  • "Crea un webhook para eventos fallidos y entregados, luego envía un evento de prueba."
  • "Busca en la documentación de Lettermint sobre dominios de envío y DKIM."

Gestiona la conexión

Abre Configuración de usuario > Aplicaciones para revisar o revocar una conexión. Revocar una conexión invalida su acceso MCP en todos los equipos.

Un miembro con Gestionar seguridad del equipo puede abrir Gestionar equipo > Configuración para deshabilitar el acceso MCP o cambiar el filtrado de información personal de un equipo.

Solución de problemas

ProblemaQué comprobar
El registro OAuth falló antesElimina el conector o la entrada de servidor de Lettermint fallido. Añádelo de nuevo con https://api.lettermint.co/mcp. Selecciona registro automático si el cliente te da esa opción.
Lettermint no aparece en CodexEjecuta codex mcp list o usa /mcp. Confirma que el servidor está habilitado y autenticado. Reinicia la aplicación de escritorio o el IDE después de añadir el servidor.
ChatGPT web no muestra LettermintChatGPT web no carga la configuración local de MCP de Codex. Puede usar herramientas MCP remotas cuando un plugin instalado las proporciona.
La página de inicio de sesión no está disponibleConfirma que tu cuenta está activa y verificada. Confirma que al menos un equipo permite el acceso MCP.
Falta un equipo o proyectoComprueba tu membresía, asignación de proyectos, estado de MFA y la configuración Permitir acceso MCP del equipo.
Una herramienta devuelve un error de permisoComprueba tu rol. Una conexión nueva no cambia tus permisos.
Los datos personales o el envío no están disponiblesComprueba la configuración de filtrado de información personal del equipo.
El envío se deniega cuando el filtrado está desactivadoComprueba la verificación del remitente, el estado del equipo, la cuota, los límites de gasto y las supresiones.
El cliente bloquea una acción de escrituraRevisa la configuración de aprobación y seguridad del cliente. Si el cliente bloquea la acción, Lettermint no recibe ninguna llamada de herramienta.
Falta un secreto de firma de webhookLettermint devuelve el secreto solo después de la creación o rotación. Rota el secreto con confirmación si no lo almacenaste.
Un token OAuth no puede llamar a /v1 ni /rest/v1Esto es esperado. Las credenciales OAuth de MCP funcionan solo con el servidor MCP alojado.

Documentación relacionada

Roles

Revisa los permisos que sigue MCP.

Acceso a proyectos

Controla qué proyectos puede usar un miembro del equipo.

Direcciones de correo de prueba

Prueba resultados de entrega sin enviar a una bandeja de entrada real.

Seguridad de cuenta y equipo

Revisa los controles de seguridad de cuenta y equipo.