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

파일당 최대 50 MB.

files

PDF, Word(.doc, .docx), JPEG 또는 PNG. Word 문서는 A4에 맞춰 배치합니다.

letter

커넥터로는 편지 1통당 파일 1개. 웹사이트에서는 최대 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

취소되었거나 발송할 수 없어 카드로 환불되었습니다.

오류

실패한 도구는 무엇이 잘못되었고 무엇을 해야 하는지를 어시스턴트를 위해 적은 텍스트가 담긴 오류 결과를 반환합니다. 오류 코드는 없으며 메시지 문구는 바뀔 수 있으므로, 정확한 문구가 아니라 오류의 종류에 따라 대응하세요.

도구는 결제나 발송을 하지 않으므로, 오류로 사용자에게 비용이 드는 일은 없습니다. 하지만 오류에 작업이 언급되었다면 그 편지는 이미 존재합니다. 두 번째 편지를 준비하지 말고 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는 error와 알기 쉬운 instructions과 함께 FAILED를 반환합니다. 예를 들어 80페이지가 넘는 문서를 나누거나 비밀번호를 해제하라는 안내입니다.

결제와 개인정보

• 결제나 발송을 대신 하지 않습니다. 커넥터는 결제 링크를 반환하지 않습니다. 사용자는 미리보기를 본 뒤 웹사이트에서만 결제합니다.
• 원본 파일 그대로. 파일은 MCP 메시지에 담겨 오가지 않으며, 텍스트로 바뀌지도 않습니다.
• 비공개 링크. 작업 ID가 편지에 접근하는 유일한 열쇠이므로, 어시스턴트는 작업 ID와 reviewUrl을 사용자에게만 공유합니다.
• 인쇄 전 취소 가능. 결제한 편지는 인쇄를 시작하기 전까지 reviewUrl에서 취소하고 전액 환불받을 수 있습니다.
• 발송 후 삭제. 문서는 편지가 발송되면 삭제하며, 결제되지 않은 편지의 문서는 24시간 후 삭제합니다.

웹훅이 필요하다면 받은편지함을 쓰세요

커넥터에는 웹훅이 없습니다. 대신 소프트웨어가 읽는 받은편지함 주소를 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

가격

모든 편지는 배송 조회가 됩니다. 최종 가격은 페이지 수에 따라 정해지며, 페이지 수는 편지 배치가 끝나면 확정됩니다.

커넥터로 준비한 편지에도 다른 편지와 마찬가지로 저희 이용약관과 개인정보 처리방침이 적용됩니다.