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`	已拒绝