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

> 在 Claude Code 里安装 SellerSheet 插件——技能和 MCP 服务器一起装好——或手动添加服务器；用 /mcp 登录。



用插件（技能和服务器一起装）或手动把 SellerSheet 加到 Claude Code，再在会话里登录。

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

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

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

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

装插件时用不到它：插件自带服务器。只有手动添加服务器时才需要。

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

插件（技能和服务器一起装）。在 Claude Code 会话里先把 GitHub 仓库添加为插件市场，再从中安装插件：

```text
/plugin marketplace add sellersheetai/sellersheet-skills
/plugin install sellersheet-skills@sellersheet-marketplace
```

安装时选择范围——一般选为自己在所有项目中安装。

手动添加（只有服务器，没有技能）：

```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. 运行 `/mcp`，选择 `sellersheet`，在浏览器里登录——点「允许」。
2. 问：“你能看到哪些店铺？” AI 会调用 `get_user_context`，列出你的店铺标识（例如 <StoreRef />）、套餐和每个店铺的状态。每次会话都应该从这里开始。

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

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

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

### 装好后看不到技能或服务器 [#装好后看不到技能或服务器]

运行 `/reload-plugins`，或重启 Claude Code。第三方插件市场不会自动更新：在 `/plugin` 里打开 **Marketplaces**，选中 `sellersheet-marketplace`，选择 **Enable auto-update**。

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

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

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

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

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