Appearance
AI Assistants (MCP)
Connect an AI assistant such as Claude, Claude Code or ChatGPT to your store, then ask it in plain words to set up your product options.
Overview
Key Product Options has its own MCP server. MCP (Model Context Protocol) is the standard way AI apps connect to other tools. Once you connect an assistant, you can ask it in plain words to find, create and change your option sets, options, choices, prices, conditions and the products they appear on.
Your assistant can:
- Find option sets and see which products and collections they're on
- Create and edit option sets, options and their choices
- Set prices on choices
- Add conditions that show or hide options
- Assign option sets to products and collections
- Translate your option texts and storefront messages into your store's languages. See Translating with AI
Image dropdowns and uploading images can't be set up from an AI assistant yet. Use the app for those.
What your assistant can do follows your plan, the same as in the app.
How this differs from Shopify Sidekick
Shopify Sidekick can only look things up. An assistant connected here can also make changes to your store, after you approve them.
Supported AI Apps
Pick your app for step-by-step setup:
| AI app | Where it runs | How you connect |
|---|---|---|
| Claude | claude.ai on the web, plus the Claude desktop and phone apps | Add a custom connector |
| Claude Code | Your terminal | Run one command |
| ChatGPT | chatgpt.com | Add a custom MCP server as a plugin |
Before You Start
- Your own staff account. You sign in with your Shopify staff account on this store. Collaborator accounts can't connect.
- The app is set up. Open Key Product Options at least once from this store's Shopify admin.
- An active plan. The store needs an active Key Product Options plan.
- An AI plan that allows custom connectors. Each app's page says what it needs.
Find Your Server Address
Every assistant asks for the same server address.
- Navigate to App Settings > AI assistants
- Under Your server address, click Copy address
Paste it exactly as shown, with nothing added at the end, not even a slash. If copying doesn't work, click the field, select the address and copy it yourself.
The page also has a tab for each AI app, with the same steps as these docs and the command or address filled in for you.
How Sign-In Works
- You sign in with your Shopify staff account. Each person connects with their own login
- Collaborator accounts are refused
- Every time you connect, a page shows the app, your store and your email. Nothing connects until you click Allow
- Finish sign-in within 10 minutes, in the same browser
- The connection only reaches the store you picked while signing in
Stay Connected
| What your assistant does | How long a sign-in lasts |
|---|---|
| Makes changes | Your assistant's sign-in must be less than 7 days old |
| Views your setup | Keeps working for 30 days after your assistant's last sign-in. After that, the connection stops and your assistant asks you to connect again |
Signing in to the Shopify admin doesn't count. It has to be your assistant's sign-in.
When your assistant says changes need a fresh sign-in:
- Navigate to App Settings > AI assistants
- Under Stay connected, click Renew sign-in. It opens in a new tab
- Sign in as the same staff member who connected
This renews the sign-in of every assistant you connected, in one go. You can also reconnect from the AI app itself. Each app's page shows how.
Keeping Your Store Safe
- Your assistant is told to preview each change and ask you before it saves. Ask for a preview if it doesn't show one
- Deleting always needs a preview first. If the option set changed since the preview, the delete is refused
- There's no undo. Read the preview before you agree
- Changes show on your storefront right away
- Prices on choices work the same as in the app: they add a hidden add-on product in Shopify. See Price Add-Ons
- Your AI app may also ask you to approve each action. Keep that on for actions that change your store
To protect your store, there are limits per store:
| Limit | Default |
|---|---|
| Changes | 30 a minute |
| Deletes | 10 an hour |
| Price changes | 20 an hour (one change can price several choices) |
The Keeping your store safe section of the AI assistants page shows the limits that apply to your store.
Example Requests
- "Which option sets are on my Classic T-Shirt?"
- "Create an option set called Gift Wrapping with a checkbox that adds $5."
- "Add a Short Text option for an engraving message, max 20 characters."
- "Only show the Engraving Font option when Add engraving is checked."
- "Assign the Gift Wrapping option set to the Holiday collection."
- "Translate the Gift Wrapping option set into French."
Disconnect
To disconnect, remove the connection in your AI app. Each app's page shows how.
Uninstalling Key Product Options disconnects every assistant from your store.
Troubleshooting
| Problem | What to do |
|---|---|
| Sign-in ends on a page that says invalid_client or Client authentication failed | Remove the connection in your AI app and add it again. See your app's page |
| It says collaborator accounts can't connect | Sign in with your own staff account on the store, or ask the store owner to connect |
| It says Key Product Options isn't set up on your store | Open Key Product Options once from the store's Shopify admin, then connect again |
| It says the store needs an active plan | Choose a plan in the app, then connect again |
| Your assistant says changes need a fresh sign-in | Click Renew sign-in on the AI assistants page, or disconnect and connect again. See Stay Connected |
| Sign-in did not complete | Start again from your AI app and finish within 10 minutes, in the same browser |
| Your assistant can't find the server | Check that the address matches exactly, with no slash at the end |
Can I use it on more than one store? Yes. Connect once per store. Each connection only reaches the store you picked while signing in.
Related
- Connect Claude
- Connect Claude Code
- Connect ChatGPT
- Translating with AI
- Shopify Sidekick — ask read-only questions from the Shopify admin
- Price Add-Ons — how prices on choices work