只读、写入与破坏性

每个工具带一个权限标签,随工具一起下发——写权限按店铺、按接口授予。

三种标签

标签含义示例
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 会先展示将要发送的内容并等待你确认;你自己的代码也应该这样——写入应该是因为有人按了按钮。

本页内容

操作

查看 Markdown

询问助手

问 ChatGPT问 Claude