# Claude Code (https://sellersheetai.com/zh/docs/start/clients/claude-code)

> 一条命令把 SellerSheet MCP 服务器加到 Claude Code，用 /mcp 登录——或在 .mcp.json 里引用 API key。



在终端里把 SellerSheet 加到 Claude Code，再在会话里登录。

## 准备工作 [#准备工作]

* 一个已连接店铺的 SellerSheet 账号——见[连接店铺](/zh/docs/start/connect)。
* 已安装 Claude Code。

<Callout title="更推荐：装插件">
  SellerSheet 插件一步装好技能**和** MCP 服务器——见[安装技能](/zh/docs/start/skills)。下面是手动添加服务器的步骤。
</Callout>

## 第 1 步：复制 SellerSheet MCP 地址 [#第-1-步复制-sellersheet-mcp-地址]

```text
https://sellersheetai.com/mcp
```

## 第 2 步：在 Claude Code 中添加 SellerSheet [#第-2-步在-claude-code-中添加-sellersheet]

添加服务器：

```bash
claude mcp add --transport http sellersheet https://sellersheetai.com/mcp
```

**这台机器没有浏览器？** 用 [API key](/zh/docs/mcp-api/keys)：把它放在环境变量里，在 `.mcp.json` 中引用——不要把密钥粘贴在命令行上。

```json title=".mcp.json"
{
  "mcpServers": {
    "sellersheet": {
      "type": "http",
      "url": "https://sellersheetai.com/mcp",
      "headers": { "Authorization": "Bearer ${SELLERSHEET_API_KEY}" }
    }
  }
}
```

## 第 3 步：登录并测试 [#第-3-步登录并测试]

1. 启动 Claude Code，运行 `/mcp`，选择 `sellersheet`，在浏览器里登录。
2. 问：“你能看到哪些店铺？” AI 会调用 `get_user_context`，列出你的店铺标识（例如 <StoreRef />）、套餐和每个店铺的状态。每次会话都应该从这里开始。

## 常见问题 [#常见问题]

### “Unauthorized”（401） [#unauthorized401]

登录或密钥已过期或被删除。重新登录，或新建一个密钥。

### 浏览器始终不打开 [#浏览器始终不打开]

升级客户端——旧版本不支持 MCP 登录——或改用 [API key](/zh/docs/mcp-api/keys)。

### “没有店铺” [#没有店铺]

先连接店铺：[连接店铺](/zh/docs/start/connect)。

### 工具调用超时 [#工具调用超时]

有些亚马逊报表需要一两分钟。调大客户端的 MCP 工具超时时间。

更多见[故障排查](/zh/help/troubleshooting/ai)。下一步：[安装技能](/zh/docs/start/skills)，或[试试提示词库](/zh/docs/start/prompts)。