Direct MailMCP服務說明

說明

調用Direct MailMCP的效果和AI智能體基礎能力有關，建議對AI智能體做好提示詞和知識庫的最佳化。

一、Direct MailMCP服務是什麼

MCP，全稱模型上下文協議（Model Context Protocol），目標是為大語言模型和AI助手提供一個統一、標準化的介面。它的作用就像USB介面一樣，使AI能夠輕鬆串連和操作外部工具並完成更複雜的任務。

Direct Mail現已支援MCP協議，使用者可以通過此協議授權AI操作部分功能，並可通過與AI聊天使用Direct Mail，擷取需要的資訊。

二、Direct MailMCP服務包含哪些能力

Direct Mail（Direct Mail）的 MCP STDIO 伺服器，提供查詢工具以及受保護的直接郵件、模板建立、模板測試郵件、模板批量任務、標籤建立、收件者清單建立和收件者記錄追加流程，底層基於阿里雲SDK。

說明

Direct MailMCP只支援 STDIO，不支援HTTP，請用STDIO或JSON設定檔配置。

三、Direct MailMCP如何配置

運行要求

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`	排查任務進度、投遞明細、統計資料或追蹤資料。