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

> Install the SellerSheet plugin in the ChatGPT desktop app, where Codex runs, or with the Codex CLI — the skills and the MCP server together — then connect with a browser sign-in.



Codex runs inside the ChatGPT desktop app, so that's where you add SellerSheet: the plugin brings the skills **and** the MCP server in one step. Prefer the terminal? The Codex CLI installs the same plugin.

## Prerequisites [#prerequisites]

* A SellerSheet account with a connected store — [Connect your store](/docs/start/connect).
* The ChatGPT desktop app, or the Codex CLI.

## Step 1: Copy the SellerSheet MCP URL [#step-1-copy-the-sellersheet-mcp-url]

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

You won't paste it for the plugin: the plugin carries the server. You need it only to add the server by hand.

## Step 2: Add SellerSheet in Codex [#step-2-add-sellersheet-in-codex]

In the ChatGPT desktop app, add the GitHub repository as a marketplace, then install the plugin from it:

1. Open **Plugins → Add → Add a marketplace**.

2. Enter the repository as **Source**, leave the other fields empty and select **Add marketplace**:

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

3. Select **+** (**Install plugin**) on the **SellerSheet** plugin.

**With the Codex CLI instead** — the same plugin, then sign in:

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

**By hand in the CLI** (the server without the skills):

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

With a key, `~/.codex/config.toml` takes `http_headers` (not `headers`):

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

## Step 3: Sign in and test [#step-3-sign-in-and-test]

1. In the desktop app, connect SellerSheet when prompted: your browser opens SellerSheet; click **Allow**, then start a new chat. In the CLI, `codex mcp login sellersheet` — the last command of either set above — signs you in in the browser.
2. Ask: "Which stores can you see?" Your agent calls `get_user_context` and lists your store refs, such as <StoreRef />, with your plan and each store's status. Every session should start there.

## Troubleshooting [#troubleshooting]

### "Unauthorized" (401) [#unauthorized-401]

Your sign-in or key expired or was deleted. Sign in again, or create a new key.

### The browser never opens [#the-browser-never-opens]

Update the client — older versions don't support MCP sign-in — or use an [API key](/docs/mcp-api/keys).

### "No stores" [#no-stores]

Connect a store first: [Connect your store](/docs/start/connect).

### Tools time out [#tools-time-out]

Some Amazon reports take a minute or two. Raise your client's MCP tool timeout.

More in [Troubleshooting](/help/troubleshooting/ai). Next: [Install the skills](/docs/start/skills), or [try the prompt library](/docs/start/prompts).
