This article shows you how to connect an AI client to the HexaSync MCP Server of your Shopify store. After connecting, you can ask the AI client about the store’s orders, sales, products, collections and inventory in plain language. Access is read-only: the AI client cannot change anything in Shopify.
The steps below are for Claude. HexaSync shows the same kind of steps for Claude Code, Codex CLI and other AI clients on the MCP Server page of your connector.
Before you start
- A Shopify Connector App in HexaSync. If you have not connected your store yet, follow the Shopify connection guide first.
- A Beehexa Account that can open that connector in HexaSync. You sign in with it when the AI client connects.
- A Claude account. The steps work in Claude on the web and in Claude Desktop.
- On Claude Team and Enterprise plans: an owner must add the connector to the organization before members can connect.
Part 1: Open the MCP Server page in HexaSync
Step 1: Open your Shopify connector
Sign in to HexaSync, open Connectors, then select your Shopify Connector.
Step 2: Select MCP Server
In the connector’s menu on the left, select MCP Server. The page names the store the server reads from and shows a tab for each AI client: Claude, Claude Code, Codex CLI and Other AI client.
Check the store name before you continue, then keep this page open: you copy three values from it in Part 2.
| Value | What it is | Example |
|---|---|---|
| Connector name | A suggested name for the connector in Claude. You can use another name. | The name shown on the page |
| MCP server URL | The address of the MCP Server of this store. Each connector has its own. | https://mcpserver.beehexa.com/mcp/<your-server-id> |
| OAuth client ID | The client ID Claude uses to sign you in with your Beehexa Account. | hexasync-mcp |
Use the Copy button next to each value so that nothing is mistyped.
Part 2: Add the MCP Server to Claude
Step 1: Add a custom connector
In Claude, go to Settings > Customize > Connectors, then select Add > Add custom connector.
Step 2: Name the connector
Enter a name for the connector. You can copy the Connector name from the MCP Server page in HexaSync.
Step 3: Paste the MCP server URL
Copy the MCP server URL from HexaSync, paste it into Claude, then select Continue.
Step 4: Enter the OAuth client ID
Leave Sign in now and Use your own OAuth client selected. Paste the OAuth client ID hexasync-mcp, leave the client secret blank, then select Add.
Step 5: Connect and sign in
Select Connect, then sign in with your Beehexa Account when prompted. Claude then returns you to the connector’s page.
Step 6: Start a conversation
Open a new Claude conversation. Your AI client is ready to answer questions about your store.
Part 3: Check the connection
Ask a question that needs data from the store, for example:
- Which Shopify store are you connected to?
- What were total sales and the number of orders over the last 7 days?
- How many orders are unfulfilled, and which has waited longest?
Claude asks for permission the first time it uses a tool of the connector. An answer with your store’s own name, orders or sales means the connection works.
What the AI client can read
The Shopify MCP Server has 15 read-only tools. The order tools return orders of the last 60 days only.
| Tool | What it returns |
|---|---|
list_connections |
Which HexaSync account and Shopify store the connection works on. |
shopify_get_store_overview |
Store name, domain, currency, time zone and locations. |
shopify_search_orders |
Orders filtered by conditions such as status or date. |
shopify_get_order_details |
The details of one order, without the customer’s phone number and email. |
shopify_get_order_custom_fields |
The custom fields attached to one order. |
shopify_get_unfulfilled_orders_summary |
A summary of the orders that have not been fulfilled yet. |
shopify_get_high_risk_orders |
Orders flagged as high fraud risk. |
shopify_get_sales_metrics_summary |
Total sales, number of orders and similar sales metrics. |
shopify_top_products |
The best-selling products. |
shopify_search_products |
Products by name, SKU, vendor, product type, status or tag. |
shopify_get_product_details |
The variants and collections of one product. |
shopify_list_collections |
The collections and the number of products in each. |
shopify_get_collection_products |
The products that belong to one collection. |
shopify_get_inventory_levels |
Stock quantity at each location. |
shopify_get_low_stock_items |
Items that are running low and need restocking. |
For example questions and what each tool is for, see the Shopify MCP Server page.
Other AI clients
The MCP Server page in HexaSync has a tab for Claude Code, Codex CLI and Other AI client. Select the tab of the client you use and follow the steps it shows. Every client uses the same MCP server URL and the same OAuth client ID, and asks you to sign in with your Beehexa Account.
If the connection does not work
| What you see | What to check |
|---|---|
| Claude cannot reach the server | Copy the MCP server URL again with the Copy button. The URL must be the one on the MCP Server page of this connector. |
| Sign-in does not start, or fails | The OAuth client ID must be exactly hexasync-mcp and the client secret must be blank. |
| You cannot add the connector on a Team or Enterprise plan | An owner of the Claude organization must add the connector first. Members can connect after that. |
| An older order is not found | The order tools only return orders of the last 60 days. |
| Claude connects but returns no store data | Open the connector in HexaSync and check that Shopify still shows Connected. If not, re-authorize it as the connection guide shows. |
If the problem remains, contact the HexaSync team with the name of your connector and the message Claude shows.
Frequently asked questions
Can the AI client change data in my Shopify store?
No. Access through the HexaSync MCP Server is read-only. The AI client can read orders, sales, products, collections and inventory, and no tool can create, change or delete anything in Shopify.
Do I need an OAuth client secret?
No. Paste the OAuth client ID hexasync-mcp and leave the client secret blank. You then sign in with your Beehexa Account when Claude asks you to connect.
Which AI clients can I connect?
The MCP Server page in HexaSync has steps for Claude, Claude Code, Codex CLI and other AI clients that support the Model Context Protocol (MCP). The Claude steps work in Claude on the web and in Claude Desktop.
Can the AI client see customers’ phone numbers or emails?
No. The tools of the HexaSync MCP Server do not give customers’ contact details, such as phone numbers and emails, to the AI client, even when Shopify stores them.
Can I use the same MCP server URL for another store?
No. Each Shopify connector in HexaSync has its own MCP Server page and its own MCP server URL. To connect another store, open that store’s connector and copy the URL shown there.