# 密钥与店铺权限 (https://sellersheetai.com/zh/docs/mcp-api/keys)

> 能用 OAuth 登录就用 OAuth，必须用密钥时再用密钥——并精确决定每个密钥能碰哪些店铺、能做哪些操作。



大多数 AI 客户端在浏览器里登录，你根本不会看到密钥。密钥用于无法打开浏览器的客户端（扣子、服务器、无界面智能体），以及你自己的代码。

## 两种密钥 [#两种密钥]

| 类型          | 用途                                                | 在哪里有效                              |
| ----------- | ------------------------------------------------- | ---------------------------------- |
| **MCP key** | AI 客户端——Claude、Cursor、ChatGPT、扣子等                 | 只在 `https://sellersheetai.com/mcp` |
| **API key** | 你自己的脚本和页面——[Tool API](/zh/docs/mcp-api/code)，抢先体验 | 只在 Tool API                        |

Tool API 拒绝 MCP key，MCP 服务器拒绝 API key，都返回 401。每次浏览器登录都会为该客户端创建一个 MCP key，所以它也出现在同一个列表里。

## 创建密钥 [#创建密钥]

<Steps>
  <Step>
    ### 打开密钥列表 [#打开密钥列表]

    在应用里：**Settings → API & MCP → Create key**。
  </Step>

  <Step>
    ### 按使用位置命名 [#按使用位置命名]

    “我笔记本上的 Claude”“代运营团队”“报表服务器”。笔记本丢了或密钥泄露时，名字告诉你该关掉哪一个。
  </Step>

  <Step>
    ### 选择范围 [#选择范围]

    **All my workspaces** 覆盖你所属的每个工作区里你能访问的所有店铺，包括别人共享给你的店铺。**⟨工作区⟩ only** 只覆盖该工作区的店铺。范围在创建时确定——要改就新建一个密钥。
  </Step>

  <Step>
    ### 选择店铺和权限 [#选择店铺和权限]

    **Open**——密钥范围内的所有店铺。**Restricted**——只限你列出的店铺和站点。每一项都设置 **Seller API** 和 **Ads API** 权限：无、只读、读写。只读密钥可以分析一切，但不能提交 Feed、创建货件或修改竞价——适合作为日常密钥，另配一个需要时才用的写入密钥。
  </Step>

  <Step>
    ### 复制并连接 [#复制并连接]

    立即复制令牌，像密码一样保管——持有它的人就能以你的身份操作。密钥那一行的 **Snippets** 会为每个 AI 客户端生成填好密钥的现成配置。**Last used** 显示密钥是否还在被使用；在同一个列表里关闭或删除密钥，所有使用它的客户端立即失效。
  </Step>
</Steps>

每种密钥能建多少个由套餐决定。密钥永远不会超出你本人能访问的范围；在别人共享给你的店铺上，它最多只有所有者授予你的权限。

## AI 如何知道自己的权限 [#ai-如何知道自己的权限]

每次会话都从 `get_user_context` 开始。它的结果告诉 AI 能访问哪些店铺（带 `store_refs`）以及在每个店铺上能做什么——所以 AI 能在尝试会被拒绝的改动**之前**就告诉你。

## 别让密钥露出来 [#别让密钥露出来]

* 把密钥放在环境变量（`SELLERSHEET_API_KEY`）或已列入 `.gitignore` 的 `.env` 文件里——不要写进代码、共享文档或命令行。
* 你在聊天里把密钥交给 AI 时，它可以帮你写进 `.env`，但不能回显，也不能提交到代码库。
* 怀疑泄露？在 **Settings → API & MCP** 关闭该密钥，再新建一个。

相关：[店铺标识](/zh/docs/mcp-api/store-refs) · [掌控你的 AI](/zh/docs/mcp-api/control) · [故障排查](/zh/help/troubleshooting/ai)。