택배 배송조회 MCP — CJ대한통운·우체국·한진·롯데·로젠·쿠팡 + 해외
CJ대한통운, 우체국, 한진, 롯데, 로젠, 쿠팡 같은 국내 택배와 야마토·DHL·UPS 등 해외 배송을 운송장 번호로 조회해, AI 에이전트가 배송 상태를 답하고 여러 건을 한 번에 정리할 수 있게 해 주는 무료 오픈소스 MCP 서버입니다.
@appmonster/mcp-delivery무료 · MIT 오픈소스GitHub →
무엇을 할 수 있나
| 도구 | 하는 일 |
|---|---|
delivery_track_parcel | 운송장 한 건 조회(현재 상태·이동 기록) |
delivery_track_many | 여러 건을 한 번에 조회해 상태별로 정리 |
delivery_list_carriers | 지원 택배사와 코드 |
설치 없이 바로 · 키 필요 없음
주소 하나만 넣으면 됩니다
이 서버의 조회 도구는 okagent.kr 원격 서버로도 제공합니다. 하루 100회까지 무료이고, 파일 경로 대신 URL이나 base64로 넘깁니다.
https://okagent.kr/api/mcp- Claude — 설정 → 커넥터 → 사용자 지정 커넥터 추가
- ChatGPT — 앱 및 커넥터 → 개발자 모드 → 커넥터 만들기 (인증 없음)
- Claude Code —
claude mcp add --transport http okagent https://okagent.kr/api/mcp
내 컴퓨터에 설치 (1분)
Node.js 20 이상이 필요합니다. 따로 내려받을 것 없이 npx가 실행할 때 가져옵니다.
Claude Desktop · Cursor · Windsurf
MCP 설정 파일(claude_desktop_config.json, .cursor/mcp.json 등)에 넣습니다.
{
"mcpServers": {
"delivery": {
"command": "npx",
"args": [
"-y",
"@appmonster/mcp-delivery"
],
"env": {
"DELIVERY_TRACKER_CLIENT_ID": "…",
"DELIVERY_TRACKER_CLIENT_SECRET": "…"
}
}
}
}Claude Code
claude mcp add delivery -e DELIVERY_TRACKER_CLIENT_ID=… -e DELIVERY_TRACKER_CLIENT_SECRET=… -- npx -y @appmonster/mcp-delivery필요한 키와 발급처
- 필수
DELIVERY_TRACKER_CLIENT_ID— Delivery Tracker 클라이언트 ID- 필수
DELIVERY_TRACKER_CLIENT_SECRET— Delivery Tracker 클라이언트 시크릿
발급: Delivery Tracker 콘솔. 무료 플랜으로 가입하면 바로 발급됩니다. 설치 없이 쓰려면 아래 원격 서버를 쓰면 키가 필요 없습니다.
이렇게 시켜 보세요
- “CJ대한통운 운송장 1234-5678-9012 지금 어디야?”
- “이 주문 10건 송장번호 줄게. 아직 배송 안 끝난 것만 알려줘.”
자주 묻는 질문
택배사 코드를 알아야 하나요?
아니요. ‘CJ’, ‘우체국’, ‘한진’, ‘yamato’처럼 이름만 알려 주면 코드는 자동으로 찾습니다.
키 없이 쓸 수 있나요?
네. okagent.kr/api/mcp 원격 서버로 쓰면 키 없이 하루 100회까지 무료입니다.