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

# Setup

> Connect the Operators MCP to your preferred AI client

The Operators MCP uses OAuth authentication. You'll find your MCP server URL in your <Icon icon="shopify" iconType="solid" /> [Integrations](https://admin.shopify.com/apps/supercycle/settings/integrations), and you'll be asked to sign in with your Shopify account when connecting.

<AccordionGroup>
  <Accordion title="ChatGPT" icon="openai" iconType="brands">
    ChatGPT supports MCP connections through its Connectors feature.

    <Steps>
      <Step title="Open Connectors settings">
        In ChatGPT, go to **Settings** → **Connectors** → **Add custom connector**.
      </Step>

      <Step title="Add the Supercycle Operators MCP server">
        * **Name:** `Supercycle Operators MCP`
        * **URL:** Your MCP server URL from <Icon icon="shopify" iconType="solid" /> [Integrations](https://admin.shopify.com/apps/supercycle/settings/integrations)
      </Step>

      <Step title="Authenticate">
        You'll be redirected to sign in with your Shopify account. This authorizes ChatGPT to access your Supercycle data.
      </Step>

      <Step title="Use it in your chats">
        When starting a new chat, select the attachments button (the plus icon) and choose the Supercycle Operators MCP connector. ChatGPT will now be able to query your Supercycle data.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Claude" icon="https://mintcdn.com/supercycle/XbKBsdX_PulItpyX/images/icons/claude.svg?fit=max&auto=format&n=XbKBsdX_PulItpyX&q=85&s=20cf8e84f3811b0c9f8f02bd3279147a" width="24" height="24" data-path="images/icons/claude.svg">
    Claude supports MCP connections through its Connectors feature.

    <Steps>
      <Step title="Open Connectors settings">
        Navigate to the [Connectors](https://claude.ai/settings/connectors) page in your Claude settings.
      </Step>

      <Step title="Add the Supercycle Operators MCP server">
        Select **Add custom connector** and enter:

        * **Name:** `Supercycle Operators MCP`
        * **URL:** Your MCP server URL from <Icon icon="shopify" iconType="solid" /> [Integrations](https://admin.shopify.com/apps/supercycle/settings/integrations)
      </Step>

      <Step title="Authenticate">
        You'll be redirected to sign in with your Shopify account. This authorizes Claude to access your Supercycle data.
      </Step>

      <Step title="Use it in your chats">
        When using Claude, select the attachments button (the plus icon) and choose the Supercycle Operators MCP connector. Claude will now be able to query your Supercycle data.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Claude Code" icon="https://mintcdn.com/supercycle/XbKBsdX_PulItpyX/images/icons/claude.svg?fit=max&auto=format&n=XbKBsdX_PulItpyX&q=85&s=20cf8e84f3811b0c9f8f02bd3279147a" width="24" height="24" data-path="images/icons/claude.svg">
    Run the following command, replacing the URL with your MCP server URL from <Icon icon="shopify" iconType="solid" /> [Integrations](https://admin.shopify.com/apps/supercycle/settings/integrations):

    ```bash theme={null}
    claude mcp add --transport http supercycle-operators-mcp <your-mcp-url>
    ```

    You'll be prompted to authenticate with your Shopify account. Verify the connection:

    ```bash theme={null}
    claude mcp list
    ```
  </Accordion>

  <Accordion title="Other MCP clients">
    Any MCP-compatible client can connect using your MCP server URL from <Icon icon="shopify" iconType="solid" /> [Integrations](https://admin.shopify.com/apps/supercycle/settings/integrations). You'll authenticate via OAuth with your Shopify account when connecting.
  </Accordion>
</AccordionGroup>

## Supplement with the Shopify AI toolkit

For broader access to your Shopify store, you can pair the Operators MCP with the [Shopify AI toolkit](https://shopify.dev/docs/apps/build/ai-toolkit). Adding both gives your AI assistant access to your Supercycle circular operations data **and** native Shopify resources like products, orders, and store policies in a single chat.

The Shopify AI toolkit is installed separately in your AI client — see Shopify's [installation guide](https://shopify.dev/docs/apps/build/ai-toolkit) for the plugin, agent skills, or Dev MCP options. Once both are connected, you can ask cross-store questions like:

* *"Compare this month's rental cycles in Supercycle to my Shopify product sell-through."*
* *"Which Shopify products are tied to overdue returns in Supercycle?"*

## Troubleshooting

<AccordionGroup>
  <Accordion title="Unauthorized Access error">
    If you see an error like:

    ```
    Oops, something went wrong.
    What happened?
    Unauthorized Access:
    ```

    This means the email address for your AI chat client doesn't match a user email on your Shopify store. To fix this, either:

    * Update your email in your [Shopify account settings](https://accounts.shopify.com/accounts/personal) to match your AI client email
    * Or update your AI client to use the email associated with your Shopify account
  </Accordion>
</AccordionGroup>