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. ユーザーがウェブサイトで支払う

アシスタントはユーザーに住所を確認し、手紙を準備して、非公開の確認用リンクをユーザーに渡します。ユーザーはそこでプレビューを確認し、メールアドレスを入力してカードで支払います。支払いが済むと、手紙が郵送されます。

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.

ツール

これらはアシスタントが自ら呼び出します。prepare_letter, finish_letter_upload、get_letter_statusのすべての結果には、ユーザーがプレビューを確認して支払う非公開ページのreviewUrlと、次にユーザーに伝える内容を示すinstructionsが含まれます。

制限

pages

1通あたり80ページまで。長い書類は別々の手紙に分けてください。

regular

普通郵便と、折りたたむ手紙はすべて12ページまでです。それより長い手紙は、Express Postで折らずに送ります。

size

1ファイルあたり50 MBまで。

files

PDF、Word（.doc、.docx）、JPEG、PNG。Word文書はA4にレイアウトされます。

letter

コネクタ経由では手紙1通につき1ファイル。ウェブサイトでは10ファイルまで受け付けます。

rate

AIホストごとに1時間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

キャンセルされたか発送できなかったため、カードに返金しました。

エラー

失敗したツールは、何が起きたか、どうすればよいかをアシスタント向けに書いたテキスト付きのエラー結果を返します。エラーコードはなく、メッセージの文言は変わることがあるため、正確な文言ではなくエラーの種類に応じて対応してください。

ツールが支払いや郵送を行うことはないため、エラーでユーザーに費用が発生することはありません。ただし、エラーにジョブが示されている場合、その手紙は作成済みです。2通目を準備せず、get_letter_statusで状態を確認してください。

arguments

引数が不足しているか誤っています。ユーザーに確認すべき住所、両立しないオプション、未対応のファイル形式、拒否されたpreparedFor、不正な形式のメールアドレスなどです。メッセージに該当箇所が示されます。修正して再度呼び出してください。何も作成されていません。

file

ホストから元のファイルを取得できませんでした。リンクの期限切れ、拒否、応答が遅すぎる、リダイレクトが多すぎる、非公開のアドレスを指している、またはファイルが空か50 MBを超えている場合です。何も郵送されていません。新しいファイル参照を取得するか、create_letter_uploadを使ってください。代わりにテキストのコピーを送ることは絶対にしないでください。

job …

手紙は作成されたものの後の手順で失敗した場合、メッセージはjob …:で始まります。そのジョブIDでget_letter_statusを呼び出し、まだ住所を待っている場合はfinish_letter_uploadを呼び出してください。別の手紙を準備しないでください。

rate limit

このAIホストからの1時間あたりの手紙が多すぎるか、コネクタの1日の上限に達しました。ループで再試行せず、後で試すか、Unopostのウェブサイトから送るようユーザーに伝えてください。

paused

新しい手紙の受け付けを一時停止しています。すでに処理中の手紙はそのまま進みます。後でもう一度お試しください。

not found

そのjobIdの手紙はないか、アップロードが24時間で期限切れになりました。Unopostがこのユーザーに返したジョブIDだけを使い、期限切れの場合は最初からやり直してください。

server

当社側で問題が発生しました：Unopost API returned HTTP 5xx。数秒待ってから、もう一度だけお試しください。

FAILED

印刷できない手紙はツールのエラーではありません。get_letter_statusはFAILEDを、errorとわかりやすいinstructionsとともに返します。たとえば、80ページを超える書類を分割する、パスワードを解除する、などです。

支払いとプライバシー

• 支払いも郵送も勝手に行いません。コネクタは支払いリンクを返しません。ユーザーはプレビューを見た後、ウェブサイトでのみ支払います。
• 元のファイルをそのまま。ファイルがMCPメッセージに含まれてやり取りされることはなく、テキストに置き換えられることもありません。
• 非公開のリンク。ジョブIDが手紙にアクセスする唯一の鍵なので、アシスタントはジョブIDとreviewUrlをユーザー以外には伝えません。
• 印刷前ならキャンセル可能。支払い済みの手紙は、当社が印刷を始めるまでreviewUrlからキャンセルでき、全額返金されます。
• 発送後に削除。書類は手紙の発送後に削除し、未払いの手紙の書類は24時間後に削除します。

Webhookの代わりに受信箱を

コネクタにはWebhookがありません。代わりに、お使いのソフトウェアが読み取る受信箱の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カタログに掲載されており、そこからMCPサーバーカードを参照しています。

• AIカタログ /.well-known/ai-catalog.json
• MCPサーバーカード /.well-known/mcp/server-card.json

料金

すべての手紙は追跡付きです。最終的な料金はページ数によって決まり、ページ数は手紙のレイアウト後に確定します。

コネクタを通じて準備された手紙にも、他の手紙と同様に当社の利用規約とプライバシーポリシーが適用されます。