密钥与店铺权限
能用 OAuth 登录就用 OAuth，必须用密钥时再用密钥——并精确决定每个密钥能碰哪些店铺、能做哪些操作。
大多数 AI 客户端在浏览器里登录，你根本不会看到密钥。密钥用于无法打开浏览器的客户端（扣子、服务器、无界面智能体），以及你自己的代码。
两种密钥
| 类型 | 用途 | 在哪里有效 |
|---|---|---|
| MCP key | AI 客户端——Claude、Cursor、ChatGPT、扣子等 | 只在 https://sellersheetai.com/mcp |
| API key | 你自己的脚本和页面——Tool API，抢先体验 | 只在 Tool API |
Tool API 拒绝 MCP key，MCP 服务器拒绝 API key，都返回 401。每次浏览器登录都会为该客户端创建一个 MCP key，所以它也出现在同一个列表里。
创建密钥
打开密钥列表
在应用里：Settings → API & MCP → Create key。
按使用位置命名
“我笔记本上的 Claude”“代运营团队”“报表服务器”。笔记本丢了或密钥泄露时，名字告诉你该关掉哪一个。
选择范围
All my workspaces 覆盖你所属的每个工作区里你能访问的所有店铺，包括别人共享给你的店铺。⟨工作区⟩ only 只覆盖该工作区的店铺。范围在创建时确定——要改就新建一个密钥。
选择店铺和权限
Open——密钥范围内的所有店铺。Restricted——只限你列出的店铺和站点。每一项都设置 Seller API 和 Ads API 权限：无、只读、读写。只读密钥可以分析一切，但不能提交 Feed、创建货件或修改竞价——适合作为日常密钥，另配一个需要时才用的写入密钥。
复制并连接
立即复制令牌，像密码一样保管——持有它的人就能以你的身份操作。密钥那一行的 Snippets 会为每个 AI 客户端生成填好密钥的现成配置。Last used 显示密钥是否还在被使用；在同一个列表里关闭或删除密钥，所有使用它的客户端立即失效。
每种密钥能建多少个由套餐决定。密钥永远不会超出你本人能访问的范围；在别人共享给你的店铺上，它最多只有所有者授予你的权限。
AI 如何知道自己的权限
每次会话都从 get_user_context 开始。它的结果告诉 AI 能访问哪些店铺（带 store_refs）以及在每个店铺上能做什么——所以 AI 能在尝试会被拒绝的改动之前就告诉你。
别让密钥露出来
- 把密钥放在环境变量（
SELLERSHEET_API_KEY）或已列入.gitignore的.env文件里——不要写进代码、共享文档或命令行。 - 你在聊天里把密钥交给 AI 时，它可以帮你写进
.env，但不能回显，也不能提交到代码库。 - 怀疑泄露？在 Settings → API & MCP 关闭该密钥，再新建一个。