Packy Tracking MCP

官方

多承运商包裹追踪

GitHub

你可以用 Packy Tracking MCP 做什么？

创建追踪 — 通过 trackings_create 请求注册新货件，包括批量追踪号码，以开始监控包裹。
列出和检索追踪 — 使用 trackings_list 和 trackings_get 查看所有货件或获取特定追踪 ID 的详细信息。
管理 Webhooks — 使用 webhooks_create、webhooks_update、webhooks_list 和 webhooks_delete 创建、更新、列出或删除 Webhook 端点，用于事件通知。
列出支持的快递公司 — 查询 couriers_list 以查看您账户可用的运输承运商。
自动检测快递公司 — 使用 courier_detections_create 从追踪号码识别承运商。
删除追踪 — 通过 trackings_delete 删除不需要的货件记录，以清理您的追踪列表。

文档

Packy Tracking MCP

Packy Tracking MCP 通过模型上下文协议（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 密钥。该密钥与常规 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 集成的技术问题，请加入 Packy 开发者社区 Discord。所有官方联系方式可在 https://packyapp.com/contacts 获取。

仓库范围

本仓库仅包含集成文档。不包含 Packy API 源代码、凭据、API 密钥、OAuth 令牌或部署配置。