AI 客户端与 API
每一种拒绝都会说明出了什么问题、该怎么做。这里列出每一种情况及其解决办法。
每次拒绝都在 notification.message 里带一句说明——AI 会读给你听——如果只有你能处理，还会在 human_action 里附上提示。HTTP 状态码说明属于哪一类（返回与错误）。
登录
| 现象 | 含义 | 处理 |
|---|---|---|
| “Unauthorized”（401） | 登录或密钥缺失、过期、被关闭或删除——或者类型不对（在 Tool API 用了 MCP key，或反过来） | 在客户端里重新登录，或在 Settings → API & MCP 新建密钥 |
| 浏览器始终不打开 | 客户端版本早于 MCP 登录支持 | 升级客户端，或改用 API key |
| 登录提示密钥已达上限 | 每次浏览器登录都会创建一个 MCP key，套餐的密钥额度已用完 | 在 Settings → API & MCP 删除不用的密钥，或升级套餐 |
| 以前能用的密钥返回 403 | 你已不是该密钥所属工作区的活跃成员 | 联系工作区所有者，或使用你自己的密钥 |
店铺
| 现象 | 含义 | 处理 |
|---|---|---|
| 店铺标识被拒绝（400） | 标识没有站点，例如只写了 myStore | 传入带站点的标识，例如 myStore-US。错误信息会列出所有可用的标识——或者从 get_user_context 取一个（店铺标识） |
| “Store is paused”（403） | 该店铺没有任何站点在你的套餐上激活 | 升级套餐，或在 My Stores → Edit Marketplaces 腾出名额（应用里是 Settings → Stores & Marketplaces → Edit markets） |
| “没有店铺” | 还没有连接店铺，也没有人共享店铺给你 | 连接店铺 |
| 广告工具返回空结果 | 该店铺没有授权广告 | 在 Settings → Stores & Marketplaces 的店铺那一行点 Ads |
| 店铺显示授权错误 | 亚马逊授权已被撤销或过期 | 在店铺那一行点 Reauthorize on Amazon |
权限
| 现象 | 含义 | 处理 |
|---|---|---|
| 写入类工具返回 403 | 密钥或你的成员身份在该店铺上只有读权限 | 使用在该店铺有写权限的密钥，或请工作区所有者授予（掌控你的 AI） |
| 应用里能看到的店铺返回 403 | 密钥是 Restricted，列表里没有该店铺；或者它的范围只有一个工作区 | 把店铺加到密钥里，或换一个密钥 |
限额与亚马逊
| 现象 | 含义 | 处理 |
|---|---|---|
429 并带 Retry-After | 套餐窗口已满，或亚马逊对该操作的配额已满 | 等待 Retry-After 指定的秒数后重试（Credits 与限额） |
| 402 | Credits 不足以执行图片、文案或洞察操作 | 在 Settings → Billing & Credits 充值——没有任何扣费 |
| 400 并带亚马逊的错误 | 亚马逊拒绝了请求——属性不对、缺少字段 | 查看 errors：那是亚马逊自己的错误列表；修正输入后重新发送 |
| 503 | 亚马逊、noon 或 SellerSheet 当时无法响应 | 按 Retry-After 重试 |
| 调用超时 | 有些亚马逊报表需要一两分钟 | 调大客户端的 MCP 工具超时；用 Tool API 时，把耗时长的流程改走 MCP |
表格
| 现象 | 处理 |
|---|---|
| AI 不能写入你的表格 | 打开 Google 表格 → Extensions → SellerSheet → Open Sidebar 一次，完成工作区设置 |
| 提示文件“不属于你” | Drive 和表格工具只能操作你工作区内、你拥有或共享给你的文件——把文件共享给你的 Google 账号 |
还没解决？发邮件到 [email protected]，附上调用的时间。