新品发布|BestUpsell 上线,帮助 Shopify 商家提升客单价和订单转化。探索 BestUpsell →
← 返回 MCP 接入方式
API Key · BestTrack MCP

使用 API Key 连接 BestTrack MCP

让 AI 客户端只读访问当前店铺获准使用的物流数据。

适用对象适用于支持远程 HTTP MCP 和自定义请求头的客户端。你需要能够进入 BestTrack Admin。

1. 创建只读 Key

在 BestTrack Admin 打开 MCP 集成,创建 Key,并只选择物流查询所需的只读权限。

BestTrack Admin 集成页,高亮 MCP Server 卡片和 Connect 按钮
从集成页打开 BestTrack MCP Server在 BestTrack Admin 打开 Integrations,并在 BestTrack MCP Server 卡片上点击 Connect。
BestTrack MCP Server 页面,高亮 Create API Key 按钮
创建 API Key在 BestTrack MCP Server 页面点击 Create API Key。

2. 当场复制并保存 Key

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

API Key 创建弹窗,展示一次性显示提示和复制按钮;Key 值已遮盖
在 Key 显示时立即复制截图展示一次性显示提示,Key 值已遮盖。

3. 复制 MCP Server URL

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

BestTrack MCP Server 页面,高亮 Copy URL 按钮
复制当前 MCP Server URL在 BestTrack MCP Server 页面点击 Copy URL。

4. 配置 AI 客户端

在支持自定义请求头的客户端添加远程 HTTP MCP Server,填入从 Admin 复制的 URL,并添加以下 Authorization 请求头:

Authorization: Bearer <YOUR_API_KEY>

不同客户端的配置格式可能不同。这一行仅表示所需请求头,并非完整的客户端配置文件。

AI 客户端的 MCP 设置,展示 Streamable HTTP、Server URL 和使用占位 Key 的 Authorization 请求头
客户端配置示例此示例展示 Streamable HTTP 和 Authorization 请求头。请从 Admin 复制你自己的 URL;其他客户端的配置方式可能不同。

5. 确认连接成功

让客户端查询一条在当前店铺 BestTrack Admin 中也能找到的物流记录,并核对返回结果确实属于当前店铺。确认后再用于其他查询。

6. 轮换、撤销或更换 Key

轮换 Key 时,先创建新 Key,更新所有使用旧值的客户端并验证物流查询,再在 Admin 撤销旧 Key。被撤销的 Key 必须在客户端替换后才能重新连接。

如果 Key 可能泄露,请尽快在 Admin 撤销它、创建替代 Key、更新受影响的客户端;如果 Admin 提供使用记录,也请检查近期使用情况。

常见问题
客户端无法设置自定义请求头怎么办?

请改用支持自定义请求头的客户端;如果客户端支持 MCP OAuth,也可以查看 OAuth 指南。

撤销 Key 后查询失败,原因是什么?

客户端可能仍在使用已撤销的值。创建新 Key、更新客户端配置,然后重新查询。