# Tellnod MCP 伺服器

> Tellnod 是位於 `https://mcp.tellnod.com/mcp` 的遠端 Email 行銷 MCP 伺服器：採用 Streamable HTTP 與 OAuth 2.1，提供品牌、聯絡人、分眾、草稿、預覽、發送與成效等工具，並在支援 MCP Apps 的用戶端中顯示互動卡片。

Canonical: https://tellnod.com/zh-Hant/mcp-server  
Last updated: 2026-10-17  
Author: Tellnod team

## 端點與傳輸方式

- **網址：**`https://mcp.tellnod.com/mcp`
- **傳輸方式：**Streamable HTTP。不需要在本機安裝或執行任何程式。
- **用戶端：**Claude（自訂連接器）與 ChatGPT（自訂 MCP 伺服器）。設定步驟請見[連接](https://tellnod.com/zh-Hant/connect)。
- **互動卡片：**在支援 MCP Apps 的用戶端中，工具會附上 `ui://tellnod/…` 卡片；其他用戶端則以文字收到相同結果。

## 身分驗證

登入採用 OAuth 2.1 與動態用戶端註冊，用戶端會自行完成註冊，你只要在瀏覽器中用 Google 帳號登入。存取權杖綁定 MCP 伺服器的網址，在其他地方使用一律會被拒絕。

已連接的用戶端可以讀取與撰寫草稿。**發送不是 OAuth 權限。**排程發送必須由真人按下卡片或網頁確認頁面上的 Confirm，因此單憑權杖永遠無法寄出 Email。

## 工具

每個工具都會宣告 `readOnlyHint`、`destructiveHint`、`idempotentHint` 與 `openWorldHint`，讓用戶端能告訴你哪些呼叫會變更資料。

### 唯讀

- `get_workspace`、`get_overview`：帳號、方案、限制與下一步建議。
- `fetch_brand`：從你的網站讀取 Logo、品牌色與字型。
- `search_contacts`、`get_contact`、`list_segments`、`estimate_audience`：找出聯絡人，並在儲存前估算發送對象人數。
- `render_preview`、`preview_inbox`、`preview_channels`、`list_templates`：真實的信件、收件匣中的顯示樣子與起始範本。
- `check_domain`：寄件網域的 DNS 狀態。
- `get_send`、`list_sends`、`get_campaign_results`、`compare_campaigns`：發送狀態與成效。

### 寫入

- `save_brand`、`confirm_brand`：儲存每封信都會套用的品牌設定。
- `import_contacts`、`tag_contacts`、`create_segment`：附同意狀態的聯絡人，以及已儲存的分眾。
- `create_message_draft`、`update_message_draft`、`apply_template`：撰寫並修改信件。
- `add_domain`、`remove_domain`：從自有網域寄信。
- `send_test`：寄一封測試信給自己（每天最多 20 封）。
- `prepare_send`、`prepare_resend`：鎖定收件名單並顯示確認卡片。
- `cancel_send`：取消已排程的發送。

> `confirm_send` 只開放給卡片，模型看不到，因此 AI 助理無法自行完成發送。

## 兩段式發送

1. `prepare_send` 會鎖定收件名單，並回傳一個確認，綁定工作區、操作者、訊息與這份名單本身。
2. 確認卡片列出收件人數、被排除的聯絡人與原因、發送時間與合規檢查清單。
3. 按下 Confirm 後即排入發送。確認僅能使用一次，並在 10 分鐘後失效；重新準備會產生新的確認。
4. 「立即發送」會等待 5 分鐘，任何已排程的發送在寄出前都可以取消。

## 限制與防護機制

- 共用寄件網域（例如 hello@yourshop.tellnodmail.com 這類地址）：每檔最多 500 位收件人、每月最多 1,000 封。驗證自有網域後即解除這些限制。
- Free 方案：500 位聯絡人，每月 2,000 封。
- 客訴率達 0.1% 或退信率達 2% 時，發送會自動暫停。
- 每一檔行銷活動都會自動加上取消訂閱連結、一鍵取消訂閱標頭與通訊地址。

## WhatsApp 與 LINE 工具

WhatsApp 與 LINE 工具共用同樣的聯絡人、預覽與兩段式發送，會在各渠道開放時出現在工具清單中：接下來是 WhatsApp，之後是 LINE。詳見[LINE MCP 伺服器](https://tellnod.com/zh-Hant/line-mcp-server)。

## FAQ

### Tellnod MCP 伺服器是開源的嗎？

伺服器是託管服務。信件預覽的轉譯元件 `preview-kit` 預計以開源套件的形式公開。

### 可以從我自己的 MCP 用戶端使用嗎？

任何支援透過 Streamable HTTP 連接遠端 MCP 伺服器並以 OAuth 登入的用戶端都可以連接。卡片只會在支援 MCP Apps 的用戶端中顯示。

### 可以用 API 金鑰透過 MCP 伺服器寄信嗎？

不行。沒有任何 API 金鑰具備發送權限；每一次發送都需要真人按下 Confirm。