> ## Documentation Index
> Fetch the complete documentation index at: https://docs.merchantops.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect the MCP server

> Give Claude read-only access to your MerchantOps catalog over OAuth.

The MerchantOps **MCP server** is a remote, **read-only** Model Context Protocol
server. Connect it to an MCP client (Claude Desktop or Claude Code) and ask
questions about your catalog in natural language — products, variants, pricing,
and publish status. All access is scoped to your organization via OAuth; the
server performs **no writes**.

<Info>
  **Server URL:** `https://merchantops-mcp.fly.dev/mcp`  ·  **Transport:**
  Streamable HTTP  ·  **Auth:** OAuth 2.1 (sign in with your MerchantOps
  account)
</Info>

## Connect

<Tabs>
  <Tab title="Claude Desktop">
    <Steps>
      <Step title="Open connector settings">
        **Settings → Connectors → Add custom connector.**
      </Step>

      <Step title="Add the server">
        Name it `MerchantOps` and enter the URL:

        ```
        https://merchantops-mcp.fly.dev/mcp
        ```
      </Step>

      <Step title="Authenticate">
        Click **Connect**. A browser window opens to sign in with your
        MerchantOps account and authorize access. After consent you're returned
        to Claude and the MerchantOps tools appear.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Claude Code">
    <Steps>
      <Step title="Add the server">
        ```bash theme={null}
        claude mcp add --transport http merchantops https://merchantops-mcp.fly.dev/mcp
        ```
      </Step>

      <Step title="Authenticate">
        Run `/mcp` inside Claude Code and choose **merchantops → Authenticate**.
        A browser opens for OAuth sign-in; on success the tools become available.
      </Step>
    </Steps>
  </Tab>

  <Tab title="ChatGPT">
    ChatGPT supports remote MCP servers through **custom connectors**. In a
    client that exposes them, add a connector pointing at
    `https://merchantops-mcp.fly.dev/mcp` and complete the OAuth sign-in.

    <Note>
      Custom-connector availability depends on your ChatGPT plan and settings, and
      the option evolves over time. If you don't see custom connectors, use Claude
      Desktop or Claude Code above.
    </Note>
  </Tab>
</Tabs>

## Authentication & access

The server authenticates you with **OAuth** using your MerchantOps account —
there are **no API keys to create or manage**. Access is scoped to your
organization automatically, and the server is **read-only**, so connecting it is
safe: it can answer catalog questions but cannot change data.

<Tip>
  After connecting, ask Claude to run <code>whoami</code> to confirm which account
  and organization it's operating as.
</Tip>

## Available tools

All tools are read-only and scoped to the authenticated member's organization.

| Tool                          | What it does                                         |
| ----------------------------- | ---------------------------------------------------- |
| `whoami`                      | Confirm the authenticated principal and organization |
| `list_products`               | List catalog products (up to 50)                     |
| `search_products`             | Typeahead search by name, brand, or key              |
| `get_product`                 | Get a single product (latest version) by key         |
| `list_product_types`          | List product types / templates (up to 100)           |
| `get_product_publish_status`  | Draft / live / changed status + per-target chips     |
| `get_product_variant_options` | Colors / sizes / widths with value counts            |
| `get_product_pricing`         | Current and upcoming price records per variant       |

## Example prompts

```text theme={null}
Search my catalog for "clifton 10" and show the product details.
What colors and sizes does product 1000047719 come in?
Is product 1000047719 published, and where?
What's the current and upcoming pricing for that product?
```

## Troubleshooting

<AccordionGroup>
  <Accordion title="The browser sign-in doesn't complete / tools don't appear">
    Make sure pop-ups/redirects aren't blocked, then retry the connection. In
    Claude Code, re-run `/mcp` and re-authenticate. MCP clients cache the tool
    list — fully reconnect the connector to pick up changes.
  </Accordion>

  <Accordion title="Tools return empty results">
    Results are scoped to your organization. Run `whoami` to verify you're signed
    in as the expected member and org. If the org is wrong, sign out of the
    connector and reconnect with the right account.
  </Accordion>

  <Accordion title="Connection rejected">
    Confirm the URL is exactly `https://merchantops-mcp.fly.dev/mcp` (with the
    `/mcp` path). If problems persist, contact your MerchantOps admin.
  </Accordion>
</AccordionGroup>