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

  • A SellerSheet account with a connected store — Connect your store.
  • The ChatGPT desktop app, or the Codex CLI.

Step 1: Copy the SellerSheet MCP URL

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

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:

    sellersheetai/sellersheet-skills
  3. Select + (Install plugin) on the SellerSheet plugin.

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

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):

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

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

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

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 myStore-US, with your plan and each store's status. Every session should start there.

Troubleshooting

"Unauthorized" (401)

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

The browser never opens

Update the client — older versions don't support MCP sign-in — or use an API key.

"No stores"

Connect a store first: Connect your store.

Tools time out

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

More in Troubleshooting. Next: Install the skills, or try the prompt library.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude