MAAC Go EMAIL

Email MCP server

讓你的 AI agent 幫你寄信。

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 Code 終端機

執行一次:

claude mcp add --transport http maacgo-email https://edm.cresclab.com/api/mcp --header "Authorization: Bearer sk_test_..."

Cursor ~/.cursor/mcp.json

貼到 ~/.cursor/mcp.json(所有專案都能用),或 .cursor/mcp.json(只給單一專案)。

{
  "mcpServers": {
    "maacgo-email": {
      "url": "https://edm.cresclab.com/api/mcp",
      "headers": { "Authorization": "Bearer sk_test_..." }
    }
  }
}

VS Code .vscode/mcp.json

存成工作區裡的 .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
    }
  ]
}

Windsurf ~/.codeium/windsurf/mcp_config.json

貼到 ~/.codeium/windsurf/mcp_config.json。Windsurf 的網址欄位叫 serverUrl。

{
  "mcpServers": {
    "maacgo-email": {
      "serverUrl": "https://edm.cresclab.com/api/mcp",
      "headers": { "Authorization": "Bearer sk_test_..." }
    }
  }
}

Claude Desktop claude_desktop_config.json

在 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 ~/.codex/config.toml

加到 ~/.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。也可以用瀏覽器打開端點,不用金鑰就能看到摘要。

告訴 agent 什麼時候該用它

把下面這段貼進 CLAUDE.md、AGENTS.md、Cursor rules 或工具的自訂指令。之後你說「把收據寄給 Ada」,agent 就會用這個 server,而不是自己寫一支程式。

當我請你寄 email、電子報或交易型訊息(收據、一次性驗證碼、訂單通知)時,使用 maacgo-email MCP server。先呼叫 get_me:測試金鑰只會記錄寄送,不會真的寄出。寄電子報活動時,先執行 estimate_campaign 再執行 send_campaign,並告訴我收件人數。如果因為餘額不足被拒絕寄送,把錯誤訊息裡的儲值連結給我。

22 個工具

每個工具都用你的金鑰呼叫公開的 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 共用同一份排除名單。

還沒有的

常見問題

MAAC Go Email 的 MCP server 是什麼?
一個位於 https://edm.cresclab.com/api/mcp 的遠端 MCP server,提供 AI agent 22 個操作你 MAAC Go Email 帳號的工具:寄交易型 email、管理模板與聯絡人、寄出你已經寫好的電子報活動,以及讀取成效報表與餘額。它使用 Streamable HTTP,並以你的 API 金鑰驗證。
現在哪些 AI 工具能用?
Claude Code、Cursor、VS Code 和 Windsurf 直接連到端點,不用安裝任何東西。Claude Desktop 和 Codex 只能啟動本機 server,所以要透過開源的 mcp-remote 橋接,需要 Node.js 18 以上。其他能透過 HTTP 連到遠端 MCP server、又能自訂標頭的工具,用法也一樣。
要錢嗎?
開始用不用錢。每個帳號註冊時都會拿到一把測試金鑰;台灣帳號每月 100 封免費、免信用卡,之後預付儲值,每封 NT$0.30 起。MCP server 本身不另外收費:透過它寄的信,跟用 API 寄同一封信的計費方式一樣。
測試金鑰會真的寄出信嗎?
不會。以 sk_test_ 開頭的金鑰會記錄每一次呼叫,send_email 也會回 status sent、test_mode 為 true,但信不會寄出,也不會扣款。呼叫 get_me 可以看金鑰是哪一種模式。要真的寄出,到開發者頁面建立 sk_live_ 金鑰;帳號要先驗證寄件網域(SPF、DKIM 與退信用 MX,免費方案也能做)或儲值,才能建立。
agent 有哪些事做不到?
不能建立電子報活動、不能發或撤銷 API 金鑰、不能儲值或更改帳務。它可以寄出或排程別人已經寫好的活動,寄之前先用 estimate_campaign 看會寄到多少人。delete_template 是唯一會刪除東西的工具。帳號裡任何地方的退訂、硬退信或垃圾信投訴也會擋下 send_email,因為電子報活動和 API 共用同一份排除名單。
餘額用完會怎樣?
寄送會被拒絕,不會排入佇列,也不會扣款。send_campaign 會回覆一份費用明細,錯誤訊息裡附有儲值連結讓你自己打開,因為 agent 不能付款。大量寄送前,可以先請 agent 用 quote_cost 或 estimate_campaign 估算。
可以接到 ChatGPT 或 claude.ai 嗎?
還不行。它們的連接器用 OAuth 登入遠端 server,而這個 server 只接受 API 金鑰。目前請用 Claude Code、Cursor、VS Code、Windsurf、Claude Desktop 或 Codex。
有 npm 套件嗎?
還沒有。stdio 套件 @maacgo/email-mcp 已經做好,但還沒發佈到 npm。HTTP 端點能做到它能做的一切;只能啟動本機 server 的工具,照上面的方式透過 mcp-remote 連到端點即可。
免費拿測試金鑰 → 只想用 HTTP?看 REST API →
首頁 電子報工具 交易型 email API OpenAPI llms.txt 隱私權政策 服務條款 English Crescendo Lab 漸強實驗室 · cresclab.com