只读、写入与破坏性
每个工具带一个权限标签,随工具一起下发——写权限按店铺、按接口授予。
三种标签
| 标签 | 含义 | 示例 |
|---|---|---|
| read | 只读——不做任何改动 | orders_searchOrders、query_report_data、fbaInbound_listPlacementOptions |
| write | 创建或修改某些内容 | fbaInbound_createInboundPlan、generate_image、append_sheet_rows |
| destructive | 修改或删除无法简单撤回的内容 | listings_putListingsItem、fbaInbound_confirm_plan_options、ads_update_target_bid |
标签是工具本身的一部分,不是这个页面写上去的:MCP 服务器随每个工具下发它(以客户端都能理解的标准只读、破坏性提示的形式),Tool API 的目录和 OpenAPI 以 access 字段携带它。工具参考显示每个工具的标签。
- 没有工具既读又写。 “看一看”的请求绝不会意外改动什么。
- 报表和导出请求属于读取。 让亚马逊准备报表,或创建 Data Kiosk 查询,都不会改动你的卖家账户。
- 写入表格、文档或 Drive 也算写入——写的是你的文件,不是亚马逊。
写权限按店铺、按接口授予
标签说明工具做什么;权限说明你能不能做。会改动亚马逊账户的工具,在调用亚马逊之前会检查:
- 该店铺的 Seller API 写权限,用于 SP-API 改动——Feed、Listing、FBA 计划和货件、A+ 发布、供应商提交。
- 该店铺的 Ads API 写权限,用于广告改动——广告活动、投放、竞价、预算。
- 该 noon 账号的 noon 写权限,用于对它的改动。
你的密钥权限,以及在共享工作区里所有者或管理员授予你的权限,两者同时生效——以较低者为准。没有权限时,调用会被拒绝(403),不会有任何请求到达亚马逊。如何设置:密钥与店铺权限、掌控你的 AI。
破坏性操作前先确认
破坏性工具会替换在售的 Listing、确认计划或修改竞价。AI 会先展示将要发送的内容并等待你确认;你自己的代码也应该这样——写入应该是因为有人按了按钮。