EngageLab Agent Email MCP Server

English | 简体中文

Envía, recibe y responde correos electrónicos desde agentes de IA — a través del Model Context Protocol.

Cada agente tiene su propio buzón: una dirección real que envía y recibe, con conversaciones agrupadas en hilos para que tu agente tenga contexto. Funciona con Claude Desktop, Claude Code, Cursor, Cowork y cualquier cliente compatible con MCP.

{
  "mcpServers": {
    "engagelab-email": {
      "command": "npx",
      "args": ["-y", "@engagelabemail/mcp"],
      "env": { "ENGAGELAB_EMAIL_SECRET_KEY": "sk_sg_your_key" }
    }
  }
}

Por qué

La mayoría de las API de correo son solo de envío. Los agentes que necesitan mantener una conversación por correo — soporte, programación, aprobaciones — necesitan una bandeja de entrada.

• Enviar y recibir — el agente posee un buzón dedicado, no un webhook de parseo añadido

• Consciente de hilos — las respuestas se agrupan en conversaciones, para que el agente vea el historial completo

• Modo sandbox — prueba los flujos del agente sin enviar correos a humanos reales

• Una variable de entorno — sin baile de OAuth para uso local; la región se infiere de la clave

Herramientas

Inicio rápido

1. Obtén una clave secreta. Crea una cuenta de EngageLab y genera una clave desde la consola (formato sk_sg_xxx — el prefijo selecciona la región). O usa la CLI: engagelab-email-cli login crea una a través del navegador.

2. Crea un buzón. En la consola, crea un buzón para tu agente (el subdominio compartido es instantáneo; los dominios personalizados requieren verificación DNS). La creación programática de buzones está en la hoja de ruta — consulta Solución de problemas si list_mailboxes devuelve vacío.

3. Registra el servidor.

Claude Desktop — añade el bloque JSON anterior a claude_desktop_config.json.

Claude Code:

claude mcp add engagelab-email \
  -e ENGAGELAB_EMAIL_SECRET_KEY=sk_sg_your_key \
  -- npx -y @engagelabemail/mcp

Luego pídele a tu agente:

Lista mis buzones, luego envía un correo desde el primero a bob@example.com diciendo que la factura está aprobada.

Un bucle típico de agente para un bot de soporte:

check_new_messages()            → [messageUids]
get_message(uid)                → body, attachments
list_thread_messages(threadId)  → full conversation context
reply_email(uid, { text: ... }) → response lands in the same thread

Configuración

Límites: hasta 10 adjuntos / 10MB en total por mensaje (codificados en base64 en el esquema de la herramienta).

Solución de problemas

• list_mailboxes devuelve una lista vacía — tu cuenta aún no tiene buzón. Crea uno en la consola de EngageLab (ver paso 2 de Inicio rápido). Los agentes aún no pueden autoaprovisionar buzones.

• 401 / code 100101 — la clave secreta es incorrecta o ha sido revocada. Verifica ENGAGELAB_EMAIL_SECRET_KEY y que el prefijo de región de la clave (sk_sg_ / sk_tr_) coincida con el endpoint que usas.

• No se pudo determinar la URL base de la API — el prefijo de región de la clave no es reconocido. Establece ENGAGELAB_EMAIL_BASE_URL explícitamente.

• La respuesta aparece como una nueva conversación — usa reply_email (no send_email) para que los encabezados In-Reply-To y el hilo se mantengan intactos.

Hoja de ruta

• MCP alojado (OAuth) para uso remoto sin configuración

• Creación programática de buzones mediante clave secreta

• Push por webhook (sin sondeo) para check_new_messages

• Referencias de adjuntos basadas en URL (sin base64 en el contexto)

Ejecutar desde el código fuente

git clone https://github.com/Metaverse-Cloud/engagelab-email-mcp
cd engagelab-email-mcp
npm install && npm run build
ENGAGELAB_EMAIL_SECRET_KEY=sk_sg_xxx node dist/index.cjs

Relacionados

• EngageLab Agent Email CLI — los mismos buzones desde la terminal, salida --json para agentes

• EngageLab Node SDK / Python SDK — envía correo desde código

Licencia

MIT