Packy Tracking MCP

官方

多承運商包裹追蹤

GitHub試用此 MCP贊助

你可以用 Packy Tracking MCP 做什麼？

建立追蹤 — 透過 trackings_create 要求註冊新的貨件，包括批次追蹤號碼，以開始監控配送。
列出與檢視追蹤 — 使用 trackings_list 和 trackings_get 查看所有貨件，或擷取特定追蹤 ID 的詳細資訊。
管理 Webhook — 使用 webhooks_create、webhooks_update、webhooks_list 和 webhooks_delete 建立、更新、列出或刪除 Webhook 端點，以接收配送事件通知。
偵測物流商 — 使用 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。簡短的 繼續授權 頁面會自動重新導向；無需點擊任何內容。該連結為一次性使用，並在兩分鐘後過期。
在 允許存取？ 頁面上，選擇此連線將使用的有效 API 金鑰，然後選擇允許。
返回 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 金鑰，然後選擇允許。

使用 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 帳戶。
開啟 已連接的應用程式。
選擇應用程式並選擇 中斷連線 / 撤銷。

撤銷應用程式會停止來自該 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 整合的技術問題，請加入 Discord 上的 Packy 開發者社群。所有官方聯絡方式可在 https://packyapp.com/contacts 取得。

儲存庫範圍

此儲存庫僅包含整合文件。它不包含 Packy API 原始碼、憑證、API 金鑰、OAuth 權杖或部署設定。