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

> 在 ChatGPT 桌面版（Codex 就在其中）或 Codex 命令行里安装 SellerSheet 插件——技能和 MCP 服务器一起装好——再用浏览器登录连接。



Codex 就在 ChatGPT 桌面版里，所以在桌面版添加 SellerSheet 即可：插件一步装好技能**和** MCP 服务器。习惯用终端的话，Codex 命令行装的是同一个插件。

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

* 一个已连接店铺的 SellerSheet 账号——见[连接店铺](/zh/docs/start/connect)。
* ChatGPT 桌面版，或 Codex 命令行。

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

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

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

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

在 ChatGPT 桌面版里，先把 GitHub 仓库添加为插件市场，再从中安装插件：

1. 打开 **插件 → 添加 → 添加插件市场**。

2. 在 **来源** 里填入仓库，其他项留空，点 **添加市场**：

   ```text
   sellersheetai/sellersheet-skills
   ```

3. 在 **SellerSheet** 插件上点 **+**（**安装插件**）。

**用 Codex 命令行**——同一个插件，装好后登录：

```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. 桌面版会提示连接 SellerSheet：浏览器打开 SellerSheet，点「允许」，然后新建一个对话。命令行则用 `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)。