使用 API Key 连接 BestTrack MCP
让 AI 客户端只读访问当前店铺获准使用的物流数据。
适用对象适用于支持远程 HTTP MCP 和自定义请求头的客户端。你需要能够进入 BestTrack Admin。
1. 创建只读 Key
在 BestTrack Admin 打开 MCP 集成,创建 Key,并只选择物流查询所需的只读权限。


2. 当场复制并保存 Key
完整 Key 只显示一次。创建后请立即复制并安全保存;如果丢失,需要创建新 Key 并更新客户端配置。

3. 复制 MCP Server URL
从 BestTrack Admin 复制当前环境的 MCP Server URL,并在客户端使用该地址;不要复制其他店铺或环境的地址。

4. 配置 AI 客户端
在支持自定义请求头的客户端添加远程 HTTP MCP Server,填入从 Admin 复制的 URL,并添加以下 Authorization 请求头:
Authorization: Bearer <YOUR_API_KEY>不同客户端的配置格式可能不同。这一行仅表示所需请求头,并非完整的客户端配置文件。

5. 确认连接成功
让客户端查询一条在当前店铺 BestTrack Admin 中也能找到的物流记录,并核对返回结果确实属于当前店铺。确认后再用于其他查询。
6. 轮换、撤销或更换 Key
轮换 Key 时,先创建新 Key,更新所有使用旧值的客户端并验证物流查询,再在 Admin 撤销旧 Key。被撤销的 Key 必须在客户端替换后才能重新连接。
如果 Key 可能泄露,请尽快在 Admin 撤销它、创建替代 Key、更新受影响的客户端;如果 Admin 提供使用记录,也请检查近期使用情况。
客户端无法设置自定义请求头怎么办?
请改用支持自定义请求头的客户端;如果客户端支持 MCP OAuth,也可以查看 OAuth 指南。
撤销 Key 后查询失败,原因是什么?
客户端可能仍在使用已撤销的值。创建新 Key、更新客户端配置,然后重新查询。