API, korespondencja seryjna i wysyłka e-mailem

Wysyłaj listy prosto z własnego oprogramowania – przez REST API, jako korespondencję seryjną lub po prostu e-mailem. Konektor Claude korzysta z tych samych funkcji.

Uwierzytelnianie

Utwórz klucz w Konto → Klucze API i przesyłaj go jako token Bearer. Każde żądanie obciąża wyłącznie saldo danego konta.

curl -H "Authorization: Bearer mbx_…" https://mcpbrief.de/api/v1/balance

Opis OpenAPI: https://mcpbrief.de/openapi.json

Endpointy

GET	/balance	Saldo, ceny, nadawca, limit dzienny
POST	/letter/price	Sprawdzenie adresu, złożenie listu, strony i cena + podgląd PDF (niczego nie wysyła)
POST	/letter/send	Wysłanie listu (tekst, PDF, DOCX, obraz; załączniki, dupleks, centrum kosztów)
GET	/letter/{id}	Status i numer przesyłki
POST	/letter/{id}/cancel	Anulowanie przed drukiem (zwrot)
POST	/letter/{id}/resend	Ponowna wysyłka
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Lista Twoich listów z filtrowaniem
POST	/letters/batch/price	Sprawdzenie korespondencji seryjnej: wszystkie adresy, symbole zastępcze, cena łączna
POST	/letters/batch/send	Wysłanie korespondencji seryjnej (maks. 200 odbiorców)

Przykład: list polecony z załącznikiem

curl -X POST https://mcpbrief.de/api/v1/letter/send \
  -H "Authorization: Bearer mbx_…" -H "Content-Type: application/json" \
  -d '{
  "recipient": {"name": "Muster GmbH", "street": "Ringstraße 5",
                "zip": "1010", "city": "Wien", "country": "AT"},
  "subject": "Rechnung 2026-17",
  "content": "Sehr geehrte Damen und Herren,\n\nanbei …",
  "attachments": [{"file_base64": "JVBERi0…", "file_name": "rechnung.pdf"}],
  "delivery": "registered", "duplex": true, "cost_center": "VERTRIEB",
  "idempotency_key": "7d1c2f0e-…"
}'

Przykład: korespondencja seryjna

curl -X POST https://mcpbrief.de/api/v1/letters/batch/send \
  -H "Authorization: Bearer mbx_…" -H "Content-Type: application/json" \
  -d '{
  "recipients": [
    {"name": "Muster GmbH", "street": "Ringstraße 5", "zip": "1010",
     "city": "Wien", "country": "AT", "anrede": "Sehr geehrte Frau Huber"},
    {"name": "Beispiel AG", "street": "Hauptstraße 1", "zip": "10115",
     "city": "Berlin", "country": "DE", "anrede": "Sehr geehrte Damen und Herren"}
  ],
  "subject": "Preisanpassung 2027",
  "content": "{{anrede}},\n\nab 1. Jänner gelten neue Preise …",
  "delivery": "standard", "idempotency_key": "batch-2027-01"
}'

Listy e-mailem

Bez programowania: każde konto ma osobisty adres zleceń. Pliki PDF wysłane na ten adres z e-maila konta wychodzą jako listy.

Każdy załącznik PDF = jeden list, adres w polu okienka (DIN 5008)
Temat steruje opcjami: Polecony, Priorytet, Kolor, Dupleks, Ref: …, Kraj: …
„Załącznik” w temacie: wszystkie pliki są łączone w jeden list
„Test” w temacie: tylko sprawdzenie i cena e-mailem – nic nie jest wysyłane

Wartości statusu

Endpoint statusu, lista i powiadomienie e-mail pokazują aktualny stan.

`pending`	w kolejce
`processing`	druk i kopertowanie
`mailed`	przekazany operatorowi pocztowemu
`failed`	nie wysłano
`cancelled`	anulowany
`undeliverable`	niedoręczalny
`rejected`	odrzucony