API, hromadná korespondence a odesílání e-mailem

Posílejte dopisy přímo ze svého softwaru – přes REST API, jako hromadnou korespondenci nebo jednoduše e-mailem. Konektor pro Claude používá stejné funkce.

Ověření

Vytvořte klíč v Účet → API klíče a posílejte ho jako bearer token. Každý požadavek zatěžuje pouze kredit daného účtu.

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

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

Endpointy

GET	/balance	Kredit, ceny, odesílatel, denní limit
POST	/letter/price	Kontrola adresy, sestavení dopisu, strany a cena + náhled v PDF (nic neodesílá)
POST	/letter/send	Odeslání dopisu (text, PDF, DOCX, obrázek; přílohy, duplex, nákladové středisko)
GET	/letter/{id}	Stav a sledovací číslo
POST	/letter/{id}/cancel	Zrušení před tiskem (vrácení částky)
POST	/letter/{id}/resend	Odeslat znovu
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	Seznam vašich dopisů s filtrováním
POST	/letters/batch/price	Kontrola hromadné korespondence: všechny adresy, zástupné symboly, celková cena
POST	/letters/batch/send	Odeslání hromadné korespondence (max. 200 příjemců)

Příklad: doporučený dopis s přílohou

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-…"
}'

Příklad: hromadná korespondence

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"
}'

Dopisy e-mailem

Bez programování: každý účet má osobní objednávkovou adresu. PDF, která na ni pošlete z e-mailu svého účtu, odejdou jako dopisy.

Každá příloha PDF = jeden dopis, adresa v oblasti okénka (DIN 5008)
Předmět určuje možnosti (anglicky): Registered, Priority, Colour, Duplex, Ref: …, Country: …
„Enclosure“ v předmětu: všechny soubory se spojí do jednoho dopisu
„Test“ v předmětu: pouze kontrola a cena e-mailem – nic se neodešle

Hodnoty stavu

Endpoint stavu, seznam i e-mailové oznámení ukazují aktuální stav.

`pending`	ve frontě
`processing`	tisk a vkládání do obálky
`mailed`	předáno poště
`failed`	neodesláno
`cancelled`	zrušeno
`undeliverable`	nedoručitelné
`rejected`	odmítnuto