> ## Documentation Index
> Fetch the complete documentation index at: https://www.commercengine.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage your store from AI apps

> Connect Claude, ChatGPT, Codex and other AI apps to your Commerce Engine store, so they can work on your catalog, offers, media, channels and marketplace as you.

The Commerce Engine MCP connector lets an AI app work in your store for you. Ask it to add products, set up a promotion, upload images or approve marketplace sellers, and it makes the change through your own Commerce Engine account.

* **It acts as you.** You sign in with your Commerce Engine login, and the AI app can do only what your role allows, in the stores you can reach.
* **It starts in Sandbox.** A new connection works on your Sandbox stores. Only you can switch it to Live.
* **It asks before changing things.** Tools that change or delete data are marked as such, so your AI app asks you to approve them first.

The connector's server URL is:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
https://mcp.commercengine.io/mcp
```

## Before you start

You need:

* A Commerce Engine account with access to at least one store.
* An AI app that can connect to remote MCP servers with OAuth sign-in, such as Claude, ChatGPT, Codex or Claude Code.

## Connect your AI app

> [tab] Claude
>
> On a Free, Pro, Max or Ultra plan:
>
> **1. Add a custom connector**
>
> Go to [Customize > Connectors](https://claude.ai/customize/connectors) and click **Add custom connector**.
>
> **2. Enter the server URL**
>
> Name it `Commerce Engine`, enter `https://mcp.commercengine.io/mcp`, and click **Add**.
>
> **3. Sign in**
>
> Click **Connect**, then sign in to Commerce Engine and [approve the connection](#approve-the-connection).
>
> On a Team or Enterprise plan, an Owner adds the connector under [Organization settings > Connectors](https://claude.ai/admin-settings/connectors): **Add**, then **Custom**. Each member then finds it under **Customize > Connectors** and clicks **Connect**.
>
> In a chat, turn the connector on from **+ > Connectors**.

> [tab] ChatGPT
>
> **1. Add a custom MCP server**
>
> Open **Plugins**, select **+**, then **Add custom MCP server**.
>
> **2. Enter the server URL**
>
> Name it `Commerce Engine`, enter `https://mcp.commercengine.io/mcp`, and choose OAuth for authentication.
>
> **3. Create the plugin**
>
> Review the risk warning, select **I understand and want to continue**, then select **Create as a plugin**. When ChatGPT asks, sign in to Commerce Engine and [approve the connection](#approve-the-connection).
>
> **4. Install the plugin**
>
> In your personal plugins, open **Commerce Engine** and select **+** to install it.
>
> At the top of ChatGPT, switch the tab from **Chat** to **Work** and start a new Work chat. Type `@` in the prompt box and choose **Commerce Engine**. Workspace admins can restrict custom MCP servers, so if you can't add one, ask yours.

> [tab] Codex
>
> ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
> codex mcp add commerce-engine --url https://mcp.commercengine.io/mcp
> ```
>
> Codex opens the Commerce Engine sign-in in your browser. If it doesn't, run `codex mcp login commerce-engine`. Then [approve the connection](#approve-the-connection).

> [tab] Claude Code
>
> ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
> claude mcp add --transport http commerce-engine https://mcp.commercengine.io/mcp
> ```
>
> Then run `/mcp` in Claude Code, select **commerce-engine**, choose **Authenticate**, and [approve the connection](#approve-the-connection).

> [tab] Other apps
>
> Add a remote MCP server with the URL `https://mcp.commercengine.io/mcp`. The server signs you in with OAuth: your app opens the Commerce Engine sign-in in your browser, where you [approve the connection](#approve-the-connection).

### Approve the connection

When you connect, your AI app opens Commerce Engine in your browser.

**1. Choose your organisation**

If the page asks, enter your organisation's subdomain: `acme` for `acme.commercengine.io`.

**2. Sign in**

Sign in with your usual Commerce Engine login.

**3. Review and allow**

The page shows what the app will be able to read and change, the account and stores it will act on, and where it receives access. Check that this is the app you started from, then click **Allow**.

> [!NOTE]
>
> **Verified** means Commerce Engine confirmed the app's web domain, such as `claude.ai` or `chatgpt.com`. **Unverified** means the app named itself, which is normal for apps that run on your computer, such as Claude Code. Continue only if you started the connection.

## What your AI app can do

| Area | What it can do |
| - | - |
| Search | Find products, categories, customers, attributes and attribute sets by name |
| Catalog | Read, create, update and delete products, variants, categories, attributes and attribute sets; update inventory, packaging and shipping details; choose which channels sell a product; update products in bulk |
| Media | Browse the media library; upload images, videos and documents from a link or a file; update file details; move and delete files; create, rename and delete folders |
| Channels | List and read all sales channels; create and update storefront channels; delete channels |
| Marketplace | Publish, unpublish, stock in and stock out products; create, sync and remove listings; read and moderate reviews; sync catalog items to a connected integration, such as DatoCMS |
| Marketplace sellers | List sellers; approve or reject sellers and their KYC documents; change a seller's visibility |
| Orders | Search and read orders |
| Coupons | Search, create, update and delete coupons |
| Promotions | Search, create, update and delete promotions |

> [accordion] Every tool
>
> * **Connection:** `ce_state`, `ce_switch_environment`
> * **Search:** `search`
> * **Catalog:** `get_product`, `create_product`, `update_product`, `delete_product`, `bulk_update_products`, `list_variants`, `get_variant`, `create_variant`, `update_variant`, `delete_variant`, `get_product_inventory`, `update_product_inventory`, `update_product_packaging`, `update_product_shipping`, `list_product_channels`, `set_product_channels`, `get_category`, `create_category`, `update_category`, `delete_category`, `get_category_attributes`, `set_category_attributes`, `get_attribute`, `create_attribute`, `update_attribute`, `delete_attribute`, `get_attribute_set`, `create_attribute_set`, `update_attribute_set`, `delete_attribute_set`
> * **Media:** `media_library`, `media`, `update_media`, `create_media_folder`, `update_media_folder`
> * **Channels:** `list_channels`, `get_channel`, `create_channel`, `update_channel`, `delete_channel`
> * **Marketplace:** `publish_marketplace_products`, `unpublish_marketplace_products`, `stock_in_marketplace_products`, `stock_out_marketplace_products`, `check_marketplace_inventory`, `create_update_marketplace_listing`, `list_marketplace_listings`, `list_products_on_marketplace`, `unlist_products_on_marketplace`, `sync_product_on_marketplace`, `remove_marketplace_listing`, `list_marketplace_reviews`, `get_marketplace_review`, `update_marketplace_review`, `trigger_product_sync`, `trigger_model_sync`, `list_sync_activity`
> * **Marketplace sellers:** `list_sellers`, `get_seller`, `approve_seller`, `reject_seller`, `approve_seller_document`, `reject_seller_document`, `update_seller_visibility`
> * **Orders:** `search_orders`, `get_order`
> * **Coupons:** `search_coupons`, `create_coupon`, `update_coupon`, `delete_coupon`
> * **Promotions:** `search_promotions`, `create_promotion`, `update_promotion`, `delete_promotion`

### What it can't do

* **Change orders.** It can read orders, but it can't cancel, refund or edit them.
* **Edit customers.** It can find customers, but it can't create or change them.
* **Change payments, store settings, users or roles.** Use the admin app for these.
* **Set up marketplace channels.** They need the marketplace's API credentials, which you enter in the admin app so they never pass through a chat.
* **Create images itself.** If your AI app makes one, the connector can upload it from a public link or, in apps that can run commands such as Claude Code and Codex, from a file.
* **Switch to Live.** Only you can, from the admin app.

## Sandbox and Live

Every new connection starts in Sandbox. At the start of a chat, your AI app checks which environment it's in and tells you.

Sandbox and Live are separate stores. A product or coupon you create in Sandbox doesn't exist in Live, and IDs don't carry over between them.

To switch a connection to Live:

**1. Ask your AI app**

Ask it to switch to Live. It gives you a link to the admin app.

**2. Confirm in the admin app**

Open the link, sign in if asked, and click **Switch to Live**.

The switch applies to every chat on that connection. Switch back to Sandbox the same way.

> [!WARNING]
>
> Sales channels and marketplace sellers belong to your whole organisation, not to one environment. Changes to them take effect in Live even when the connection is in Sandbox.

## Approving changes

Every tool tells your AI app whether it only reads, only creates something new, or changes existing data. Tools that update, delete, publish or sync existing data are marked destructive, so apps such as Claude and ChatGPT ask you to approve them before they run. Read each request before you approve it, and avoid **Always allow** for these tools when you work in Live.

Commerce Engine checks every change with the same rules as the admin app. If something is invalid, nothing is saved: the messages come back field by field, and your AI app can fix the request and try again.

## Example prompts

* "Which environment are you in, and which stores can you reach?"
* "Create a category called Accessories under Men."
* "Find the Linen Shirt and update its description to say it's made from European flax."
* "Create a coupon WELCOME10 for 10% off, valid until 31 December."
* "Upload [https://example.com/summer-hero.jpg](https://example.com/summer-hero.jpg) to the Summer folder in the media library."
* "Show me the most recent orders."
* "List the sellers waiting for approval on my marketplace."
* "Mark the Linen Shirt out of stock on my marketplace."

## Your data

* **What the connector keeps.** When you connect, it keeps your Commerce Engine email, your user and organisation IDs, and a sign-in token, so it can act as you. It also remembers whether each connection is in Sandbox or Live.
* **What it doesn't keep.** It doesn't receive your conversations. It passes each request to Commerce Engine and returns the result, and it doesn't keep copies of what it reads or writes for you.
* **Who sees the results.** Your AI app's provider, such as Anthropic or OpenAI, receives what the tools return, including customer details in orders, under its own terms.
* **How long it lasts.** Your sign-in lasts 30 days, after which your AI app asks you to sign in again. Changing your Commerce Engine password ends it within an hour.

See the [privacy policy](https://www.commercengine.io/privacy-policy) for how Commerce Engine handles your data.

## Disconnect

Remove the connector from your AI app:

* **Claude:** go to **Customize > Connectors**, select Commerce Engine, and click **Remove**.
* **ChatGPT:** remove the Commerce Engine plugin from **Plugins**.
* **Codex:** run `codex mcp remove commerce-engine`.
* **Claude Code:** run `claude mcp remove commerce-engine`.

To end every connection at once, change your Commerce Engine password. Connections stop working within an hour.

## Troubleshooting

> [accordion] "Commerce Engine sign-in expired or was revoked"
>
> Your sign-in has ended, either after 30 days or because your password changed. Reconnect from your AI app: in Claude, click **Connect** on the connector; in Claude Code, run `/mcp` and choose **Authenticate**; in Codex, run `codex mcp login commerce-engine`.

> [accordion] "This account has no access to store …"
>
> Your Commerce Engine user has no role in that store. Ask your store owner to give you access, then ask your AI app which stores it can reach.

> [accordion] The sign-in page asks for my organisation's subdomain
>
> You opened the page on `app.commercengine.io`, which doesn't know your organisation. Enter the first part of your admin address, such as `acme` for `acme.commercengine.io`, and continue.

> [accordion] The page says "Start the connection from your AI app"
>
> The link is missing the connection request. Start again from your AI app instead of opening the page directly.

> [accordion] I can't find something I just created
>
> Check the environment. Ask your AI app which environment it's in: something created in Sandbox doesn't exist in Live, and the reverse.

> [accordion] The switch page says "Ask your AI app for a new switch link"
>
> The link is incomplete. Ask your AI app to switch again and open the new link.

> [accordion] A change was refused
>
> Commerce Engine found something invalid and saved nothing. Your AI app sees the messages by field and can correct the request; if it can't, check the same change in the admin app.

> [accordion] I can't add a custom connector
>
> On Claude Team and Enterprise plans, only an Owner can add one for the organisation. In ChatGPT workspaces, admins can restrict custom MCP servers. Ask your admin.

## Support

For help with the connector, [contact us](https://www.commercengine.io/contact-us).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.