> ## 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 ChatGPT, Claude, Claude Code, or any MCP client with your Shopify login

The Operators MCP authenticates with OAuth. Your MCP server URL is under <Icon icon="shopify" iconType="solid" /> **[Integrations](https://admin.shopify.com/apps/supercycle/settings/integrations)**, and you sign in with your Shopify account when you connect. On the consent screen you select **Full access** or **Read only**. See [OAuth access levels](/ai/operators-mcp/security#oauth-access-levels).

Pick your client below.

<AccordionGroup>
  <Accordion title="ChatGPT" icon="openai" iconType="brands">
    ChatGPT connects to MCP servers through its Connectors feature.

    <Steps>
      <Step title="Open Connectors">
        In ChatGPT, open **Settings**, then **Connectors**, then select **Add custom connector**.
      </Step>

      <Step title="Add the server">
        Enter `Supercycle Operators MCP` in **Name**, and your MCP server URL from **Integrations** in **URL**.
      </Step>

      <Step title="Authenticate">
        ChatGPT redirects you to sign in with your Shopify account. On the consent screen, select **Full access** or **Read only**, then approve. This authorizes ChatGPT to reach your Supercycle data.
      </Step>

      <Step title="Use it in a chat">
        In a new chat, select the attachments button (the plus icon), then the Supercycle Operators MCP connector. ChatGPT can then 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 connects to MCP servers through its Connectors feature.

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

      <Step title="Add the server">
        Select **Add custom connector**. Enter `Supercycle Operators MCP` in **Name**, and your MCP server URL from **Integrations** in **URL**.
      </Step>

      <Step title="Authenticate">
        Claude redirects you to sign in with your Shopify account. On the consent screen, select **Full access** or **Read only**, then approve. This authorizes Claude to reach your Supercycle data.
      </Step>

      <Step title="Use it in a chat">
        Select the attachments button (the plus icon), then the Supercycle Operators MCP connector. Claude can then 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">
    Add the server from the terminal. Replace the placeholder with your MCP server URL from **Integrations**.

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

    Claude Code asks you to sign in with your Shopify account. On the consent screen, select **Full access** or **Read only**, then approve. Confirm the connection:

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

  <Accordion title="Other MCP clients">
    Any MCP-compatible client can connect with your MCP server URL from **Integrations**. You sign in with your Shopify account when you connect and select an [access level](/ai/operators-mcp/security#oauth-access-levels) on the consent screen.
  </Accordion>
</AccordionGroup>

***

## Pair it with the Shopify AI toolkit

For wider access to your Shopify store, pair the Operators MCP with the [Shopify AI toolkit](https://shopify.dev/docs/apps/build/ai-toolkit). With both connected, your AI assistant sees your Supercycle circular operations and native Shopify resources such as products, orders, and store policies in one 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. With both connected, you can ask cross-store questions:

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

***

## Operators MCP troubleshooting

<AccordionGroup>
  <Accordion title="A write tool fails with an Insufficient scope error">
    **Why it happens.** The connection was authorized as **Read only**, so write tools return **Insufficient scope: this tool requires write access, but this connection was authorized as read only. Reconnect and choose full access to use it.**

    **How to fix it.** Disconnect and reconnect your AI client, then select **Full access** on the consent screen. See [OAuth access levels](/ai/operators-mcp/security#oauth-access-levels).
  </Accordion>

  <Accordion title="Connecting fails with Unauthorized Access">
    **Why it happens.** The email address on your AI client account doesn't match a staff email on your Shopify store, so the sign-in shows **Oops, something went wrong. Unauthorized Access**.

    **How to fix it.** Either update your email in your [Shopify account settings](https://accounts.shopify.com/accounts/personal) to match the AI client, or sign in to the AI client with the email your Shopify account uses.
  </Accordion>
</AccordionGroup>