邮件推送MCP服务说明

说明

调用邮件推送MCP的效果和AI智能体基础能力有关，建议对AI智能体做好提示词和知识库的优化。

一、邮件推送MCP服务是什么

MCP，全称模型上下文协议（Model Context Protocol），目标是为大语言模型和AI助手提供一个统一、标准化的接口。它的作用就像USB接口一样，使AI能够轻松连接和操作外部工具并完成更复杂的任务。

邮件推送现已支持MCP协议，用户可以通过此协议授权AI操作部分功能，并可通过与AI聊天使用邮件推送，获取需要的信息。

二、邮件推送MCP服务包含哪些能力

Direct Mail（邮件推送）的 MCP STDIO 服务器，提供查询工具以及受保护的直接邮件、模板创建、模板测试邮件、模板批量任务、标签创建、收件人列表创建和收件人记录追加流程，底层基于阿里云SDK。

说明

邮件推送MCP只支持 STDIO，不支持HTTP，请用STDIO或JSON配置文件配置。

三、邮件推送MCP如何配置

运行要求

Node.js >=20
已开通 Direct Mail 的阿里云账号
具备所需 Direct Mail 权限的 RAM AccessKey ID 和 AccessKey Secret
发送流程所需的 Direct Mail 资源，例如已审核通过的发信地址、模板、标签和收件人列表

该服务是 MCP STDIO 进程，通常由 MCP Host 启动，不作为交互式 Shell 命令使用。

MCP Host 配置

配置 MCP Host 通过 npx 启动该包，并通过环境变量传入阿里云凭证：

{
  "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": "cn-hangzhou"
      }
    }
  }
}

请先从阿里云RAM 用户创建 AccessKey ID 和 AccessKey Secret，再配置这些环境变量。参考创建AccessKey。AccessKey Secret 仅在创建时展示，请安全保存。

ALIYUN_DM_REGION_ID 默认值为 cn-hangzhou。Direct Mail Region ID 和服务 Endpoint 请参考服务接入点。

Tools

只列出便于快速浏览的用户侧业务工具，精确入参与确认控制字段请查看 MCP Host 返回的工具 schema。

工具	用途	风险级别
`dm_get_account_summary`	查看 Direct Mail 账号额度、状态和资源数量。	只读
`dm_list_mail_addresses`	列出或筛选发信地址。	只读
`dm_list_config_sets`	列出发信配置集。	只读
`dm_get_config_set`	查询单个发信配置集详情。	只读
`dm_list_templates`	在批量任务或测试发送前列出 Direct Mail 模板。	只读
`dm_get_template`	查询模板主题、状态和内容，供发送前审核。	只读
`dm_create_template`	预览并在确认后创建邮件模板，创建后等待审核。	受保护写操作
`dm_list_receivers`	列出收件人列表元数据。	只读
`dm_list_receiver_details`	查询单个收件人列表明细。	只读
`dm_create_receiver_list`	预览并在确认后创建空收件人列表。	受保护写操作
`dm_add_receiver_records`	向联系人列表追加收件人记录。	受保护写操作
`dm_list_tasks`	列出 Direct Mail 批量任务，用于进度检查。	只读
`dm_list_tags`	列出用于分类和追踪的标签。	只读
`dm_create_tag`	预览并在确认后创建标签。	受保护写操作
`dm_list_send_details`	查询逐收件人或逐邮件的投递明细。	只读
`dm_get_send_statistics_summary`	查询聚合发送统计数据。	只读
`dm_list_block_sending`	查询阻断发送记录，例如退订地址。	只读
`dm_get_track_list`	查询打开和点击追踪数据。	只读
`dm_list_dedicated_ips`	列出已购买的专属 IP。	只读
`dm_list_dedicated_ip_pools`	列出专属 IP 池。	只读
`dm_get_ip_protection`	查询 Direct Mail IP 防护开关状态。	只读
`dm_send_direct_email`	发送触达类（如验证码）邮件（收件人不多于 100）。	受保护发送
`dm_start_batch_send_task`	创建批量发送任务，适用于营销邮件场景（无收件人数限制）	受保护发送
`dm_send_template_test_email`	预览并确认发送模板测试邮件，不用于正式发信。	受保护发送

受保护的写操作和发送工具在省略 execute 时不会调用 Direct Mail 写接口。它们会返回预览和确认动作；MCP Host 应先向用户展示预览，获得明确批准后再按预览返回的确认动作继续。

可选 Agent Skill

MCP 服务可独立运行。安装可选 Agent Skill 后，助手可以按 Direct Mail 业务流程更稳定地选择工具、核对预览并处理确认链路。该 skill 只提供助手侧 workflow guidance，不改变 MCP 服务的运行时行为。

下载地址：alibabacloud-direct-mail-agent-skill.zip。

Prompts

支持 MCP listPrompts / getPrompt 的 Host 可以选择按场景使用 workflow guidance。Prompt 细节与外部托管的 skill 保持一致；精确字段仍以工具 schema 和返回的 structuredContent 为准。

Prompt	使用场景
`dm_direct_email_send_assistant`	准备向明确收件人发送直接邮件或事务通知邮件。
`dm_template_batch_send_assistant`	准备模板 + 收件人列表的批量任务和可选测试发送。
`dm_delivery_investigation_assistant`	排查任务进度、投递明细、统计数据或追踪数据。