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

仓库范围

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