Email MCP server
MAAC Go Email 有一個遠端 MCP server,位址是 https://edm.cresclab.com/api/mcp。接上 Claude Code、Cursor、VS Code、Windsurf、Claude Desktop 或 Codex,你的 agent 就能寄交易型 email、管理模板與聯絡人、寄出你已經寫好的電子報活動,並讀取成效報表與餘額——共 22 個工具,用你的 API 金鑰驗證。每個帳號註冊時就會拿到一把測試金鑰;台灣帳號每月 100 封免費、免信用卡,之後預付儲值,每封 NT$0.30 起。
每段設定裡的 sk_test_... 都是佔位字,請換成你自己的金鑰。Claude Code、Cursor、VS Code 和 Windsurf 直接連到端點;Claude Desktop 和 Codex 只能啟動本機 server,所以要透過開源的 mcp-remote 橋接,需要 Node.js 18 以上。
執行一次:
claude mcp add --transport http maacgo-email https://edm.cresclab.com/api/mcp --header "Authorization: Bearer sk_test_..."
貼到 ~/.cursor/mcp.json(所有專案都能用),或 .cursor/mcp.json(只給單一專案)。
{
"mcpServers": {
"maacgo-email": {
"url": "https://edm.cresclab.com/api/mcp",
"headers": { "Authorization": "Bearer sk_test_..." }
}
}
}存成工作區裡的 .vscode/mcp.json。第一次啟動 server 時,VS Code 會請你輸入金鑰並幫你保存,金鑰不會寫在檔案裡。注意最外層的 key 是 servers,不是 mcpServers。
{
"servers": {
"maacgo-email": {
"type": "http",
"url": "https://edm.cresclab.com/api/mcp",
"headers": { "Authorization": "Bearer ${input:maacgo-email-key}" }
}
},
"inputs": [
{
"type": "promptString",
"id": "maacgo-email-key",
"description": "MAAC Go Email API key",
"password": true
}
]
}貼到 ~/.codeium/windsurf/mcp_config.json。Windsurf 的網址欄位叫 serverUrl。
{
"mcpServers": {
"maacgo-email": {
"serverUrl": "https://edm.cresclab.com/api/mcp",
"headers": { "Authorization": "Bearer sk_test_..." }
}
}
}在 Settings → Developer → Edit Config 打開設定檔(macOS:~/Library/Application Support/Claude/,Windows:%APPDATA%\Claude\),存檔後重新啟動 Claude Desktop。需要 Node.js 18 以上。金鑰放在 env 裡,這樣「Bearer …」中間的空格就不必經過命令列。
{
"mcpServers": {
"maacgo-email": {
"command": "npx",
"args": [
"-y", "mcp-remote", "https://edm.cresclab.com/api/mcp",
"--header", "Authorization:${MAACGO_AUTH}"
],
"env": { "MAACGO_AUTH": "Bearer sk_test_..." }
}
}
}加到 ~/.codex/config.toml,再開一個新的 Codex session。需要 Node.js 18 以上。
[mcp_servers.maacgo-email]
command = "npx"
args = ["-y", "mcp-remote", "https://edm.cresclab.com/api/mcp", "--header", "Authorization:${MAACGO_AUTH}"]
env = { MAACGO_AUTH = "Bearer sk_test_..." }重新啟動工具或重新載入 MCP server,然後問:「呼叫 maacgo-email 的 get_me。」回覆會列出你的帳號,以及 key_mode——test 或 live。也可以用瀏覽器打開端點,不用金鑰就能看到摘要。
把下面這段貼進 CLAUDE.md、AGENTS.md、Cursor rules 或工具的自訂指令。之後你說「把收據寄給 Ada」,agent 就會用這個 server,而不是自己寫一支程式。
當我請你寄 email、電子報或交易型訊息(收據、一次性驗證碼、訂單通知)時,使用maacgo-emailMCP server。先呼叫get_me:測試金鑰只會記錄寄送,不會真的寄出。寄電子報活動時,先執行estimate_campaign再執行send_campaign,並告訴我收件人數。如果因為餘額不足被拒絕寄送,把錯誤訊息裡的儲值連結給我。
每個工具都用你的金鑰呼叫公開的 REST API,所以權限範圍、額度、餘額和排除名單都跟直接用 curl 一樣,沒有特權通道。
唯讀 不會改任何東西寫入 會改帳號裡的資料寄信 用正式金鑰時會真的寄出刪除 會刪掉東西
| 寄信 | ||
|---|---|---|
send_email | 寄一封交易型 email——收據、一次性驗證碼、訂單通知——內容可以直接給 HTML,或用已存的模板加上 variables。 | 寄信 |
| 模板 | ||
list_templates | 已存的模板,以及每個模板需要的 {{variables}}。 | 唯讀 |
get_template | 單一模板:主旨、HTML、純文字與變數。 | 唯讀 |
create_template | 存一個可重複使用的模板;主旨、HTML、純文字裡都能用 {{name|fallback}}。 | 寫入 |
update_template | 修改已存的模板;只會改你有傳的欄位。 | 寫入 |
delete_template | 刪除已存的模板,已經寄出的信不受影響。 | 刪除 |
| 訊息 | ||
get_message | 一封交易型 email 是否已送達、退信,或還在寄送中。 | 唯讀 |
list_messages | 最近 100 封交易型 email 與它們的狀態。 | 唯讀 |
| 電子報活動 | ||
list_campaigns | 所有電子報活動與狀態,寄出後還有送達漏斗。 | 唯讀 |
get_campaign | 單一活動的完整內容:主旨、內容、受眾、狀態與排程。 | 唯讀 |
campaign_report | 單一活動的完整漏斗,加上每位收件人的明細。 | 唯讀 |
estimate_campaign | 扣掉退訂、退信與排除條件後,一個受眾實際會寄到多少人。 | 唯讀 |
send_campaign | 寄出或排程一份別人已經寫好的草稿;餘額不夠時會拒絕,並附上費用明細。 | 寄信 |
| 聯絡人 | ||
list_contacts | 聯絡人、他們的標籤,以及每位是否能寄。 | 唯讀 |
add_contact | 新增一位同意收信的聯絡人。 | 寫入 |
import_contacts | 一次最多新增 5,000 位聯絡人;已在名單上或無效的地址會略過。 | 寫入 |
tag_contacts | 一次替多位聯絡人加上或移除標籤,不會刪除聯絡人。 | 寫入 |
contact_activity | 單一聯絡人的電子報活動紀錄(寄送、開信、點擊、退信),新的在前。 | 唯讀 |
| 帳號與餘額 | ||
get_me | 這把金鑰所屬的帳號:方案、上限、用量與 key_mode(test 或 live)。 | 唯讀 |
wallet_balance | 預付餘額、本月用量與剩下的免費額度。 | 唯讀 |
wallet_events | 餘額異動紀錄:儲值、寄送扣款與退款,新的在前。 | 唯讀 |
quote_cost | 寄出指定數量的信現在要花多少:幾封在免費額度內、幾封要計費,以及目前餘額。 | 唯讀 |
標頭。把金鑰放在 Authorization: Bearer sk_test_...(或 sk_live_...)。無法自訂這個標頭的工具,可以改送 x-maacgo-api-key: <key>。initialize 和 tools/list 不需要金鑰,所以工具在你加入金鑰前就能列出工具清單;每次 tools/call 都需要金鑰。
測試金鑰與正式金鑰。看前綴就知道。sk_test_ 金鑰只會記錄:send_email 會回 status: "sent" 加上 test_mode: true,但信不會寄到任何收件匣,也不會扣款。每個新帳號一開始都有一把測試金鑰。想真的寄出時,到開發者頁面建立 sk_live_ 金鑰換上去。帳號要先驗證寄件網域(SPF、DKIM 與退信用 MX,三筆 DNS 紀錄,免費方案也能做)或儲值,才能建立正式金鑰。
金鑰做不到的事。金鑰沒有 campaigns.write 權限:agent 可以寄出別人寫好的活動,但不能自己建立活動。金鑰永遠不能付款,也不能發新的金鑰。帳號裡任何地方的退訂、硬退信或垃圾信投訴,都會擋下 send_email——電子報活動和 API 共用同一份排除名單。
@maacgo/email-mcp 已經做好,但還沒發佈到 npm。HTTP 端點能做到它能做的一切;只支援 stdio 的工具,照上面的方式用 mcp-remote。no-reply@edm.cresclab.com,顯示名稱是你的;電子報活動可以用你驗證過的網域寄。https://edm.cresclab.com/api/mcp 的遠端 MCP server,提供 AI agent 22 個操作你 MAAC Go Email 帳號的工具:寄交易型 email、管理模板與聯絡人、寄出你已經寫好的電子報活動,以及讀取成效報表與餘額。它使用 Streamable HTTP,並以你的 API 金鑰驗證。sk_test_ 開頭的金鑰會記錄每一次呼叫,send_email 也會回 status sent、test_mode 為 true,但信不會寄出,也不會扣款。呼叫 get_me 可以看金鑰是哪一種模式。要真的寄出,到開發者頁面建立 sk_live_ 金鑰;帳號要先驗證寄件網域(SPF、DKIM 與退信用 MX,免費方案也能做)或儲值,才能建立。estimate_campaign 看會寄到多少人。delete_template 是唯一會刪除東西的工具。帳號裡任何地方的退訂、硬退信或垃圾信投訴也會擋下 send_email,因為電子報活動和 API 共用同一份排除名單。send_campaign 會回覆一份費用明細,錯誤訊息裡附有儲值連結讓你自己打開,因為 agent 不能付款。大量寄送前,可以先請 agent 用 quote_cost 或 estimate_campaign 估算。@maacgo/email-mcp 已經做好,但還沒發佈到 npm。HTTP 端點能做到它能做的一切;只能啟動本機 server 的工具,照上面的方式透過 mcp-remote 連到端點即可。