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	残高、料金、差出人、1 日の上限
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 添付ファイル 1 つ = 手紙 1 通、宛先は窓位置（DIN 5008）
件名でオプションを指定：書留、速達、カラー、両面、Ref: …、Country: …
件名に「同封」：すべてのファイルを 1 通の手紙にまとめます
件名に「テスト」：確認のみ行い、料金をメールでお知らせ – 送付はされません

ステータス値

ステータスエンドポイント、一覧、メール通知で現在の状態を確認できます。

`pending`	待機中
`processing`	印刷・封入中
`mailed`	郵便事業者に引き渡し済み
`failed`	未送付
`cancelled`	キャンセル済み
`undeliverable`	配達不能
`rejected`	却下