API, 편지 병합 및 이메일 발송

귀사의 소프트웨어에서 바로 우편을 보내세요 – REST API, 편지 병합 또는 간단히 이메일로. Claude 커넥터도 같은 기능을 사용합니다.

인증

계정 → API 키에서 키를 생성하고 Bearer 토큰으로 전송하세요. 각 요청은 해당 계정의 잔액에서만 차감됩니다.

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

OpenAPI 명세: https://mcpbrief.de/openapi.json

엔드포인트

GET	/balance	잔액, 가격, 발신인, 일일 한도
POST	/letter/price	주소 확인, 우편 생성, 페이지 수와 가격 + PDF 미리보기(발송 안 함)
POST	/letter/send	우편 발송(텍스트, PDF, DOCX, 이미지; 동봉 문서, 양면, 비용 센터)
GET	/letter/{id}	상태 및 추적번호
POST	/letter/{id}/cancel	인쇄 전 취소(환불)
POST	/letter/{id}/resend	다시 발송
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	우편 목록, 필터 가능
POST	/letters/batch/price	편지 병합 확인: 전체 주소, 플레이스홀더, 총 가격
POST	/letters/batch/send	편지 병합 발송(최대 200명)

예시: 동봉 문서가 있는 등기우편

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

예시: 편지 병합

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

이메일로 우편 발송

프로그래밍이 필요 없습니다: 모든 계정에는 개인 주문 주소가 있습니다. 계정 이메일에서 이 주소로 보낸 PDF가 우편으로 발송됩니다.

PDF 첨부 파일 하나 = 우편 한 통, 주소는 창 영역(DIN 5008)에
제목으로 옵션 제어: Registered, Priority, Colour, Duplex, Ref: …, Country: …
제목에 “Enclosure”: 모든 파일을 하나의 우편으로 결합
제목에 “Test”: 확인만 하고 가격을 이메일로 받음 – 발송 안 함

상태 값

상태 엔드포인트, 목록 및 이메일 알림에 현재 상태가 표시됩니다.

`pending`	대기 중
`processing`	인쇄 및 봉투 작업 중
`mailed`	우체국 접수 완료
`failed`	발송 안 됨
`cancelled`	취소됨
`undeliverable`	배달 불가
`rejected`	거부됨