mcpbrief를 Claude에 연결하기
mcpbrief는 원격 MCP 서버입니다. URL을 커넥터로 한 번 추가하고 로그인하면, 이후 모든 채팅에서 일반 우편과 등기우편을 보낼 수 있습니다.
Claude.ai · Claude Desktop · Claude Mobile
커넥터로 추가
- Claude(claude.ai 또는 데스크톱 앱)에서 설정 → 커넥터를 엽니다.
- “사용자 지정 커넥터 추가”를 클릭합니다.
- 이름: mcpbrief, URL:
https://mcpbrief.de/mcp - 연결을 클릭하고 mcpbrief에 로그인한 후 액세스를 승인합니다.
- 이제 채팅에 “…을(를) 우편으로 …에게 보내 줘”라고 입력하기만 하면 됩니다.
Team 및 Enterprise 조직에서는 관리자가 커넥터를 승인해야 할 수 있습니다. ChatGPT에서도 설정 → 앱 및 커넥터에서 같은 방식으로 작동합니다.
Claude Code
Claude Code(터미널)
브라우저 로그인 사용:
claude mcp add --transport http mcpbrief https://mcpbrief.de/mcp
또는 API 키 사용:
claude mcp add --transport http mcpbrief https://mcpbrief.de/mcp \ --header "Authorization: Bearer mbx_YOUR_KEY"
API 키는 계정 → API 키에서 생성하세요.
ChatGPT · Grok · Gemini
ChatGPT, Grok 및 Gemini
- ChatGPT: 설정 → 앱 및 커넥터 → 커넥터 만들기, URL
https://mcpbrief.de/mcp입력, mcpbrief로 로그인. - Grok: grok.com → 커넥터 → 자체 MCP 서버 추가, URL
https://mcpbrief.de/mcp, 헤더Authorization: Bearer mbx_…로 인증(계정의 API 키). - Gemini: URL
https://mcpbrief.de/mcp로 사용자 지정 MCP 서버 추가(Gemini Enterprise는 관리자를 통해 OAuth로, 개인 계정은 가능한 경우 “연결된 앱”을 통해).
예시
„첨부한 청구서를 우편으로 Muster GmbH, Ringstraße 5, 1010 Wien에 보내 줘.“
„보험사에 계약 4711 해지 통지서를 작성해서(주소는 PDF에 있음) 등기우편으로 보내 줘.“
„어제 보낸 등기우편이 우체국에 접수되었나요? 추적번호는 무엇인가요?“
„잔액이 얼마나 남았나요?“
사용 가능한 도구
| Tool | 설명 | 유형 |
|---|---|---|
get_letter_price | 주소를 확인하고, 우편을 레이아웃하고, 페이지 수를 세고, 비용을 계산하여 PDF 미리보기를 반환합니다. 발송하지 않습니다. | read-only |
send_letter | 우편을 발송합니다(텍스트, Markdown, PDF, DOCX, 이미지 – 본문, Base64 또는 URL). 확인 후에만 발송. | 청구됨 |
get_letter_status | 발송 상태와 등기우편의 경우 추적번호를 반환합니다. | read-only |
get_letter_history | 최근 우편 목록을 표시합니다. | read-only |
get_batch_price · send_letter_batch | 편지 병합: 플레이스홀더로 수신인별 우편 한 통(가격 확인 또는 발송). | 청구됨 |
resend_letter | 저장된 문서로 이전 우편을 다시 발송합니다(확인 후에만). | 청구됨 |
cancel_letter | 아직 인쇄되지 않은 우편을 취소합니다(금액 환불). | 환불됨 |
get_account_balance | 잔액, 가격, 발신인, 일일 한도를 표시합니다. | read-only |
우편 전달 방식
Claude가 주소를 “recipient”로, 편지 본문을 “content”로 전달하면 mcpbrief가 레터헤드, 봉투 창 위치의 주소, 날짜, 페이지 번호가 포함된 완성된 A4 우편으로 만듭니다.
{
"recipient": {
"name": "Stadtwerke Musterstadt GmbH",
"company": "Kundenservice",
"street": "Hauptstraße 1",
"zip": "10115",
"city": "Berlin",
"country": "DE"
},
"delivery": "registered",
"subject": "Kündigung Vertrag 4711",
"content": "Sehr geehrte Damen und Herren,\n\nhiermit kündige ich …\n\nMit freundlichen Grüßen\nMax Muster",
"idempotency_key": "6f1c…"
}
또는: file_base64 + file_name(PDF, DOCX, TXT, MD, JPG, PNG) 또는 file_url(공개 https 링크) – 이 경우 앞에 주소 시트가 추가됩니다.