用 AI 助理寄信

連接

此連接器是使用 Streamable HTTP 的遠端 MCP 伺服器。不需登入，請將驗證保持關閉。

• Claude：開啟 Customize → Connectors，選擇 Add custom connector，命名為 Unopost 並貼上伺服器 URL。在對話中，從工具選單開啟 Unopost。
• ChatGPT：在開發者模式中，以伺服器 URL 新增不需驗證的自訂連接器，然後在對話中開啟。
• Claude Code 與其他用戶端：將其新增為遠端 HTTP 伺服器。任何支援自訂 MCP 伺服器的用戶端都使用同一個 URL。

claude mcp add --transport http unopost https://unopost.com.au/api/mcp

{
  "mcpServers": {
    "unopost": {
      "type": "http",
      "url": "https://unopost.com.au/api/mcp"
    }
  }
}

寄信流程

1. 確認地址
2. 準備信件
3. 等待排版
4. 使用者在網站上付款

AI 助理先向使用者確認地址，再準備信件，並提供使用者一個私人審閱連結。使用者在該處確認預覽、輸入電子郵件並以信用卡付款。付款後信件才會寄出。

Post this letter by Express Post to Jane Citizen,
12 Example Street, Southbank VIC 3006.
My return address is 1 Sample Road, Carlton VIC 3053.

工具

這些工具由 AI 助理自行呼叫。prepare_letter, finish_letter_upload 與 get_letter_status 的每個結果都包含 reviewUrl（使用者確認預覽並付款的私人頁面）與 instructions（說明接下來要告訴使用者什麼）。

限制

pages

每封信最多 80 頁。較長的文件請拆成多封信。

regular

普通郵件以及任何摺疊的信件最多 12 頁。更長的信件以 Express Post 平放寄出。

size

每個檔案最大 50 MB。

files

PDF、Word（.doc、.docx）、JPEG 或 PNG。Word 文件以 A4 排版。

letter

透過連接器每封信一個檔案。網站最多可接受 10 個。

rate

每個 AI 主機每小時 200 封。

狀態

CREATED

已預留，等待檔案。

CONVERTING

正在排版。

CONVERTED AWAITING_PAYMENT

已就緒，等待使用者在 reviewUrl 確認並付款。

PAID PAYING SENDING RETRYING MANUAL_CHECK

已付款。在工作天墨爾本時間下午 2:30 前付款的信件，當天寄出。

POSTED UNDELIVERED

已交寄 Australia Post。追蹤號碼已以電子郵件寄給使用者。

DELIVERED

Australia Post 的追蹤紀錄顯示已送達。

FAILED

未寄出。原因見 error，下一步見 instructions。已付款的信件會全額退款。

PAYMENT_EXPIRED

未在期限內付款。文件已刪除。

REFUNDED

已取消或無法寄出，款項已退回信用卡。

錯誤

工具失敗時會傳回一個錯誤結果，其文字是寫給 AI 助理的，說明出了什麼問題以及該怎麼做。沒有錯誤代碼，我們也可能修改訊息的措辭，因此請依錯誤的類型處理，而非依據確切的字句。

工具絕不會收費或寄信，所以錯誤絕不會讓使用者付出任何費用。但一旦錯誤中提到某個工作，那封信就已存在：請用 get_letter_status 確認它，而不要再準備第二封。

arguments

某個參數缺少或有誤：需要使用者確認的地址、不能同時使用的選項、不支援的檔案類型、遭拒絕的 preparedFor，或格式錯誤的電子郵件。訊息會指出是哪一項。修正後再次呼叫；沒有建立任何內容。

file

無法從主機取得原始檔案：連結已過期、遭拒絕、回應太慢或重新導向次數過多、指向私人位址，或檔案為空或超過 50 MB。沒有寄出任何東西。請取得新的檔案參照，或使用 create_letter_upload；絕不要改為傳送文字副本。

job …

如果信件已建立但後續步驟失敗，訊息會以 job …: 開頭。請用該工作 ID 呼叫 get_letter_status，若它仍在等待地址，再呼叫 finish_letter_upload。不要再準備另一封信。

rate limit

本小時內來自該 AI 主機的信件過多，或已達到連接器的每日上限。不要循環重試：請告訴使用者稍後再試，或在 Unopost 網站上寄出。

paused

我們暫時停止接收新信件；已在處理中的信件照常進行。請稍後再試。

not found

沒有信件使用該 jobId，或其上傳已在 24 小時後過期。只使用 Unopost 傳回給該使用者的工作 ID；若已過期，請重新開始。

server

我們這邊出了問題：Unopost API returned HTTP 5xx。請等待幾秒鐘，再試一次。

FAILED

無法列印的信件不屬於工具錯誤：get_letter_status 會傳回 FAILED，並附上 error 與淺白的 instructions，例如拆分超過 80 頁的文件或移除密碼。

付款與隱私

• 它絕不代為付款或寄信。連接器不會傳回付款連結。使用者只會在看過預覽後，於網站上付款。
• 原始檔案，原封不動。檔案絕不會在 MCP 訊息中傳遞，也絕不會被換成文字。
• 私人連結。工作 ID 是存取信件的唯一鑰匙，因此 AI 助理只會將它和 reviewUrl 交給使用者。
• 列印前可取消。已付款的信件在我們開始列印之前，可從 reviewUrl 取消並全額退款。
• 寄出後刪除。信件寄出後即刪除文件；未付款信件的文件於 24 小時後刪除。

需要 Webhook？請用收件匣

連接器沒有 Webhook。請改為提供 AI 助理一個由您的軟體讀取的收件匣作為 notifyEmail。有關信件的每封電子郵件都由 notifications@unopost.com.au 寄出，並在標頭中帶有該信件的資訊，因此能對收到的郵件執行程式碼的郵件服務（例如 Amazon SES、Postmark、Mailgun 或 SendGrid）可在每則更新送達時進行處理。

1. 將 notifyEmail 指向您的郵件服務接收的地址，例如 letters@yourbusiness.com.au。
2. 只接受來自 notifications@unopost.com.au 且通過 DMARC 驗證的郵件，其餘一律捨棄。
3. 請讀取標頭，而非內文措辭，因為措辭可能會變。已收過的 Unopost-Event-Id 請捨棄。

標頭

Unopost-Letter-Id

信件的 jobId，與連接器傳回的相同。

Unopost-Event

發生了什麼：receipt、posted、tracking、retrying、delayed、awaiting-collection、delivered、cancelled、failed、refunded 或 refunded-printed。

Unopost-Event-Id

同一則消息無論寄送幾次，此值都相同，因此可以捨棄重複的郵件。

Unopost-Letter-Status

此後信件的狀態：TO_POST、POSTED、DELAYED、AWAITING_AT_COLLECTION、DELIVERED、CANCELLED 或 REFUNDED。

Unopost-Tracking-Number

信件寄出後的 Australia Post 追蹤號碼。

Unopost-Copy

企業收到的副本中為 business；客戶本人的郵件中沒有。

From: Unopost <notifications@unopost.com.au>
Unopost-Letter-Id: 019d7a7f-a183-752d-9b3b-11511179033b
Unopost-Event: tracking
Unopost-Event-Id: evt_3f9a1c0b7e2d4a6b8c1d0e2f
Unopost-Letter-Status: POSTED
Unopost-Tracking-Number: 33LQV507012301000935005
Unopost-Copy: business

export const handler = async (event) => {
  const { mail, receipt } = event.Records[0].ses;
  const { from } = mail.commonHeaders;
  const fromUs = from.length === 1 && /(^|<)notifications@unopost\.com\.au>?$/i.test(from[0]);
  // DMARC, not DKIM alone: only a DMARC pass means unopost.com.au signed it.
  if (!fromUs || receipt.dmarcVerdict.status !== 'PASS') return;
  const header = name =>
    mail.headers.find(h => h.name.toLowerCase() === name.toLowerCase())?.value;
  await recordUpdate({
    letterId: header('Unopost-Letter-Id'),
    event: header('Unopost-Event'),
    eventId: header('Unopost-Event-Id'), // drop one you've seen
    status: header('Unopost-Letter-Status'),
    trackingNumber: header('Unopost-Tracking-Number'),
  });
};

副本在客戶付款後才開始寄送，因此從未付款的信件不會收到任何郵件：在此之前請以 get_letter_status 查詢。客戶本人收到的郵件也帶有相同的標頭。我們可能會新增標頭，但絕不會重新命名或移除以上這些。

探索

AI 代理不需告知就能找到此連接器。它列在我們的 AI 目錄中，目錄指向它的 MCP 伺服器卡片。

• AI 目錄 /.well-known/ai-catalog.json
• MCP 伺服器卡片 /.well-known/mcp/server-card.json

價格

每封信都可追蹤。最終價格取決於頁數，頁數在信件排版完成後確定。

透過連接器準備的信件與其他信件相同，適用我們的服務條款與隱私權政策。