Your connection path

Shopify

Your AI

Stacksync MCP OAuth

Your assistant works through your Stacksync workspace and its available connections.

First request

“Plan an order-reporting replica”

Stacksync MCP · Commerce

Shopify MCP integration.

Use Stacksync MCP to prepare Shopify order and product syncs, inspect connector actions and investigate failed updates. Start with the store connection and supported objects, then choose the data and write direction needed for the commerce workflow.

Connector actionsSync management

Start using Stacksync MCP Explore example prompts

01 / The connection

What Shopify can do through MCP

The server belongs to Stacksync. The available Shopify operations depend on your connection, permissions, and connector modules.

Explore the Shopify connector →

Claude Claude Code ChatGPT Codex Cursor VS Code Windsurf Gemini CLI

02 / Capabilities

Shopify capabilities through MCP

Choose the connection path that fits the job. Your assistant inspects the available tools before configuring or running an action.

Sync management

Plan order and customer reporting

Prepare mappings for supported order and customer objects, with store identifiers and an explicit destination.

Connector actions

Inspect product actions

Discover available Shopify modules and their input forms before proposing a product or variant operation.

Sync management

Troubleshoot commerce syncs

Review failed records, connection access and object mappings before retrying an order or product update.

03 / Setup

Set up your AI client

Connect the MCP server first. Then connect Shopify using the requirements below.

One connection. Your workspace.

Bring your AI assistant.

Add Stacksync’s MCP server, sign in with OAuth, and choose your workspace. Your assistant works with your Stacksync permissions.

https://mcp.stacksync.com/mcp

Create a Stacksync account

Already have an account? Sign in when your assistant opens the authorization page. Choose read-only access if you only need to inspect your workspace.

Chat assistantClaude

Connect Claude on the web or desktop to Stacksync through a custom connector and browser sign-in.

Before you start

A Stacksync account with access to the workspace you want to use.
Permission to add an external MCP server in your AI client.
On a Claude Team or Enterprise account, an owner must first add Stacksync under Organization settings → Connectors.

Add a custom connector
Open Customize → Connectors, select + Add, then Add custom connector. Name it Stacksync and use the server URL below.
```
https://mcp.stacksync.com/mcp
```
Connect your Stacksync account
Select Connect, complete the Stacksync sign-in in your browser and choose the default workspace. Clear Make changes on the consent screen if you only want read access.
Check your workspace
Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available Shopify connection and capabilities.

Full setup documentation ↗

TerminalClaude Code

Add the remote Stacksync server to Claude Code and authenticate from its MCP menu.

Before you start

A Stacksync account with access to the workspace you want to use.
Permission to add an external MCP server in your AI client.
Claude Code installed with the claude command available in your terminal.

Add Stacksync over HTTP
Run the command below. Add --scope user if you want the connection available across your projects.
```
claude mcp add --transport http stacksync https://mcp.stacksync.com/mcp
```
Finish browser sign-in
Open Claude Code, run /mcp, select stacksync and complete the Stacksync sign-in. Choose the workspace you want requests to use by default.
Check your workspace
Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available Shopify connection and capabilities.

Full setup documentation ↗

Chat assistantChatGPT

Add Stacksync as a custom MCP app in ChatGPT and sign in with OAuth.

Before you start

A Stacksync account with access to the workspace you want to use.
Permission to add an external MCP server in your AI client.
A ChatGPT account with Developer mode and custom MCP apps available. The Stacksync guide lists Plus, Pro, Business, Enterprise and Edu; workspace administrators can restrict access.

Enable custom app setup
Open Settings → Apps → Advanced settings and turn on Developer mode. If the option is unavailable, check the account or workspace policy with your administrator.
Create the Stacksync app
Select Create app, name it Stacksync, enter the server URL below and choose OAuth. Complete the Stacksync sign-in and select your default workspace.
```
https://mcp.stacksync.com/mcp
```
Enable Stacksync in your chat
Select Stacksync from the chat tools menu so the conversation can use its tools. Signing in to ChatGPT itself does not sign you in to Stacksync.
Check your workspace
Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available Shopify connection and capabilities.

Full setup documentation ↗

TerminalCodex

Configure Stacksync in Codex with a remote MCP URL and an explicit OAuth login.

Before you start

A Stacksync account with access to the workspace you want to use.
Permission to add an external MCP server in your AI client.
Codex CLI installed with the codex command available.

Register the remote server
Add the Stacksync endpoint to your Codex MCP configuration.
```
codex mcp add stacksync --url https://mcp.stacksync.com/mcp
```
Sign in with OAuth
Run the login command and complete the Stacksync browser sign-in. Select a default workspace; restart your Codex session if the tools are not yet listed.
```
codex mcp login stacksync
```
Check your workspace
Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available Shopify connection and capabilities.

Full setup documentation ↗

Code editorCursor

Use Stacksync from Cursor by adding a remote server to its MCP configuration.

Before you start

A Stacksync account with access to the workspace you want to use.
Permission to add an external MCP server in your AI client.
Cursor installed with permission to configure MCP servers.

Add the server configuration
Merge this stacksync entry into the mcpServers object in ~/.cursor/mcp.json. Preserve any servers you already use.
```
{
  "mcpServers": {
    "stacksync": {
      "url": "https://mcp.stacksync.com/mcp"
    }
  }
}
```
Connect from Cursor
Open Cursor’s MCP settings, select Connect beside stacksync and finish the Stacksync sign-in in your browser.
Check your workspace
Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available Shopify connection and capabilities.

Full setup documentation ↗

Code editorVS Code

Connect Stacksync to GitHub Copilot Chat in VS Code using an HTTP MCP server.

Before you start

A Stacksync account with access to the workspace you want to use.
Permission to add an external MCP server in your AI client.
VS Code with Copilot Chat Agent mode available.

Add Stacksync to VS Code
Run the command below. Alternatively, add a stacksync entry with type http and this URL under servers in your project’s .vscode/mcp.json.
```
code --add-mcp '{"name":"stacksync","type":"http","url":"https://mcp.stacksync.com/mcp"}'
```
Start it in Copilot Chat
Open Copilot Chat in Agent mode. Start stacksync from the tools picker and complete the Stacksync browser sign-in.
Check your workspace
Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available Shopify connection and capabilities.

Full setup documentation ↗

Code editorWindsurf

Add Stacksync to Cascade with Windsurf’s serverUrl configuration and OAuth sign-in.

Before you start

A Stacksync account with access to the workspace you want to use.
Permission to add an external MCP server in your AI client.
Windsurf installed with Cascade and MCP configuration available.

Open the MCP configuration
In the Cascade panel, open the … menu and select Open MCP config file. Merge this entry into mcp_config.json without removing other servers.
```
{
  "mcpServers": {
    "stacksync": {
      "serverUrl": "https://mcp.stacksync.com/mcp"
    }
  }
}
```
Authorize the first connection
Save the configuration. Cascade opens the Stacksync sign-in flow the first time it uses the server. Choose your default workspace.
Check your workspace
Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available Shopify connection and capabilities.

Full setup documentation ↗

TerminalGemini CLI

Connect the Gemini command-line client to Stacksync through remote HTTP MCP and browser authorization.

Before you start

A Stacksync account with access to the workspace you want to use.
Permission to add an external MCP server in your AI client.
Gemini CLI installed with the gemini command available. These instructions apply to Gemini CLI, not the Gemini web app.

Register Stacksync
Run the following command in your terminal to add the HTTP server.
```
gemini mcp add --transport http stacksync https://mcp.stacksync.com/mcp
```
Authenticate inside Gemini CLI
Start Gemini CLI, run the command below and finish the Stacksync sign-in in your browser.
```
/mcp auth stacksync
```
Check your workspace
Ask “List my Stacksync workspaces.” Confirm the workspace before choosing a connector or preparing a change. Connecting the assistant does not start a sync.

Check the connection

Ask “List my Stacksync workspaces.” Select the workspace you want to use, then ask the assistant to inspect the available Shopify connection and capabilities.

Full setup documentation ↗

04 / Put it to work

Shopify workflow prompts

Example prompts for Shopify. The outcomes describe what to expect, not results from your account. Review the proposed configuration before running it.

Sync management

Plan an order-reporting replica

Inspect my Shopify and database connections and any existing order sync. Discover the available order and customer fields, then propose a one-way reporting replica with store IDs, stable record keys and the minimum customer data needed. Show the initial-copy scope and permissions before creating or starting anything.

What to expect

A store-specific order reporting plan with explicit customer-data boundaries.

Connector actions

Prepare a product maintenance task

Inspect the available Shopify actions and the connection to the store I choose. Determine whether the product lookup and update needed for my request are supported. Show the required identifiers and a proposal for the selected fields only, keeping product and variant identifiers distinct. Do not update the store until I confirm the exact changes.

What to expect

A product action proposal based on available modules and correct record identifiers.

Sync management

Investigate Shopify sync errors

Inspect my Shopify sync issues and current table mappings. Group failures by access, field validation or unsupported operations, and show affected record IDs. Propose the smallest correction and explain the consequences of retrying or ignoring each group. Do not replay, resolve or change records automatically.

What to expect

A targeted commerce sync recovery plan with the affected records identified.

05 / Before you run

Requirements and limitations

What you need

Connect your AI client to Stacksync MCP, sign in and select the workspace before inspecting its resources.
Reuse an authorized app connection or open the secure connection link from Stacksync. Enter credentials in the connection form, never in the chat.
Verify Shopify app permissions and access to the selected store data, including any protected customer-data requirements.

What to account for

Available actions depend on the live connector catalog, your connected account and MCP Gateway Policies. Inspect the action and its form before using it.
The published sync list includes Products, ProductMedias, ProductVariants, Orders, Customers and Abandoned Checkouts. Do not assume other commerce objects are covered.
Sync support for an object does not establish every refund, fulfillment or inventory action. Verify those operations separately in the live catalog.

Your workspace. Your permissions.

OAuth access follows your Stacksync role. Choose read-only access during sign-in when appropriate. Workspace owners can enable “Ask before every change”; it is a configurable setting. Direct connector actions also follow gateway policies.

Read about permissions and approvals ↗

If setup does not work

The MCP server does not appear: Check your client’s custom MCP settings and any plan or administrator prerequisites. Reconnect using the setup instructions above.
Your workspace or app is missing: Verify the Stacksync account and workspace selected during OAuth, then inspect the workspace’s connections. Add missing app credentials through the secure connection flow.
An action is unavailable or denied: Inspect the current connector modules and required inputs. Check your workspace role, read-only consent, gateway policy, and the source app’s API permissions.

06 / Common questions

Shopify MCP questions

Which Shopify objects can I plan a sync for?

The published list includes products, product media, variants, orders, customers and abandoned checkouts. Confirm that the connected store exposes the fields and permissions required for your mapping.

Does an order sync provide every Shopify order action?

No. Syncing an object and invoking a direct action are different capabilities. Inspect live modules before promising refunds, fulfillment changes or another specific operation.

Can I limit the customer information used in reporting?

Yes. Start by selecting only the fields needed for the report and verify the Shopify connection’s access. The sample prompts ask for those boundaries before proposing a sync.

Reviewed 2026-10-21 · Product documentation and connector references

Keep building

Connect the rest of your stack.

CRM

Shopify MCP integration.

What Shopify can do through MCP

Plan order and customer reporting

Inspect product actions

Troubleshoot commerce syncs

Before you start

Add a custom connector

Connect your Stacksync account

Check your workspace

Check the connection

Before you start

Add Stacksync over HTTP

Finish browser sign-in

Check your workspace

Check the connection

Before you start

Enable custom app setup

Create the Stacksync app

Enable Stacksync in your chat

Check your workspace

Check the connection

Before you start

Register the remote server

Sign in with OAuth

Check your workspace

Check the connection

Before you start

Add the server configuration

Connect from Cursor

Check your workspace

Check the connection

Before you start

Add Stacksync to VS Code

Start it in Copilot Chat

Check your workspace

Check the connection

Before you start

Open the MCP configuration

Authorize the first connection

Check your workspace

Check the connection

Before you start

Register Stacksync

Authenticate inside Gemini CLI

Check your workspace

Check the connection

Plan an order-reporting replica

What to expect

Prepare a product maintenance task

What to expect

Investigate Shopify sync errors

What to expect

What you need

What to account for

Your workspace. Your permissions.

If setup does not work

Shopify MCP questions

Salesforce

HubSpot

NetSuite