Cómo conectar Mailtrap a Gemini vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Mailtrap, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Mailtrap + Gemini

Trabaja con una cuenta de Mailtrap desde cualquier agente de IA: envía emails transaccionales, masivos y por lotes, pruébalos en Email Sandbox con informes de spam y HTML, gestiona dominios de envío, supresiones y plantillas, sigue cada mensaje enviado en los registros, consulta estadísticas de envío y lleva contactos, listas y campañas de Email Marketing. Un solo token de API; los borrados irreversibles vienen desactivados.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

MAILTRAP_API_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 3 minutos. Necesitas una cuenta de Mailtrap.

1. En Mailtrap abre Settings, API Tokens (https://mailtrap.io/api-tokens) y crea un token. Dale acceso a los dominios de envío (para envío, estadísticas, registros y supresiones), a los sandboxes o proyectos (para Email Sandbox) y, si lo usas, a Email Marketing. Cambiar supresiones requiere acceso de admin.
2. Pégalo en MAILTRAP_API_TOKEN. Se envía como Authorization: Bearer <token> y no caduca hasta que lo restableces.
3. Instala el conector y ejecuta mailtrap_list_accounts: muestra la cuenta con tu nivel de acceso (1000 owner, 100 admin, 10 viewer) y confirma el token. Un token pertenece a una sola cuenta y cada llamada trabaja sobre esa cuenta, así que no hace falta un id de cuenta.
4. El envío real necesita un dominio de envío verificado (mailtrap_list_sending_domains); Email Sandbox funciona sin él.

Mailtrap sirve sus áreas desde hosts distintos y el conector elige el adecuado en cada herramienta: https://mailtrap.io para gestión e informes, https://send.api.mailtrap.io para el envío transaccional, https://bulk.api.mailtrap.io para el stream Bulk y https://sandbox.api.mailtrap.io para los envíos de prueba a un sandbox.

Envío: mailtrap_send_email envía un email transaccional a hasta 1000 destinatarios, mailtrap_send_batch_emails hasta 500 emails distintos en una llamada (50 MB como máximo). El email de marketing y otros envíos masivos van por el stream Bulk con mailtrap_send_bulk_email y mailtrap_send_bulk_batch_emails, que separa el tráfico promocional del transaccional. El contenido es text, html o ambos, o una plantilla guardada: template_uuid (el uuid de mailtrap_list_templates, no el id numérico) con template_variables, sin subject, text, html ni category. from_email debe estar en un dominio de envío verificado; to, cc y bcc son listas de {"email", "name"}; los adjuntos van en Base64 en content. Cada envío llega a buzones reales, así que la IA te muestra destinatarios, remitente, asunto y contenido y espera tu sí. Un envío devuelve message_ids, uno por destinatario. Las llamadas por lotes responden 200 aunque fallen mensajes sueltos: la IA revisa success y errors de cada entrada en responses.

Email Sandbox: mailtrap_send_sandbox_email envía un email de prueba que queda atrapado en un sandbox y nunca se entrega, la forma segura de probar una plantilla o un contenido nuevo. Después la IA lee los mensajes atrapados (mailtrap_list_sandbox_messages, mailtrap_get_sandbox_message), el cuerpo como texto, HTML de vista previa, código HTML o MIME en bruto, las cabeceras, los adjuntos, el informe de SpamAssassin con puntuación y reglas activadas y la revisión de HTML que muestra qué elementos y propiedades CSS no admiten qué clientes de correo. También lista proyectos y sandboxes y crea sandboxes; las credenciales SMTP no aparecen en ninguna respuesta.

Dominios y entregabilidad: lista y lee los dominios de envío con los registros DNS que hay que publicar (SPF, DKIM, DMARC, return path) y su verificación, añade un dominio y envía por email las instrucciones de DNS a quien gestiona el DNS. Las direcciones suprimidas (rebote duro, baja, queja de spam, importación manual) se listan con el mensaje que las causó; mailtrap_create_suppression deja de enviar a una dirección. Para un email concreto, mailtrap_list_email_logs filtra por destinatario, estado, eventos, categoría y hora de envío, y mailtrap_get_email_log muestra sus eventos de entrega, apertura, clic y rebote con la respuesta del proveedor. mailtrap_get_sending_stats da los totales de un periodo, mailtrap_get_sending_stats_grouped los reparte por dominio, categoría, proveedor de buzón o día, y mailtrap_get_billing_usage muestra el consumo frente al plan.

Plantillas: lista, lee, crea y actualiza plantillas. Las variables usan Handlebars, por ejemplo {{user_name}}; los emails enviados después de un cambio usan la versión nueva.

Email Marketing: contactos con estado, listas y campos (crear, leer y actualizar por id o email; eventos propios como purchase para automatizaciones y segmentos; importaciones de hasta 50.000 contactos emparejados por email y seguidas con mailtrap_get_contact_import), listas de contactos y campos de contacto (las merge tags que sirven de claves en fields). Campañas: mailtrap_create_campaign siempre crea un borrador, mailtrap_update_campaign cambia un borrador, mailtrap_schedule_campaign fija una hora como mucho un mes por delante, mailtrap_start_campaign envía ya, mailtrap_cancel_campaign devuelve a borrador una campaña programada y mailtrap_get_campaign_stats muestra los resultados. Programar e iniciar escriben a toda la audiencia: la IA confirma antes contigo campaña, audiencia y hora. Añade solo contactos que aceptaron recibir email y, para dejar de escribir a alguien, dale de baja (unsubscribed: true) en lugar de borrarlo.

Desactivadas al instalar: mailtrap_delete_suppression (la dirección vuelve a recibir email), mailtrap_clean_sandbox (borra todos los mensajes de un sandbox) y mailtrap_delete_contact. No se pueden deshacer, así que un admin del workspace las activa cuando el equipo las necesita.

Formatos de datos: los ids de dominios, sandboxes, mensajes, plantillas, listas y campañas son enteros; los contactos, las supresiones y los mensajes de los registros usan UUID. Las horas van en ISO 8601 en UTC. Las tasas de las estadísticas son fracciones (0.25 = 25 %) y sus fechas son YYYY-MM-DD.

Paginación: los contactos pasan pagination.next_token como token hasta que sea null; las campañas usan token como número de página tomado de pagination.next_token. Los registros pasan next_page_cursor como search_after. Las supresiones llegan de 1000 en 1000, con el id del último elemento como last_id. Los mensajes del sandbox llegan de 30 en 30, con page o el id del último mensaje como last_id.

Límites: 150 peticiones cada 10 segundos por token; Contactos 200 por minuto, Estadísticas y Supresiones 10 por minuto, listar los registros 60 por minuto por cuenta.

Errores frecuentes: 401 Incorrect API token indica un token incorrecto o sin acceso a ese dominio o sandbox. 403 es un permiso que falta: edita el token en Settings, API Tokens. 404 es un id desconocido. 422 es una entrada no válida con el motivo en errors, por ejemplo un remitente fuera de un dominio verificado o una campaña que ya no es borrador. 429 es el límite de peticiones: espera y reintenta.

El conector no borra dominios de envío, sandboxes, plantillas ni campañas y no devuelve las credenciales SMTP de los sandboxes.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Gemini

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Mailtrap.

Herramientas disponibles

Ejemplos de prompts

• "¿Se entregó esta mañana la confirmación de pedido a [email protected]? Enséñame sus eventos."
• "Envía esta nueva plantilla de bienvenida a nuestro sandbox de pruebas y dime su puntuación de spam y qué clientes de correo tienen problemas con el HTML."
• "¿Cuáles fueron la semana pasada nuestras tasas de entrega, rebote y spam, separadas por proveedor de buzón?"
• "¿Qué registros DNS de nuestro dominio de envío siguen sin verificar?"
• "Crea un borrador de campaña para la lista Clientes con la plantilla Newsletter noviembre y enséñame la audiencia antes de programarla."

FAQ

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Meta Muse
• Conectar a Microsoft Copilot