Skip to content

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 appWhere it runsHow you connect
Claudeclaude.ai on the web, plus the Claude desktop and phone appsAdd a custom connector
Claude CodeYour terminalRun one command
ChatGPTchatgpt.comAdd 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.

  1. Navigate to App Settings > AI assistants
  2. 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 doesHow long a sign-in lasts
Makes changesYour assistant's sign-in must be less than 7 days old
Views your setupKeeps 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:

  1. Navigate to App Settings > AI assistants
  2. Under Stay connected, click Renew sign-in. It opens in a new tab
  3. 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:

LimitDefault
Changes30 a minute
Deletes10 an hour
Price changes20 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 ​

ProblemWhat to do
Sign-in ends on a page that says invalid_client or Client authentication failedRemove the connection in your AI app and add it again. See your app's page
It says collaborator accounts can't connectSign 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 storeOpen Key Product Options once from the store's Shopify admin, then connect again
It says the store needs an active planChoose a plan in the app, then connect again
Your assistant says changes need a fresh sign-inClick Renew sign-in on the AI assistants page, or disconnect and connect again. See Stay Connected
Sign-in did not completeStart again from your AI app and finish within 10 minutes, in the same browser
Your assistant can't find the serverCheck 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.