> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.super-simple.co/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Connect an AI assistant (MCP)

Connect an AI assistant to Supr and you can ask it about your subscriptions in plain words: "Which subscriptions renew this week?", "Pause the subscription for order #1234" or "Skip next month for this customer". It works with assistants that support MCP, a standard way for an assistant to use other tools.

The assistant can list and view subscriptions, and pause, resume, skip, unskip and reschedule the next order. It cannot cancel subscriptions or edit products. The key works for one store only, and you can disconnect it at any time.

## Before you start: which assistants work

Your assistant must let you send a key with each request. That works in **GitHub Copilot** (in Visual Studio Code) and **Claude Desktop**, which are covered below.

The websites **claude.ai** and **chatgpt.com** cannot be connected yet. Their connectors sign in through a login screen and have no place to paste a key. We will add them when we support that sign in.

## Step 1: Create a key

1. Go to [**Supr Bundles & Subscriptions > Settings > Integrations > MCP**](https://admin.shopify.com/apps/super-subscriptions/app/settings/integrations/mcp).
2. Click **Create key**.
3. Copy the key straight away. **It is shown once.** We do not store it, so if you lose it, create a new one.

Copy the **MCP server URL** from the same page too. It looks like `https://subscriptions.super-simple.co/mcp/merchant`.

Below, use the URL from your page in place of the example one, and replace `YOUR_KEY` with your key.

## Step 2: Add it to your assistant

### Claude Desktop

1. Open **Settings > Developer** and click **Edit Config**. A file called `claude_desktop_config.json` opens.
2. Add this inside the `mcpServers` section, then save the file:

```
"supr": {
  "command": "npx",
  "args": ["mcp-remote", "https://subscriptions.super-simple.co/mcp/merchant", "--header", "Authorization:${SUPR_AUTH}"],
  "env": { "SUPR_AUTH": "Bearer YOUR_KEY" }
}
```

3. Quit Claude Desktop completely and open it again.

This needs [Node.js](https://nodejs.org) installed, because `mcp-remote` runs through `npx`.

### GitHub Copilot in Visual Studio Code

1. Open the Command Palette (**Cmd+Shift+P** on Mac, **Ctrl+Shift+P** on Windows) and run **MCP: Open User Configuration**. A file called `mcp.json` opens.
2. Put this in the file, then save. VS Code asks for your key when it starts the server, so the key is not written in the file:

```
{
  "servers": {
    "supr": {
      "type": "http",
      "url": "https://subscriptions.super-simple.co/mcp/merchant",
      "headers": { "Authorization": "Bearer ${input:supr-key}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "supr-key", "description": "Supr key", "password": true }
  ]
}
```

3. Click **Start** above the `supr` entry, and paste your key when VS Code asks.
4. Open Copilot Chat, switch to **Agent** mode and open the tools list. **supr** should be there.

## Step 3: Try it

Ask your assistant: **"List my five most recent subscriptions."** If it answers with your subscriptions, you are connected.

## Replace or remove the key

On the same **Settings > Integrations > MCP** page:

- **Create a new key** replaces the current one. The old key stops working immediately, so update your assistant with the new key.
- **Disconnect** turns the key off. Your assistant can no longer reach your subscriptions.

Treat the key like a password. Do not paste it in a chat, a screenshot or a shared document. If it leaks, create a new key.

## Troubleshooting

- **401 or "unauthorized"**: the key is wrong, was replaced or was disconnected. Create a new key and paste it again.
- **The assistant does not list supr**: restart it fully. Claude Desktop only reads its file on start, and VS Code needs you to click **Start** on the server.
- **"MCP is not available for this store"**: message us in live chat and we will turn it on.