Lumail MCP

Automatiza tu marketing por correo electrónico con lumail (workflow, suscriptores, etc.)

Ver en lumail.ioPrueba este MCPPatrocinado

Documentación

El servidor MCP (Protocolo de Contexto de Modelo) de Lumail permite que un asistente de IA lea y gestione suscriptores, campañas, Workflows, etiquetas, segmentos, configuraciones y análisis a nivel de organización.

El catálogo de herramientas se genera a partir de las mismas definiciones utilizadas por el agente integrado de Lumail, la CLI, el SDK y la API de Tools. Utilice el descubrimiento de herramientas MCP como fuente de verdad en lugar de depender de un número fijo de herramientas.

Elija un endpoint

ClienteEndpointAutenticaciónPerfil de seguridad
ChatGPT y Codexhttps://lumail.io/mcpLumail OAuthCatálogo seleccionado de lectura y borrador-escritura
Claude, Cursor y clientes MCP de confianzahttps://lumail.io/api/mcp/sseToken de API de organizaciónCatálogo completo de herramientas de organización con puertas de confirmación

El endpoint OAuth no puede enviar, publicar, programar, eliminar, archivar ni cancelar suscripciones. Siga la guía de ChatGPT y Codex para esa configuración.

El endpoint de token de API está destinado a clientes de confianza que necesitan un catálogo más amplio. Cada solicitud permanece limitada a la organización propietaria del token.

Conéctese con un token de API

Cree un token desde Configuración → Tokens de API y luego agregue el endpoint HTTP Streamable a su cliente:

{
  "mcpServers": {
    "lumail": {
      "url": "https://lumail.io/api/mcp/sse",
      "headers": {
        "Authorization": "Bearer lum_your_api_token_here"
      }
    }
  }
}

Para un cliente solo stdio, use un puente HTTP:

{
  "mcpServers": {
    "lumail": {
      "command": "pnpm",
      "args": [
        "dlx",
        "mcp-remote",
        "https://lumail.io/api/mcp/sse",
        "--header",
        "Authorization: Bearer lum_your_api_token_here"
      ]
    }
  }
}

Reinicie el cliente MCP después de cambiar su configuración.

Descubra recursos

Después de la autenticación, el servidor anuncia la capacidad MCP resources. Use resources/list y resources/read para recuperar:

  • Inicio para desarrolladores y agentes de Lumail (https://lumail.io/, text/markdown) - capacidades concisas del producto y enlaces canónicos de MCP, REST, SDK, CLI, soporte y documentación
  • Especificación OpenAPI 3.1 de Lumail (https://lumail.io/openapi.json, application/json) - operaciones REST tipadas, autenticación de portador, esquemas de solicitud, esquemas de respuesta y errores estructurados

Cada URI devuelto también se resuelve a través de HTTPS ordinario. El contenido de los recursos es documentación pública para desarrolladores; los datos de la organización permanecen disponibles solo a través de herramientas autenticadas.

Descubra herramientas dinámicamente

Los clientes MCP reciben los nombres de herramientas actuales, descripciones, esquemas de entrada y anotaciones de seguridad durante el descubrimiento. El mismo catálogo está disponible a través de REST:

curl https://lumail.io/api/v2/tools \
  -H "Authorization: Bearer lum_your_api_token_here"

El v2 en /api/v2/tools es la versión de la API de Tools. Los nombres de las herramientas de Workflow son canónicos y sin versionar.

Herramientas canónicas de Workflow

Lumail tiene un motor de Workflow basado en grafos compatible. Sus herramientas MCP operan sobre borradores editables, versiones publicadas inmutables, ejecuciones de suscriptores, objetivos, salidas y grupos de exclusión mutua.

ÁreaHerramientas
Leer y crearlist_workflows, get_workflow, create_workflow
Grafo de borradorconfigure_workflow_draft, update_workflow_draft
Ciclo de vidapublish_workflow, update_workflow_status, delete_workflow
Inscripciónadd_subscriber_to_workflow, add_subscribers_to_workflow, remove_subscriber_from_workflow
Ejecucionesget_subscriber_workflow_runs, fast_forward_workflow_subscriber
Gruposlist_workflow_groups, get_workflow_group, create_workflow_group, update_workflow_group, set_workflow_group, delete_workflow_group

No hay herramientas de Workflow con sufijo de versión ni herramientas de mutación paso a paso. Un borrador de Workflow se configura como un grafo { steps, edges } completo.

Flujo seguro de borrador

  1. Llame a get_skill con { "type": "workflow" }.
  2. Use list_workflows o create_workflow para identificar el objetivo.
  3. Llame a get_workflow inmediatamente antes de editar y conserve su updatedAt exacto.
  4. Resuelva etiquetas, remitentes, fragmentos, campañas, campos, objetivos y grupos referenciados con herramientas de lectura.
  5. Llame a configure_workflow_draft una vez con los pasos y bordes completos más expectedUpdatedAt.
  6. Lea el Workflow nuevamente, inspeccione cada correo interno configurado con get_campaign y verifique cada renderizado con render_campaign.

configure_workflow_draft crea o actualiza la campaña interna WORKFLOW propiedad de cada paso EMAIL. No llame a create_campaign para correos de Workflow y no adjunte campañas de difusión directamente.

La configuración del borrador nunca publica ni envía. La publicación y activación son acciones separadas con puertas de confirmación.

Categorías de herramientas

El catálogo completo también incluye herramientas para:

  • Suscriptores, filtros compuestos, etiquetas y campos personalizados
  • Redacción de campañas, renderizado, historial, programación y análisis
  • Segmentos y análisis de organización
  • Remitentes de correo, dominios, entregabilidad y gestión de supresión
  • Fragmentos, variables, imágenes, importaciones y exportaciones
  • Recuperación de correo transaccional y contenido web

Use get_skill antes de operaciones especializadas como la configuración de grafos de Workflow o la redacción de correos. Pase { "type": "docs" } para listar todas las páginas de documentación del producto y luego { "type": "docs", "page": "<slug>" } para leer una. Use el esquema devuelto por el descubrimiento en lugar de adivinar nombres de parámetros.

Puertas de confirmación

Las herramientas de alto impacto usan un flujo de confirmación de dos llamadas. La primera llamada devuelve CONFIRMATION_REQUIRED con un confirmationCode de cinco dígitos. Muestre la acción propuesta al usuario y luego repita la misma llamada de herramienta exacta con ese código dentro de cinco minutos.

Las acciones con puerta de confirmación incluyen enviar o programar correos, publicar o activar un Workflow, eliminación destructiva, archivado y operaciones de cancelación de suscripción. Las anotaciones de la herramienta y la primera respuesta son autoritativas para el catálogo actual.

Los códigos son de un solo uso, expiran después de cinco minutos y están vinculados a la organización, la herramienta y la entrada exacta.

Reglas operativas

  • Lea el recurso actual inmediatamente antes de cambiarlo.
  • Cree campañas y Workflows como borradores primero.
  • Nunca envíe, publique, active, programe, archive, cancele suscripciones ni elimine sin intención explícita del usuario.
  • Preserve los valores de updatedAt para operaciones de concurrencia optimista.
  • Use edit_campaign para cambios de campaña y configure_workflow_draft para grafos de Workflow completos.
  • Lea cada mutación antes de informar éxito.
  • Mantenga los tokens de API en secreto y fuera del código del lado del navegador, registros y mensajes.
  • Respete los límites de velocidad de la organización y reintente las respuestas 429 con retroceso.

Ejemplos de mensajes

Create a welcome Workflow draft with three emails over seven days.
Keep it unpublished, then show me the rendered text and links for every email.

List my paused Workflows and explain which published version each one uses.
Do not activate anything.

Add the subscriber alex@example.com to the active onboarding Workflow.
Show me the exact action before requesting confirmation.

Solución de problemas

Las herramientas no aparecen: reinicie el cliente MCP, verifique el endpoint y confirme que el token pertenece a la organización prevista.

No autorizado: cree un nuevo token de API de organización o reconecte la integración OAuth.

El Workflow cambió desde que se leyó: llame a get_workflow nuevamente, combine intencionalmente y reintente con el nuevo updatedAt.

Confirmación requerida: repita la misma llamada con el código devuelto. Cambiar otra entrada crea un desafío de confirmación diferente.

Relacionado