Brief aus Ihrem KI-Assistenten versenden

Verbinden

Der Connector ist ein entfernter MCP-Server über Streamable HTTP. Er braucht keine Anmeldung, lassen Sie die Authentifizierung also ausgeschaltet.

• Claude: Öffnen Sie Customize → Connectors, wählen Sie Add custom connector, nennen Sie ihn Unopost und fügen Sie die Server-URL ein. Schalten Sie Unopost in einem Chat über das Tools-Menü ein.
• ChatGPT: Fügen Sie im Entwicklermodus einen benutzerdefinierten Connector mit der Server-URL und ohne Authentifizierung hinzu und schalten Sie ihn dann im Chat ein.
• Claude Code und andere Clients: Fügen Sie ihn als entfernten HTTP-Server hinzu. Jeder Client, der benutzerdefinierte MCP-Server unterstützt, verwendet dieselbe URL.

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

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

So läuft ein Brief ab

1. Adressen bestätigen
2. Brief vorbereiten
3. Auf den Satz warten
4. Der Nutzer zahlt auf der Website

Der Assistent bestätigt die Adressen mit dem Nutzer, bereitet den Brief vor und gibt dem Nutzer einen privaten Link zur Prüfung. Dort prüft der Nutzer die Vorschau, gibt eine E-Mail-Adresse ein und zahlt per Karte. Erst die Zahlung bringt den Brief auf den Weg.

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.

Tools

Assistenten rufen diese selbst auf. Jedes Ergebnis von prepare_letter, finish_letter_upload und get_letter_status enthält reviewUrl, die private Seite, auf der der Nutzer die Vorschau prüft und bezahlt, und instructions, die sagen, was dem Nutzer als Nächstes mitzuteilen ist.

Limits

pages

Bis zu 80 Seiten pro Brief. Teilen Sie ein längeres Dokument auf mehrere Briefe auf.

regular

Standardpost und jeder gefaltete Brief fassen bis zu 12 Seiten. Längere Briefe gehen flach per Express Post.

size

Bis zu 50 MB pro Datei.

files

PDF, Word (.doc, .docx), JPEG oder PNG. Word-Dokumente werden auf A4 gesetzt.

letter

Über den Connector eine Datei pro Brief. Die Website nimmt bis zu 10.

rate

200 Briefe pro Stunde von jedem KI-Host.

Status

CREATED

Reserviert, wartet auf die Datei.

CONVERTING

Wird gesetzt.

CONVERTED AWAITING_PAYMENT

Bereit, damit der Nutzer ihn unter reviewUrl prüft und bezahlt.

PAID PAYING SENDING RETRYING MANUAL_CHECK

Bezahlt. Briefe, die an einem Werktag bis 14:30 Uhr Melbourner Zeit bezahlt werden, werden noch am selben Tag aufgegeben.

POSTED UNDELIVERED

Bei Australia Post aufgegeben. Die Sendungsnummer wurde dem Nutzer per E-Mail geschickt.

DELIVERED

Laut Sendungsverfolgung von Australia Post zugestellt.

FAILED

Nicht aufgegeben. error nennt den Grund, instructions den nächsten Schritt. Ein bezahlter Brief wird vollständig erstattet.

PAYMENT_EXPIRED

Nicht rechtzeitig bezahlt. Das Dokument wurde gelöscht.

REFUNDED

Storniert oder nicht versendbar und auf die Karte erstattet.

Fehler

Ein Tool, das fehlschlägt, gibt ein Fehlerergebnis zurück, dessen Text sagt, was schiefgelaufen ist und was zu tun ist, geschrieben für den Assistenten. Es gibt keine Fehlercodes, und wir formulieren die Meldungen eventuell um. Reagieren Sie daher auf die Art des Fehlers, nicht auf den genauen Wortlaut.

Ein Tool zahlt und versendet nie, daher kostet ein Fehler den Nutzer nie etwas. Sobald ein Fehler aber einen Job nennt, existiert dieser Brief: Prüfen Sie ihn mit get_letter_status, statt einen zweiten vorzubereiten.

arguments

Ein Argument fehlt oder ist falsch: eine Adresse, die der Nutzer bestätigen sollte, Optionen, die nicht zusammenpassen, ein nicht unterstützter Dateityp, ein abgelehntes preparedFor oder eine fehlerhafte E-Mail-Adresse. Die Meldung nennt es. Korrigieren Sie es und rufen Sie das Tool erneut auf; es wurde nichts angelegt.

file

Die Originaldatei konnte nicht vom Host abgerufen werden: Der Link ist abgelaufen, wurde abgewiesen, war zu langsam oder leitete zu oft weiter, zeigt auf eine private Adresse, oder die Datei ist leer oder größer als 50 MB. Es wurde nichts versendet. Holen Sie eine neue Dateireferenz oder verwenden Sie create_letter_upload; senden Sie nie stattdessen eine Textkopie.

job …

Die Meldung beginnt mit job …:, wenn der Brief angelegt wurde, aber ein späterer Schritt fehlgeschlagen ist. Rufen Sie get_letter_status mit dieser Job-ID auf und dann finish_letter_upload, falls er noch auf seine Adressen wartet. Bereiten Sie keinen weiteren Brief vor.

rate limit

Zu viele Briefe von diesem KI-Host in dieser Stunde, oder das Tageslimit des Connectors ist erreicht. Wiederholen Sie es nicht in einer Schleife: Sagen Sie dem Nutzer, er solle es später versuchen oder den Brief über die Unopost-Website senden.

paused

Wir nehmen vorübergehend keine neuen Briefe an; Briefe, die bereits in Bearbeitung sind, laufen weiter. Versuchen Sie es später erneut.

not found

Kein Brief hat diese jobId, oder sein Upload ist nach 24 Stunden abgelaufen. Verwenden Sie nur eine Job-ID, die Unopost diesem Nutzer zurückgegeben hat, und beginnen Sie neu, wenn sie abgelaufen ist.

server

Bei uns ist etwas schiefgelaufen: Unopost API returned HTTP 5xx. Warten Sie einige Sekunden und versuchen Sie es noch einmal.

FAILED

Ein Brief, der sich nicht drucken lässt, ist kein Tool-Fehler: get_letter_status gibt FAILED mit error und verständlichen instructions zurück, etwa ein Dokument mit über 80 Seiten aufzuteilen oder ein Passwort zu entfernen.

Zahlung und Datenschutz

• Er zahlt und versendet nie. Der Connector gibt keinen Zahlungslink zurück. Der Nutzer zahlt nur auf der Website, nachdem er die Vorschau gesehen hat.
• Die Originaldatei, unverändert. Dateien werden nie in MCP-Nachrichten übertragen und nie durch Text ersetzt.
• Private Links. Eine Job-ID ist der einzige Schlüssel zu einem Brief, daher geben Assistenten sie und reviewUrl nur an den Nutzer weiter.
• Stornieren vor dem Druck. Ein bezahlter Brief kann über reviewUrl gegen volle Erstattung storniert werden, bis wir mit dem Druck beginnen.
• Nach dem Versand gelöscht. Dokumente werden gelöscht, sobald ein Brief aufgegeben ist, die eines unbezahlten Briefs nach 24 Stunden.

Webhooks? Nutzen Sie ein Postfach

Der Connector hat keine Webhooks. Geben Sie dem Assistenten stattdessen eine notifyEmail für ein Postfach, das Ihre Software liest. Jede E-Mail zu einem Brief kommt von notifications@unopost.com.au und enthält den Brief in ihren Headern. Ein Mail-Dienst, der bei eingehender Post Code ausführt, etwa Amazon SES, Postmark, Mailgun oder SendGrid, kann so auf jede Aktualisierung reagieren, sobald sie eintrifft.

1. Richten Sie notifyEmail auf eine Adresse, die Ihr Mail-Dienst empfängt, etwa letters@yourbusiness.com.au.
2. Akzeptieren Sie nur Mails von notifications@unopost.com.au, die die DMARC-Prüfung bestehen, und verwerfen Sie den Rest.
3. Lesen Sie die Header, nicht den Wortlaut, der sich ändern kann. Verwerfen Sie eine Unopost-Event-Id, die Sie schon gesehen haben.

Header

Unopost-Letter-Id

Die jobId des Briefs, wie der Connector sie zurückgegeben hat.

Unopost-Event

Was passiert ist: receipt, posted, tracking, retrying, delayed, awaiting-collection, delivered, cancelled, failed, refunded oder refunded-printed.

Unopost-Event-Id

Für dieselbe Nachricht immer gleich, egal wie oft sie gesendet wird, sodass Sie Wiederholungen verwerfen können.

Unopost-Letter-Status

Der Status des Briefs danach: TO_POST, POSTED, DELAYED, AWAITING_AT_COLLECTION, DELIVERED, CANCELLED oder REFUNDED.

Unopost-Tracking-Number

Die Sendungsnummer von Australia Post, sobald der Brief aufgegeben ist.

Unopost-Copy

business auf der Kopie, die ein Unternehmen erhält; nicht auf der eigenen E-Mail des Kunden.

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

Die Kopien beginnen, sobald der Kunde bezahlt. Für einen nie bezahlten Brief kommt also nichts an: Fragen Sie bis dahin get_letter_status ab. Die E-Mails an den Kunden selbst enthalten dieselben Header. Wir können Header hinzufügen, benennen diese aber nie um und entfernen sie nie.

Auffindbarkeit

Agenten finden den Connector auch ohne Hinweis. Er ist in unserem KI-Katalog gelistet, der auf seine MCP-Server-Card verweist.

• KI-Katalog /.well-known/ai-catalog.json
• MCP-Server-Card /.well-known/mcp/server-card.json

Preise

Jeder Brief hat Sendungsverfolgung. Der Endpreis hängt von der Seitenzahl ab, die feststeht, sobald der Brief gesetzt ist.

Für Briefe, die über den Connector vorbereitet werden, gelten wie für alle anderen unsere Nutzungsbedingungen und unsere Datenschutzerklärung.