Packy Tracking MCP

공식

다중 택배사 패키지 추적

GitHub이 MCP 사용해 보기스폰서

Packy Tracking MCP(으)로 무엇을 할 수 있나요?

운송 추적 생성 — trackings_create를 통해 새 배송을 등록하고, 일괄 추적 번호를 포함하여 배송 모니터링을 시작합니다.
추적 목록 및 조회 — trackings_list와 trackings_get을 사용하여 모든 배송을 확인하거나 특정 추적 ID의 세부 정보를 가져옵니다.
웹훅 관리 — webhooks_create, webhooks_update, webhooks_list, webhooks_delete로 웹훅 엔드포인트를 생성, 업데이트, 목록 조회 또는 삭제하여 배송 이벤트 알림을 받습니다.
택배사 감지 — courier_detections_create를 사용하여 전체 추적 기록을 생성하기 전에 추적 번호의 택배사를 식별합니다.
지원 택배사 목록 — couriers_list를 조회하여 Packy Tracking API를 통해 사용 가능한 배송 택배사를 확인합니다.

문서

Packy Tracking MCP

Packy Tracking MCP은 Model Context Protocol(MCP)을 통해 호환되는 AI 클라이언트를 Packy Tracking API에 연결합니다.

이 저장소에는 공개 통합 문서와 구성 예시가 포함되어 있습니다. MCP 구현 자체는 호스팅 서비스로, 로컬 서버 설치가 필요하지 않습니다.

MCP 서버는 연결된 Packy 계정을 대신하여 작동합니다. OAuth 인증 중 선택된 API 키에 부여된 권한을 초과하는 권한을 제공하지 않습니다.

엔드포인트

프로덕션 MCP 엔드포인트:

https://mcp.parceltracking.app/mcp

인증

OAuth가 권장되는 인증 방법입니다. 클라이언트가 Packy 인증 페이지를 열면, 사용자가 로그인하고 활성 API 키를 선택합니다. 액세스를 승인하면 MCP 애플리케이션이 해당 키에 연결됩니다.

OAuth 권한은 MCP 서버에서 확인되며 제품 API로 전달되지 않습니다. 제품 요청은 선택된 계정 API 키로 이루어집니다.

액세스 모델

OAuth 동의 중에 사용자는 현재 Packy 계정에 속한 활성 API 키 하나를 선택합니다.
허용 후 MCP 애플리케이션은 선택된 키에 바인딩됩니다.
여러 MCP 애플리케이션이 동일한 API 키에 바인딩될 수 있으며, 각 애플리케이션은 자체 OAuth 인증을 갖습니다.
하나의 애플리케이션을 연결 해제하면 해당 애플리케이션의 OAuth 액세스만 취소되며 API 키가 비활성화되거나 다른 애플리케이션에 영향을 주지 않습니다.
MCP 서버는 Packy API로 작업을 전달하기 전에 OAuth 인증 및 키 상태를 검증합니다.

Claude에서 OAuth 사용

연결 전에 https://lk.parceltracking.app에 로그인하여 API 키를 만들고 활성 상태인지 확인하세요.

Claude 설정 → 커넥터 → 사용자 지정 커넥터 추가를 엽니다.
MCP 엔드포인트를 입력합니다:
```
https://mcp.parceltracking.app/mcp
```
OAuth 인증을 활성화된 상태로 유지하고 Claude가 클라이언트를 자동으로 등록하도록 허용합니다.
브라우저에서 Packy에 로그인합니다. 짧은 인증 계속 페이지가 자동으로 리디렉션되며 클릭할 항목이 없습니다. 링크는 일회용이며 2분 후 만료됩니다.
액세스 허용? 에서 이 연결에 사용할 활성 API 키를 선택하고 허용을 선택합니다.
Claude로 돌아와 커넥터가 연결되었는지 확인합니다.

OAuth 액세스 토큰은 수명이 짧으며 자동으로 갱신됩니다. 흐름이 실패하면 이전 인증 URL을 다시 여는 대신 Claude에서 새 연결 시도를 시작하세요.

Codex에서 OAuth 사용

codex mcp add packy-tracking-mcp \
  --url https://mcp.parceltracking.app/mcp \
  --oauth-resource https://mcp.parceltracking.app/mcp

Codex가 출력한 인증 URL을 열고 Packy에 로그인한 후 활성 API 키를 선택하고 허용을 선택합니다.

API 키로 Cursor 사용

문서화된 Cursor 설정은 API 키를 사용합니다. Cursor의 프로젝트 또는 사용자 mcp.json에 서버 URL과 Authorization: Bearer <YOUR_API_KEY> 헤더를 추가한 후 MCP/에이전트를 다시 시작하세요. examples/cursor/mcp.json을 참조하세요.

API 키 대체 방법

MCP OAuth를 지원하지 않는 클라이언트는 Packy API 키를 직접 사용할 수 있습니다. API 키는 일반 Packy Tracking API에서 사용하는 키와 동일합니다.

{
  "mcpServers": {
    "packy-tracking-mcp": {
      "url": "https://mcp.parceltracking.app/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>"
      }
    }
  }
}

<YOUR_API_KEY>를 Packy 계정의 활성 키로 교체하세요. 키를 게시하거나 공유하지 마세요.

서버는 동등한 헤더도 허용합니다:

X-API-Key: <YOUR_API_KEY>

키가 Packy에서 선택되고 클라이언트 구성에 복사되지 않으므로 OAuth 흐름이 권장됩니다.

도구

도구	Tracking API 작업
`trackings_create`	`POST /v1/trackings`
`trackings_list`	`GET /v1/trackings`
`trackings_get`	`GET /v1/trackings/{id}`
`trackings_delete`	`DELETE /v1/trackings/{id}`
`couriers_list`	`GET /v1/couriers`
`courier_detections_create`	`POST /v1/courier-detections`
`webhooks_list`	`GET /v1/webhooks`
`webhooks_create`	`POST /v1/webhooks`
`webhooks_update`	`PATCH /v1/webhooks/{id}`
`webhooks_delete`	`DELETE /v1/webhooks/{id}`

저장된 데이터를 변경하는 작업은 trackings_create, trackings_delete, webhooks_create, webhooks_update, webhooks_delete입니다. 계정 데이터를 명시적으로 수정하려는 경우에만 실행하세요.

trackings_create만 크레딧을 소비합니다: 고유 추적 번호당 1크레딧(배치의 각 추적 번호 포함). 택배사, 감지, 읽기, 삭제 및 웹훅 도구는 크레딧을 소비하지 않습니다. MCP는 Tracking API와 별도로 청구되지 않습니다.

연결 해제 및 취소

하나의 MCP 애플리케이션을 중지하려면:

https://lk.parceltracking.app에서 Packy 계정에 로그인합니다.
연결된 애플리케이션을 엽니다.
애플리케이션을 선택하고 연결 해제 / 취소를 선택합니다.

애플리케이션을 취소하면 해당 OAuth 연결에서 새 요청이 중지됩니다. API 키 자체는 비활성화되지 않으며, 동일한 키에 연결된 다른 애플리케이션은 독립적으로 유지됩니다.

API 키 섹션에서 API 키를 비활성화하거나 교체할 수도 있습니다. 이는 해당 키를 사용하는 모든 통합(MCP 애플리케이션 포함)에 영향을 줍니다.

서비스 확인

다음 공개 라이브니스 엔드포인트는 API 키가 필요하지 않습니다:

curl -fsS https://mcp.parceltracking.app/health
curl -fsS https://mcp.parceltracking.app/ready

예상 응답:

{"status":"ok"}

{"status":"ok","checks":{"api_gateway":"healthy"}}

/ready은 MCP 서비스가 API 게이트웨이에 도달할 수 있는지도 확인합니다.

문제 해결

도구가 표시되지 않으면 엔드포인트를 확인하고 서버 이름 packy-tracking-mcp을 사용한 후 클라이언트를 다시 시작하세요.
OAuth가 완료되지 않으면 의도한 Packy 계정에 로그인하고 활성 API 키가 있는지 확인한 후 새 연결 시도를 시작하세요.
액세스가 거부되면 선택한 키가 활성 상태이고 의도한 계정에 속하는지 확인하세요.
액세스를 즉시 중지해야 하면 연결된 애플리케이션에서 애플리케이션을 연결 해제하거나 API 키를 비활성화하세요.

링크

Packy 웹사이트: https://packyapp.com
Packy 계정: https://lk.parceltracking.app
MCP 엔드포인트: https://mcp.parceltracking.app/mcp

지원

계정 및 지원 요청은 wasup@clickor.net로 이메일을 보내주세요.

Tracking API 및 MCP 통합에 대한 기술 문의는 Packy Developer Community on Discord에 가입하세요. 모든 공식 연락처 옵션은 https://packyapp.com/contacts에서 확인할 수 있습니다.

저장소 범위

이 저장소에는 통합 문서만 포함되어 있습니다. Packy API 소스 코드, 자격 증명, API 키, OAuth 토큰 또는 배포 구성은 포함되어 있지 않습니다.