Poste uma carta pelo seu assistente de IA

Conectar

O conector é um servidor MCP remoto via Streamable HTTP. Ele não exige login, então deixe a autenticação desativada.

• Claude: abra Customize → Connectors, escolha Add custom connector, dê o nome Unopost e cole a URL do servidor. Em uma conversa, ative a Unopost no menu de ferramentas.
• ChatGPT: adicione um conector personalizado no modo de desenvolvedor com a URL do servidor e sem autenticação, depois ative-o na conversa.
• Claude Code e outros clientes: adicione-o como servidor HTTP remoto. Qualquer cliente que aceite servidores MCP personalizados usa a mesma URL.

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

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

Como uma carta é enviada

1. Confirmar os endereços
2. Preparar a carta
3. Aguardar a diagramação
4. O usuário paga no site

O assistente confirma os endereços com o usuário, prepara a carta e entrega ao usuário um link de revisão privado. Lá, o usuário confere a prévia, informa um e-mail e paga com cartão. É o pagamento que faz a carta ser postada.

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.

Ferramentas

Os assistentes as chamam por conta própria. Todo resultado de prepare_letter, finish_letter_upload e get_letter_status traz reviewUrl, a página privada onde o usuário confere a prévia e paga, e instructions, que dizem o que informar ao usuário em seguida.

Limites

pages

Até 80 páginas por carta. Divida um documento mais longo em cartas separadas.

regular

O correio comum, e qualquer carta dobrada, aceita até 12 páginas. Cartas mais longas seguem pelo Express Post, sem dobrar.

size

Até 50 MB por arquivo.

files

PDF, Word (.doc, .docx), JPEG ou PNG. Documentos do Word são diagramados em A4.

letter

Um arquivo por carta pelo conector. O site aceita até 10.

rate

200 cartas por hora de cada host de IA.

Status

CREATED

Reservada, aguardando o arquivo.

CONVERTING

Sendo diagramada.

CONVERTED AWAITING_PAYMENT

Pronta para o usuário conferir e pagar em reviewUrl.

PAID PAYING SENDING RETRYING MANUAL_CHECK

Paga. Cartas pagas até as 14h30, horário de Melbourne, em um dia útil são postadas no mesmo dia.

POSTED UNDELIVERED

Postada na Australia Post. O número de rastreamento foi enviado ao usuário por e-mail.

DELIVERED

O rastreamento da Australia Post mostra que foi entregue.

FAILED

Não postada. error diz o motivo, e instructions, o que fazer em seguida. Uma carta paga é reembolsada integralmente.

PAYMENT_EXPIRED

Não foi paga a tempo. O documento foi excluído.

REFUNDED

Cancelada ou não pôde ser postada, e reembolsada no cartão.

Erros

Uma ferramenta que falha retorna um resultado de erro cujo texto, escrito para o assistente, diz o que deu errado e o que fazer. Não há códigos de erro, e podemos mudar a redação das mensagens, então aja conforme o tipo de erro, não conforme as palavras exatas.

Uma ferramenta nunca cobra nem posta, então um erro nunca custa nada ao usuário. Mas, quando um erro cita um job, essa carta existe: confira-a com get_letter_status em vez de preparar uma segunda.

arguments

Um argumento está faltando ou errado: um endereço que o usuário deveria confirmar, opções que não combinam, um tipo de arquivo não suportado, um preparedFor recusado ou um e-mail malformado. A mensagem indica qual. Corrija e chame de novo; nada foi criado.

file

Não foi possível obter o arquivo original do host: o link expirou, foi recusado, demorou demais ou redirecionou vezes demais, aponta para um endereço privado, ou o arquivo está vazio ou passa de 50 MB. Nada foi postado. Obtenha uma nova referência de arquivo ou use create_letter_upload; nunca envie uma cópia em texto no lugar.

job …

A mensagem começa com job …: quando a carta foi criada, mas uma etapa posterior falhou. Chame get_letter_status com esse ID do job e depois finish_letter_upload se ela ainda estiver aguardando os endereços. Não prepare outra carta.

rate limit

Cartas demais deste host de IA nesta hora, ou o limite diário do conector foi atingido. Não tente de novo em loop: diga ao usuário para tentar mais tarde ou enviar pelo site da Unopost.

paused

Pausamos novas cartas por um tempo; as cartas já em andamento continuam. Tente novamente mais tarde.

not found

Nenhuma carta tem esse jobId, ou o upload expirou após 24 horas. Use somente um ID do job que a Unopost retornou a este usuário e comece de novo se ele expirou.

server

Algo deu errado do nosso lado: Unopost API returned HTTP 5xx. Aguarde alguns segundos e tente mais uma vez.

FAILED

Uma carta que não pode ser impressa não é um erro da ferramenta: get_letter_status retorna FAILED com error e instructions claras, como dividir um documento com mais de 80 páginas ou remover uma senha.

Pagamento e privacidade

• Ele nunca paga nem posta. O conector não retorna nenhum link de pagamento. O usuário paga somente no site, depois de ver a prévia.
• O arquivo original, sem alterações. Os arquivos nunca trafegam dentro de mensagens MCP e nunca são substituídos por texto.
• Links privados. O ID do job é a única chave de uma carta, então os assistentes só o compartilham, assim como o reviewUrl, com o usuário.
• Cancele antes da impressão. Uma carta paga pode ser cancelada com reembolso integral pelo reviewUrl até começarmos a imprimi-la.
• Excluídos após a postagem. Os documentos são excluídos assim que a carta é postada, e os de uma carta não paga, após 24 horas.

Webhooks? Use uma caixa de entrada

O conector não tem webhooks. Em vez disso, dê ao assistente um notifyEmail de uma caixa de entrada que o seu software lê. Todo e-mail sobre uma carta vem de notifications@unopost.com.au e traz a carta nos cabeçalhos, então um serviço de e-mail que executa código ao receber mensagens, como Amazon SES, Postmark, Mailgun ou SendGrid, pode agir sobre cada atualização assim que ela chega.

1. Aponte o notifyEmail para um endereço que o seu serviço de e-mail recebe, como letters@yourbusiness.com.au.
2. Aceite apenas e-mails de notifications@unopost.com.au que passem no DMARC e descarte o resto.
3. Leia os cabeçalhos, não o texto, que pode mudar. Descarte um Unopost-Event-Id que você já viu.

Cabeçalhos

Unopost-Letter-Id

O jobId da carta, como o conector o retornou.

Unopost-Event

O que aconteceu: receipt, posted, tracking, retrying, delayed, awaiting-collection, delivered, cancelled, failed, refunded ou refunded-printed.

Unopost-Event-Id

É o mesmo para a mesma notícia, não importa quantas vezes ela seja enviada, então você pode descartar repetições.

Unopost-Letter-Status

O status da carta depois do evento: TO_POST, POSTED, DELAYED, AWAITING_AT_COLLECTION, DELIVERED, CANCELLED ou REFUNDED.

Unopost-Tracking-Number

O número de rastreamento da Australia Post, assim que a carta é postada.

Unopost-Copy

business na cópia que uma empresa recebe; não no e-mail do próprio cliente.

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'),
  });
};

As cópias começam quando o cliente paga, então nada chega para uma carta que nunca foi paga: consulte get_letter_status até lá. Os e-mails do próprio cliente trazem os mesmos cabeçalhos. Podemos adicionar cabeçalhos, mas nunca renomear nem remover estes.

Descoberta

Os agentes encontram o conector sem que ninguém precise avisá-los. Ele está listado no nosso catálogo de IA, que aponta para o seu MCP server card.

• Catálogo de IA /.well-known/ai-catalog.json
• MCP server card /.well-known/mcp/server-card.json

Preços

Toda carta tem rastreamento. O preço final depende do número de páginas, que é conhecido depois que a carta é diagramada.

As cartas preparadas pelo conector estão sujeitas aos nossos Termos e à nossa Política de Privacidade, como qualquer outra.