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:
| Área | Capacidades |
|---|---|
| Búsqueda de documentación | Encuentra guías de producto y API de Lettermint. |
| Equipos, roles y miembros | Lista equipos y capacidades efectivas. Inspecciona roles y miembros. Actualiza la configuración del equipo o las asignaciones de miembros cuando esté permitido. |
| Proyectos y rutas | Lista, crea, actualiza y elimina proyectos y rutas. |
| Dominios y DNS | Gestiona dominios y asociaciones de proyectos. Comprueba el DNS de envío y verifica dominios de entrada. |
| Actividad de correo, contenido, estadísticas y uso | Busca mensajes, inspecciona eventos de entrega, lee el contenido de mensajes permitido, revisa estadísticas de entrega y comprueba el uso. |
| Envío y correo programado | Envía un mensaje o un lote. Programa, reprograma o cancela mensajes. |
| Webhooks | Gestiona endpoints de webhook, inspecciona entregas, envía pruebas y rota secretos de firma. |
| Supresiones | Busca, 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_idexplícito. Cada solicitud con ámbito de proyecto también incluye unproject_idexplí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
/v1ni/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.
| Área | Resultado mientras el filtrado está habilitado |
|---|---|
| Listas y detalles de mensajes | Lettermint 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 mensajes | Los cuerpos de mensajes y la fuente original no están disponibles. |
| Búsquedas de identidad | Las búsquedas de mensajes de texto libre y las búsquedas por valor de supresión no están disponibles. |
| Miembros del equipo | Las listas de miembros, detalles de miembros y cambios de asignación de miembros no están disponibles. Las definiciones de roles permanecen disponibles. |
| Envío | El envío individual y por lotes no está disponible. |
| Supresiones | Los 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ón | La 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
| Problema | Qué comprobar |
|---|---|
| El registro OAuth falló antes | Elimina 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 Codex | Ejecuta 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 Lettermint | ChatGPT 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á disponible | Confirma que tu cuenta está activa y verificada. Confirma que al menos un equipo permite el acceso MCP. |
| Falta un equipo o proyecto | Comprueba 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 permiso | Comprueba tu rol. Una conexión nueva no cambia tus permisos. |
| Los datos personales o el envío no están disponibles | Comprueba la configuración de filtrado de información personal del equipo. |
| El envío se deniega cuando el filtrado está desactivado | Comprueba 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 escritura | Revisa 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 webhook | Lettermint 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/v1 | Esto 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.