---
title: "Connect AI assistants to STOQ"
description: "Connect Claude or ChatGPT to your store, or use the built-in Quinn and Sidekick assistants, from the AI connectors section in Integrations."
url: https://help.stoqapp.com/general/ai-connectors/
product: "General"
section: "AI and tools"
last_updated: 2026-11-05
---

# Connect AI assistants to STOQ

> Connect Claude or ChatGPT to your store, or use the built-in Quinn and Sidekick assistants, from the AI connectors section in Integrations.

STOQ has an **AI connectors** section where you can connect Claude or ChatGPT directly to your store, and where you'll find the AI assistants already built in: **Quinn** (STOQ's own in-app assistant) and **Sidekick** (Shopify's assistant). Once an assistant is connected, you can ask about your live STOQ data or have it make changes for you, all from the same conversation.

## What you can ask an AI assistant to do

- **Answer questions from your live data**: a specific offer's performance, who's on a back in stock waitlist, an order's status and payment state, or demand trends across products.
- **Make changes for you**: update shipping and payment settings, tag or release an order, or manage a waitlist signup.

The four assistants differ in where they run and whether they need any setup:

| Assistant | What it is | Setup |
|---|---|---|
| **Claude** | Anthropic's assistant, connected to STOQ as a custom connector | Connect it yourself |
| **ChatGPT** | OpenAI's assistant, connected to STOQ as a custom connector | Connect it yourself |
| **Quinn** | STOQ's own in-app assistant | Already on, shows **Connected** |
| **Sidekick** | Shopify's own assistant, inside Shopify admin | Already works with your STOQ data, shows **Connected** |

## Open the AI connectors section

On a phone, this menu is collapsed. In the **Shopify mobile app**, tap the **STOQ** logo at the top of the screen to open it, then choose the section named below. There is no hamburger icon. See [Finding the STOQ menu](https://help.stoqapp.com/general/getting-started-with-stoq/#finding-the-stoq-menu).

1. **Open the Integrations page**

   1. In the left menu bar of the STOQ app, click **Back in stock alerts**.
   2. Click the **Settings** tab.
   3. Open the **Integrations** sub-tab, then click **See integrations** to open the full **Integrations** page.

   You can also reach the same page from **Preorders → Settings → Integrations**. The Integrations page is shared across both products.

   [Image: STOQ Back in stock alerts Settings Integrations sub-tab with markers: 1 Back in stock alerts in the left menu, 2 the Settings tab, 3 the Integrations sub-tab, 4 the See integrations button](https://help.stoqapp.com/images/general/ai-connectors-1.png)

2. **Find the AI connectors section**

   Scroll to the **AI connectors** section. It shows a card for **Claude**, **ChatGPT**, **Quinn**, and **Sidekick**, each with a **Set up** button. Quinn and Sidekick also show a **Connected** badge, since they need no setup.

   [Image: The Integrations page scrolled to the AI connectors section, with cards for Claude, ChatGPT, Quinn (Connected), and Sidekick (Connected), each with a Set up button](https://help.stoqapp.com/images/general/ai-connectors-2.png)

## Connect Claude

You add STOQ to Claude as a **custom connector** from Claude's own settings, using STOQ's MCP server URL, then approve the connection with your Shopify store or a connector key.

1. **Find STOQ's MCP server URL and connector key**

   In STOQ, open the **AI connectors** section and click **Set up** on the **Claude** card. It shows the **MCP server URL** (`https://app.stoqapp.com/api/v2/external/mcp`) and your **Connector key**. Keep this open: you'll need the URL, and the key only if you connect with a key instead of signing in.

   [Image: The AI connectors section with marker 1 on the Claude card's Set up button](https://help.stoqapp.com/images/general/ai-connectors-3.png)

   [Image: The Claude setup panel showing step 1 the MCP server URL with a Copy button and step 2 the Connector key with Copy and Reset buttons](https://help.stoqapp.com/images/general/ai-connectors-4.png)

2. **Open Add custom connector in Claude**

   In the Claude app, click **Settings**, click **Connectors**, click **Add**, then choose **Add custom connector**. On Claude's free plan you can add one custom connector.

   [Image: The Claude Settings Connectors page with the Add dropdown open on Add custom connector, noting the free plan allows one custom connector](https://help.stoqapp.com/images/general/ai-connectors-11.png)

3. **Enter the name and URL**

   Set **Name** to `Stoq`, paste the **MCP server URL** into the address field, then click **Continue**.

   [Image: The Add custom connector dialog with the Name set to Stoq and the MCP server URL entered, above the Continue button](https://help.stoqapp.com/images/general/ai-connectors-12.png)

4. **Choose the connection settings, then Add**

   1. Under **Authentication**, select **Sign in now**.
   2. Under **OAuth client**, select **Register automatically**.
   3. Expand **Advanced** and confirm **Transport** is set to **Streamable HTTP**.
   4. Click **Add**.

   [Image: The Add custom connector settings with Authentication set to Sign in now, OAuth client set to Register automatically, and Advanced Transport set to Streamable HTTP, with the Add button](https://help.stoqapp.com/images/general/ai-connectors-13.png)

5. **Connect your store**

   Claude opens a **Connect Claude to STOQ** page in your browser. Enter your store's `your-store.myshopify.com` domain and click **Continue**.

   To connect with a key instead, click **Use a connector key instead**, paste the **Connector key** from the STOQ **Claude** card (or the **Integrations** page), and click **Allow**.

   [Image: The Connect Claude to STOQ browser page with the Shopify store field, the Continue button, and the Use a connector key instead link](https://help.stoqapp.com/images/general/ai-connectors-14.png)

6. **Approve the connection in Shopify**

   Shopify opens a **Connect Claude to STOQ** page listing what Claude can do: see and change preorders and preorder orders, see and manage back in stock alerts, and see STOQ reports. Click **Connect**. You're returned to Claude.

   [Image: The Shopify Connect Claude to STOQ approval page listing what Claude can do, with the Connect button](https://help.stoqapp.com/images/general/ai-connectors-15.png)

7. **Review the tool permissions**

   Back in Claude, the connector's **Tool permissions** list STOQ's tools grouped as read-only, write/delete, and other. Set when Claude may use each, then start asking Claude about your STOQ data.

   [Image: The connector's Tool permissions in Claude, with the read-only, write/delete, and other tool groups](https://help.stoqapp.com/images/general/ai-connectors-16.png)

> **Tip**
>
> New to STOQ? Once Claude is connected, you can have it walk you through setting up back in stock alerts or preorders in chat, instead of the dashboard. See [Set up STOQ by chatting with an AI assistant](https://help.stoqapp.com/general/set-up-stoq-with-ai-assistant/).

If nothing opens when you sign in, allow popups for Claude in your browser and try again. The sign-in page opens in a popup or new tab, and a blocked popup stops it from finishing.

> **Note**
>
> Where you add a custom connector lives in Claude's own settings, not in STOQ, and can move as Claude updates. If you can't find it, check Claude's own help for "custom connectors".

### If sign-in doesn't complete

If Claude keeps asking you to sign in, or still reports that authorization is required after you approved it in STOQ, connect with your **API key** instead of the sign-in flow.

Your API key is **not** the same as the connector key. The **connector key** approves the sign-in flow above. The **API key** is a separate credential that authenticates each request, and it's the only one that goes in a header.

1. **Copy your API key**

   On the **Integrations** page, find the **API key** section (it reads "Use this API key to access the STOQ API"). Click **Copy**. The key starts with `stoq_api`.

2. **Add the connector with a header instead of signing in**

   In Claude, add the STOQ connector using the **No sign-in** option, then add a request header named `X-Auth-Token` with your API key as its value. Claude connects without the sign-in step.

Don't mix the two keys: the connector key goes into the sign-in page, and only the API key (starting `stoq_api`) goes in the `X-Auth-Token` header.

## Connect ChatGPT

Connecting ChatGPT adds STOQ to it as a custom MCP app, using the MCP server URL from the ChatGPT card, then approve the connection with your Shopify store or a connector key.

1. **Open the ChatGPT setup in STOQ**

   In the **AI connectors** section, click **Set up** on the **ChatGPT** card. Its panel opens with the **MCP server URL** (step 1) and the **Connector key** (step 2).

   [Image: The AI connectors section with marker 1 on the ChatGPT card's Set up button](https://help.stoqapp.com/images/general/ai-connectors-5.png)

2. **Create an MCP app in ChatGPT**

   In ChatGPT, click **Plugins** in the left menu, click **Add** at the top right, then choose **Create MCP App**.

   [Image: ChatGPT's Plugins page with marker 1 on Plugins in the left menu, marker 2 on the Add dropdown, and marker 3 on Create MCP App](https://help.stoqapp.com/images/general/ai-connectors-6.png)

3. **Fill in the New Plugin form**

   1. Back in STOQ, click **Copy** next to the **MCP server URL** in step 1.
   2. In ChatGPT's **New Plugin** dialog, enter a **Name** (for example, STOQ), then paste the URL into the **Connection** field (with **Server URL** selected).
   3. Leave **Authentication** set to **OAuth**.
   4. Tick **I understand and want to continue**, then click **Create**.

   [Image: The STOQ ChatGPT panel with the marker on Copy next to the MCP server URL in step 1](https://help.stoqapp.com/images/general/ai-connectors-7.png)

   [Image: ChatGPT's New Plugin dialog with the Name STOQ, the MCP URL in the Connection Server URL field, Authentication set to OAuth, the I understand and want to continue box ticked, and marker 1 on the Create button](https://help.stoqapp.com/images/general/ai-connectors-8.png)

4. **Approve the connection**

   ChatGPT shows a **Connect stoq** screen listing what access it grants. Click **Continue to stoq** to approve it.

   [Image: ChatGPT's Connect stoq consent screen with the Continue to stoq button](https://help.stoqapp.com/images/general/ai-connectors-9.png)

5. **Connect your store**

   ChatGPT opens a STOQ page asking for your store. Enter your store's `your-store.myshopify.com` domain and click **Continue**. If the page doesn't open, allow popups for ChatGPT in your browser.

   To connect with a key instead, click **Use a connector key instead**, paste the **Connector key** from step 2 of the STOQ **ChatGPT** panel, and click **Allow**.

   [Image: The STOQ ChatGPT panel with marker 1 on Copy next to the Connector key in step 2](https://help.stoqapp.com/images/general/ai-connectors-10.png)

6. **Approve the connection in Shopify**

   Shopify opens the STOQ approval page listing what ChatGPT can do. Click **Connect**. You're returned to ChatGPT.

## Use Quinn

Quinn is STOQ's own assistant and is always available in your admin, so there's nothing to connect: its card shows **Connected**. Click **Set up** on the **Quinn** card and then **Chat with Quinn** to open it, or use the Quinn chat bubble in the STOQ app.

Unlike Claude or ChatGPT, Quinn can open the exact settings screen for you, or suggest a change and apply it once you confirm. See [Ask Quinn, your AI assistant](https://help.stoqapp.com/general/ask-quinn/) for how to use it.

## Use Sidekick

Sidekick is Shopify's own assistant and lives inside Shopify admin. It can already answer using your live STOQ data, so there's nothing to connect: its card shows **Connected**. Click **Set up** on the **Sidekick** card, then **Copy a question** to copy a starter prompt, and paste it to Sidekick in Shopify admin to try it out.

Sidekick can also prepare STOQ changes for you: it shows them in a STOQ change panel for you to confirm, or opens a STOQ editor with the change filled in for you to save. See [Ask Shopify Sidekick about your STOQ data](https://help.stoqapp.com/general/ask-shopify-sidekick/) for what to ask and how changes work.

## Reset your connector key

If you want to revoke access, or you shared the key by mistake, reset it. In the **AI connectors** section, click **Set up** on the **Claude** or **ChatGPT** card, click **Reset** next to the **Connector key**, then confirm.

Resetting generates a new key and disconnects every Claude or ChatGPT connection to your store, including ones you approved in Shopify. To use an assistant again, connect it again. Resetting the connector key doesn't affect your general STOQ API key, a Claude connection that uses your API key, or any other integration.

## FAQ

### Do I need to connect Quinn or Sidekick?

No. Quinn is built into your STOQ admin and Sidekick lives in Shopify admin, so both show **Connected** and work without any setup. Only Claude and ChatGPT need connecting.

### Is the connector key the same as my STOQ API key?

No, they're two different keys. The connector key approves the AI assistant sign-in flow. The API key (it starts `stoq_api`, on the Integrations page) is for custom integrations built on the STOQ API, and it can also connect Claude without the sign-in flow when you add it as an `X-Auth-Token` header. Resetting one doesn't affect the other.

### Is my connector key stored inside Claude or ChatGPT?

No. It's used once, when the assistant asks you to sign in, to approve the connection. After that the connection runs on its own secure token, not the key you pasted.

### What can a connected assistant change in my store?

It can update shipping and payment settings, tag or release an order, and manage a waitlist signup, alongside answering questions from your live STOQ data.

### What's the difference between Quinn and connecting Claude or ChatGPT?

Quinn runs inside STOQ and can open the exact settings screen or make a change with a live preview. Claude and ChatGPT connect from outside through the custom connector, and answer or act on your STOQ data from their own chat.

### Claude or ChatGPT won't accept the connector

Check that you pasted the full **MCP server URL** into the custom connector, copied with the **Copy** button. On the STOQ page that opens, enter your store's `myshopify.com` domain, or click **Use a connector key instead** and paste the **Connector key**. Allow popups so that page can open. Each approval link works once and lasts 15 minutes, so if it has expired or you reset the key partway through, start connecting again from the AI app.

### Claude still says authorization is required after I approved the sign-in

The sign-in flow didn't finish. Connect with your API key instead, see [If sign-in doesn't complete](#if-sign-in-doesnt-complete). Use the API key (it starts `stoq_api`) in an `X-Auth-Token` header with the **No sign-in** option, not the connector key.

## Related guides

- [Set up STOQ by chatting with an AI assistant](https://help.stoqapp.com/general/set-up-stoq-with-ai-assistant/): Have Claude walk you through back in stock or preorder setup in chat.
- [Getting started with STOQ](https://help.stoqapp.com/general/getting-started-with-stoq/): Find your way around the STOQ admin, including on mobile.
- [Find anything with search](https://help.stoqapp.com/general/find-anything-with-search/): Jump to any STOQ setting or report from the search bar.
- [Get help from STOQ](https://help.stoqapp.com/account/get-help-from-stoq/): Reach the support team when you're stuck.
- [Preorder API](https://help.stoqapp.com/preorders/preorder-api/): Build custom integrations on the STOQ API.
