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

> Add the SellerSheet MCP server to Claude Code with one command and sign in with /mcp — or reference an API key from .mcp.json.



Add SellerSheet to Claude Code from the terminal, then sign in from inside a session.

## Prerequisites [#prerequisites]

* A SellerSheet account with a connected store — [Connect your store](/docs/start/connect).
* Claude Code installed.

<Callout title="Prefer the plugin">
  The SellerSheet plugin adds the skills **and** the MCP server in one step — see [Install the skills](/docs/start/skills). The steps below set up the server by hand.
</Callout>

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

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

## Step 2: Add SellerSheet in Claude Code [#step-2-add-sellersheet-in-claude-code]

Add the server:

```bash
claude mcp add --transport http sellersheet https://sellersheetai.com/mcp
```

**No browser on this machine?** Use an [API key](/docs/mcp-api/keys): keep it in an environment variable and reference it from `.mcp.json` — never paste the key on the command line.

```json title=".mcp.json"
{
  "mcpServers": {
    "sellersheet": {
      "type": "http",
      "url": "https://sellersheetai.com/mcp",
      "headers": { "Authorization": "Bearer ${SELLERSHEET_API_KEY}" }
    }
  }
}
```

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

1. Start Claude Code and run `/mcp`, pick `sellersheet` and sign 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).
