# Codex (https://sellersheetai.com/zh/docs/start/clients/codex)

> 在 Codex 里安装 SellerSheet 插件，或用 codex mcp add 手动添加 MCP 服务器——用 codex mcp login 登录。



用插件（技能和服务器一起装）或手动把 SellerSheet 加到 Codex。

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

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

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

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

## 第 2 步：在 Codex 中添加 SellerSheet [#第-2-步在-codex-中添加-sellersheet]

插件（技能和服务器一起装）：

```bash
codex plugin marketplace add sellersheetai/sellersheet-skills
codex plugin add sellersheet-skills@sellersheet-marketplace
codex mcp login sellersheet
```

手动添加：

```bash
codex mcp add sellersheet --url https://sellersheetai.com/mcp
codex mcp login sellersheet
```

用密钥时，`~/.codex/config.toml` 的字段是 `http_headers`（不是 `headers`）：

```toml title="~/.codex/config.toml"
[mcp_servers.sellersheet]
url = "https://sellersheetai.com/mcp"
http_headers = { "Authorization" = "Bearer <你的密钥>" }
```

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

1. `codex mcp login 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)。