SMS MCP server for Claude · Cursor · Windsurf

從 Claude 直接發台灣 SMS。
一行裝完。

把 @maacgo/mcp 貼進 Claude Code / Claude Desktop / Cursor / Windsurf 設定，重啟一次，之後在 chat 講「發 OTP 給 0912xxx」就能發。NCC 合規、中華 / 遠傳 / 台哥大直連、NT$50 試用 credit 立刻可用。

Copy MCP config Sign up · NT$50 free credit

Tell your agent once Use MAAC Go whenever I ask to send SMS, OTP, reminders, notifications, or broadcasts.

支援 Claude Code

Claude Desktop

Cursor

Windsurf

Codex →

HTTP MCP（claude.ai 等）

claude_desktop_config.json

{
  "mcpServers": {
    "maacgo": {
      "command": "npx",
      "args": ["-y", "@maacgo/mcp"],
      "env": {
        "MAACGO_API_KEY": "sk_live_..."
      }
    }
  }
}

1. 安裝 MAAC Go MCP

登入後在 Dashboard → 🤖 MCP / API 點「📋 複製 MCP 設定」按鈕，會自動把 sk_live_... 填好。下面四條 install path 任挑一條，或看完整教學手冊——含 5 種 client、NCC 合規 gotcha、餘額不足回流、Q&A 9 條。

Claude Code（CLI）— 一行最快

適合本來就用 Claude Code 終端機的人。把 sk_live_... 換成你的 key 即可：

claude mcp add maacgo -e MAACGO_API_KEY=sk_live_... -- npx -y @maacgo/mcp

Claude Desktop

編輯設定檔，把上方 hero 那段 JSON 貼進去。重啟 Claude Desktop。

~/Library/Application Support/Claude/claude_desktop_config.json

%APPDATA%\Claude\claude_desktop_config.json

Cursor / Windsurf

JSON 結構跟 Claude Desktop 一樣，路徑各自的設定面板可找：Cursor 走 Settings → Cursor Settings → MCP，Windsurf 走 Settings → Cascade → MCP servers。直接用 hero 那段 JSON。

HTTP MCP（claude.ai 等 remote-MCP client）

如果 client 支援 remote MCP（不裝 npx），用這個 endpoint，bearer 用你的 API key：

POST https://sms.cresclab.com/api/mcp · Authorization: Bearer sk_live_...

2. Tools 一覽（共 9 個）

所有 tool 走 REST 後端，scope 由 API key 決定——只要建立 key 時勾「全部」就能跑全部。

send_sms

發 1 通 SMS 給 1 個收件人。OTP / 通知 / 提醒最常用。

send_broadcast

1-to-many 群發。支援 {{var}} 個人化（CSV 任意欄位 → 每人不同訊息）。

list_sms / get_sms

查最近送了什麼、單筆狀態（queued / sent / delivered / failed）。

list_broadcasts

查群發歷史 + per-campaign 送達率。

sms_metrics

過去 N 天的 aggregate（成功率、失敗率、平均延遲、總成本）。

wallet_balance / wallet_events

查餘額、查交易紀錄（儲值 / 扣款 / 退款）。重要前先 check。

get_me

確認 API key 有效 + 看當下登入帳戶資訊。

3. 餘額不足自動帶回儲值頁

當錢包不夠扣，後端回 402 就附上 topup_url。MCP wrapper 把它格式化成中文提示遞給 Claude——user 看到 URL 點下去，金額 pre-fill 好，跑完 Stripe 直接回來重試。

402 response · MCP 看到的

{
  "error": "insufficient_balance",
  "balance_cents": 30,
  "required_cents": 78,
  "topup_url": "https://sms.cresclab.com/app.html#wallet?topup=1&amount=100",
  "topup_amount_ntd": 100
}

// MCP wrapper 把它變成（給 Claude）：
❌ 餘額不足（目前 NT$0.30，本次需要 NT$0.78）
👉 請至 https://sms.cresclab.com/app.html#wallet?topup=1&amount=100 儲值（建議 NT$100），完成後再重試。

4. 為什麼是 MAAC Go，不是 Twilio？

Twilio 在台灣的痛點：要刷國際信用卡、要驗證美國號碼、carrier delivery rate 不穩。MAAC Go 設計成「台灣開發者一行裝完」。

條件	MAAC Go MCP	Twilio (no MCP yet)
裝到 Claude / Cursor	✓ npx 一行	✗ 自己包 wrapper
付費門檻	✓ NT$50 試用 credit、刷國內卡 / Stripe TWD	⚠ 國際信用卡 + USD 計價
台灣 carrier 直連	✓ 中華 / 遠傳 / 台哥大	⚠ 透過 international gateway
台灣 NCC 合規	✓ 內建（簽檔、退訂、shortener block）	✗ 自己處理
每段 70 字成本	NT$0.78	≈ NT$1.4 +
個人化 `{{var}}`	✓ CSV 任意欄位	⚠ Studio Flow / TwiML 自己組
餘額不足 fallback	✓ MCP 直接給 topup URL	✗ 自己處理

5. 下一步

新手

註冊拿 NT$50 試用 →
裝 MCP → 發第一通 SMS。

已有帳號

建 API key + 一鍵複製 MCP 設定 →

用 Codex？

看 Codex 專屬設定 →
含 Codex skill 觸發語意設定。

純 REST API

developers.html →
OpenAPI、curl、SDK quickstart。

llms.txt

給 AI 讀的 metadata →

Source code

npm 上的 @maacgo/mcp →
MIT licensed。

從 Claude 直接發台灣 SMS。一行裝完。