Direct Mail MCP service description - Direct Mail - Centro de documentación de Alibaba Cloud

Nota

El rendimiento del servicio MCP de Direct Mail depende de las capacidades de su agente de IA. Optimice el prompt y la base de conocimientos del agente para obtener los mejores resultados.

Descripción general

Model Context Protocol (MCP) es una interfaz estandarizada para modelos de lenguaje grandes y asistentes de IA. Al igual que un puerto USB, permite que la IA se conecte a herramientas externas y las opere para realizar tareas complejas.

Direct Mail admite MCP. Utilice este protocolo para autorizar a un agente de IA a ejecutar operaciones e interactuar con Direct Mail mediante chat.

Capacidades

El servidor STDIO de MCP de Direct Mail proporciona herramientas de consulta y flujos de trabajo protegidos para enviar correos electrónicos, gestionar plantillas, ejecutar tareas por lotes, administrar etiquetas y gestionar listas de destinatarios. Este servicio utiliza el SDK de Alibaba Cloud.

Nota

El servicio MCP de Direct Mail solo admite STDIO, no HTTP. Configúrelo mediante STDIO o un archivo de configuración JSON.

Configuración

Requisitos previos

Node.js >=20
Una cuenta de Alibaba Cloud con Direct Mail activado.
Un AccessKey ID y un AccessKey Secret de RAM con los permisos necesarios para Direct Mail.
Recursos de Direct Mail necesarios para el envío, como direcciones de correo aprobadas, plantillas, etiquetas y listas de destinatarios.

Este servicio es un proceso STDIO de MCP iniciado por un MCP Host. No está diseñado para uso interactivo en shell.

Configuración del MCP Host

Configure el MCP Host para iniciar el paquete con npx y pase sus credenciales de Alibaba Cloud como variables de entorno:

{
  "mcpServers": {
    "aliyun-direct-mail": {
      "command": "npx",
      "args": ["-y", "alibabacloud-direct-mail-mcp"],
      "env": {
        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your-access-key-id",
        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your-access-key-secret",
        "ALIYUN_DM_REGION_ID": "ap-southeast-1"
      }
    }
  }
}

Cree un AccessKey ID y un AccessKey Secret para un usuario de RAM. Para más información, consulte Create an AccessKey. El AccessKey Secret solo se muestra durante la creación. Guárdelo de forma segura.

El valor predeterminado de ALIYUN_DM_REGION_ID es ap-southeast-1. Los ID de región y endpoints disponibles se enumeran en Service Endpoints.

Herramientas

A continuación se listan las herramientas disponibles. Para consultar los parámetros exactos y los campos de confirmación, revise el esquema de la herramienta desde el MCP Host.

Herramienta	Descripción	Nivel de riesgo
`dm_get_account_summary`	Consulte la cuota, el estado y los recuentos de recursos de su cuenta de Direct Mail.	read-only
`dm_list_mail_addresses`	Liste o filtre direcciones de correo electrónico.	read-only
`dm_list_config_sets`	Liste conjuntos de configuración.	read-only
`dm_get_config_set`	Obtenga detalles de un conjunto de configuración específico.	read-only
`dm_list_templates`	Liste plantillas de Direct Mail antes de una tarea por lotes o un envío de prueba.	read-only
`dm_get_template`	Obtenga el asunto, el estado y el contenido de una plantilla para revisión previa al envío.	read-only
`dm_create_template`	Previsualice y cree una plantilla de correo electrónico. Las plantillas creadas requieren revisión.	protected write
`dm_list_receivers`	Liste metadatos de listas de destinatarios.	read-only
`dm_list_receiver_details`	Obtenga detalles de una lista de destinatarios específica.	read-only
`dm_create_receiver_list`	Previsualice y cree una lista de destinatarios vacía.	protected write
`dm_add_receiver_records`	Agregue registros de destinatarios a una lista existente.	protected write
`dm_list_tasks`	Liste tareas por lotes para verificar su progreso.	read-only
`dm_list_tags`	Liste etiquetas utilizadas para clasificación y seguimiento.	read-only
`dm_create_tag`	Previsualice y cree una etiqueta.	protected write
`dm_list_send_details`	Obtenga detalles de entrega por destinatario o correo electrónico.	read-only
`dm_get_send_statistics_summary`	Obtenga estadísticas agregadas de envíos.	read-only
`dm_list_block_sending`	Obtenga registros de envíos bloqueados, como direcciones dadas de baja.	read-only
`dm_get_track_list`	Obtenga datos de seguimiento de aperturas y clics.	read-only
`dm_list_dedicated_ips`	Liste direcciones IP dedicadas adquiridas.	read-only
`dm_list_dedicated_ip_pools`	Liste grupos de IP dedicadas.	read-only
`dm_get_ip_protection`	Obtenga el estado del interruptor de protección de IP de Direct Mail.	read-only
`dm_send_direct_email`	Envíe correos transaccionales, como códigos de verificación (hasta 100 destinatarios).	protected sending
`dm_start_batch_send_task`	Inicie una tarea de envío por lotes para correos de marketing (sin límite de destinatarios).	protected sending
`dm_send_template_test_email`	Previsualice y envíe un correo de prueba con una plantilla. No apto para producción.	protected sending

Las herramientas protegidas de escritura y envío devuelven una previsualización y una acción de confirmación cuando se omite el parámetro execute. El MCP Host debe mostrar la previsualización y continuar solo después de la aprobación explícita del usuario.

Habilidad opcional del agente

El servicio MCP se ejecuta de forma independiente. La habilidad opcional del agente ayuda al asistente de IA a seleccionar herramientas, verificar previsualizaciones y gestionar flujos de confirmación según los procesos de negocio de Direct Mail. Proporciona orientación sobre el flujo de trabajo sin alterar el comportamiento en tiempo de ejecución del servicio MCP.

Descargue alibabacloud-direct-mail-agent-skill.zip.

Prompts

Los hosts que admiten MCP listPrompts / getPrompt pueden usar orientación de flujo de trabajo basada en escenarios. Los detalles de los prompts coinciden con la habilidad alojada externamente. Para definiciones precisas de campos, consulte el esquema de la herramienta y el structuredContent devuelto por el servicio.

Prompt	Caso de uso
`dm_direct_email_send_assistant`	Envío de un correo directo o notificación transaccional a destinatarios específicos.
`dm_template_batch_send_assistant`	Ejecución de una tarea por lotes con una plantilla y lista de destinatarios, con opción de envío de prueba.
`dm_delivery_investigation_assistant`	Investigación del progreso de tareas, detalles de entrega, estadísticas o datos de seguimiento.