# AI 客户端与 API (https://sellersheetai.com/zh/help/troubleshooting/ai)

> 每一种拒绝都会说明出了什么问题、该怎么做。这里列出每一种情况及其解决办法。



每次拒绝都在 `notification.message` 里带一句说明——AI 会读给你听——如果只有你能处理，还会在 `human_action` 里附上提示。HTTP 状态码说明属于哪一类（[返回与错误](/zh/docs/mcp-api/responses)）。

## 登录 [#登录]

| 现象                  | 含义                                                    | 处理                                         |
| ------------------- | ----------------------------------------------------- | ------------------------------------------ |
| “Unauthorized”（401） | 登录或密钥缺失、过期、被关闭或删除——或者类型不对（在 Tool API 用了 MCP key，或反过来） | 在客户端里重新登录，或在 **Settings → API & MCP** 新建密钥 |
| 浏览器始终不打开            | 客户端版本早于 MCP 登录支持                                      | 升级客户端，或改用 [API key](/zh/docs/mcp-api/keys) |
| 登录提示密钥已达上限          | 每次浏览器登录都会创建一个 MCP key，套餐的密钥额度已用完                      | 在 **Settings → API & MCP** 删除不用的密钥，或升级套餐   |
| 以前能用的密钥返回 403       | 你已不是该密钥所属工作区的活跃成员                                     | 联系工作区所有者，或使用你自己的密钥                         |

## 店铺 [#店铺]

| 现象                     | 含义                     | 处理                                                                                                       |
| ---------------------- | ---------------------- | -------------------------------------------------------------------------------------------------------- |
| 店铺标识被拒绝（400）           | 标识没有站点，例如只写了 `myStore` | 传入带站点的标识，例如 <StoreRef />。错误信息会列出所有可用的标识——或者从 `get_user_context` 取一个（[店铺标识](/zh/docs/mcp-api/store-refs)） |
| “Store is paused”（403） | 该店铺没有任何站点在你的套餐上激活      | 升级套餐，或在 **My Stores → Edit Marketplaces** 腾出名额（应用里是 **Settings → Stores & Marketplaces → Edit markets**） |
| “没有店铺”                 | 还没有连接店铺，也没有人共享店铺给你     | [连接店铺](/zh/docs/start/connect)                                                                           |
| 广告工具返回空结果              | 该店铺没有授权广告              | 在 **Settings → Stores & Marketplaces** 的店铺那一行点 **Ads**                                                   |
| 店铺显示授权错误               | 亚马逊授权已被撤销或过期           | 在店铺那一行点 **Reauthorize on Amazon**                                                                        |

## 权限 [#权限]

| 现象              | 含义                                        | 处理                                                            |
| --------------- | ----------------------------------------- | ------------------------------------------------------------- |
| 写入类工具返回 403     | 密钥或你的成员身份在该店铺上只有读权限                       | 使用在该店铺有写权限的密钥，或请工作区所有者授予（[掌控你的 AI](/zh/docs/mcp-api/control)） |
| 应用里能看到的店铺返回 403 | 密钥是 **Restricted**，列表里没有该店铺；或者它的范围只有一个工作区 | 把店铺加到密钥里，或换一个密钥                                               |

## 限额与亚马逊 [#限额与亚马逊]

| 现象                   | 含义                            | 处理                                                                      |
| -------------------- | ----------------------------- | ----------------------------------------------------------------------- |
| 429 并带 `Retry-After` | 套餐窗口已满，或亚马逊对该操作的配额已满          | 等待 `Retry-After` 指定的秒数后重试（[Credits 与限额](/zh/help/app/settings/billing)） |
| 402                  | Credits 不足以执行图片、文案或洞察操作       | 在 **Settings → Billing & Credits** 充值——没有任何扣费                           |
| 400 并带亚马逊的错误         | 亚马逊拒绝了请求——属性不对、缺少字段           | 查看 `errors`：那是亚马逊自己的错误列表；修正输入后重新发送                                      |
| 503                  | 亚马逊、noon 或 SellerSheet 当时无法响应 | 按 `Retry-After` 重试                                                      |
| 调用超时                 | 有些亚马逊报表需要一两分钟                 | 调大客户端的 MCP 工具超时；用 Tool API 时，把耗时长的流程改走 MCP                              |

## 表格 [#表格]

| 现象          | 处理                                                                    |
| ----------- | --------------------------------------------------------------------- |
| AI 不能写入你的表格 | 打开 Google 表格 → **Extensions → SellerSheet → Open Sidebar** 一次，完成工作区设置 |
| 提示文件“不属于你”  | Drive 和表格工具只能操作你工作区内、你拥有或共享给你的文件——把文件共享给你的 Google 账号                  |

还没解决？发邮件到 [support@sellersheetai.com](mailto:support@sellersheetai.com)，附上调用的时间。
