Packy Tracking MCP

官方

多承運商包裹追蹤

GitHub

你可以用 Packy Tracking MCP 做什麼？

建立追蹤 — 透過 trackings_create 要求註冊新的貨件，包括批次追蹤號碼，以開始監控包裹。
列出與查詢追蹤 — 使用 trackings_list 和 trackings_get 查看所有貨件，或擷取特定追蹤 ID 的詳細資訊。
管理 Webhook — 使用 webhooks_create、webhooks_update、webhooks_list 和 webhooks_delete 建立、更新、列出或刪除 Webhook 端點，以接收事件通知。
列出支援的物流業者 — 查詢 couriers_list 以查看您帳戶可用的運送承運商。
自動偵測物流業者 — 使用 courier_detections_create 從追蹤號碼識別承運商。
刪除追蹤 — 透過 trackings_delete 移除不需要的貨件記錄，以清理您的追蹤清單。

文件

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 Settings → Connectors → Add custom connector。
輸入 MCP 端點：
```
https://mcp.parceltracking.app/mcp
```
保持啟用 OAuth 驗證，並允許 Claude 自動註冊用戶端。
在瀏覽器中登入 Packy。簡短的 Continue authorization 頁面會自動重新導向，無需點擊任何內容。該連結為一次性使用，兩分鐘後過期。
在 Allow access? 頁面上，選擇此連線將使用的有效 API 金鑰，然後選擇 Allow。
返回 Claude，確認連接器已連接。

OAuth 存取權杖的有效期較短，且會自動重新整理。如果流程失敗，請從 Claude 重新開始新的連線嘗試，而不要重新開啟先前的授權 URL。

搭配 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 金鑰，然後選擇 Allow。

搭配 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>

建議使用 OAuth 流程，因為金鑰是在 Packy 中選取，不會複製到用戶端設定中。

工具

工具	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 會消耗額度：每個唯一的追蹤編號消耗一個額度，包括批次中的每個追蹤編號。貨運業者、偵測、讀取、刪除和 webhook 工具不會消耗額度。MCP 不會與 Tracking API 分開計費。

中斷連線與撤銷

若要停止某個 MCP 應用程式：

在 https://lk.parceltracking.app 登入 Packy 帳戶。
開啟 Connected applications。
選擇該應用程式，然後選擇 Disconnect／Revoke。

撤銷應用程式會停止來自該 OAuth 連線的新請求。這不會停用 API 金鑰本身，且連接到同一金鑰的其他應用程式仍保持獨立運作。

您也可以在 API keys 區段中停用或更換 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 金鑰，然後開始新的連線嘗試。
如果存取被拒絕，請確認所選的金鑰為啟用狀態，且屬於預期的帳戶。
如果需要立即停止存取，請在 Connected applications 中中斷應用程式的連線，或停用 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 權杖或部署設定。