Shopify reconnect

Signs of a dropped Shopify connection

• !The Operator created an escalation card mentioning shopify-admin.
• !The activation checklist shows the Analyst, Support, or Bookkeeper MCP step as red.
• !The Analyst report is missing revenue data or shows zero orders.
• !Support replies lack order context (no tracking details, no order amounts).

Step 1: Check the current connection

claude mcp list

Look for shopify-admin in the list. If it shows error ordisconnected, proceed to step 2. If it is absent entirely, proceed to step 3.

Step 2: Get a new API token

1. Log in to your Shopify admin.
2. Go to Settings → Apps and sales channels → Develop apps.
3. Find the FlostackOS app (or your named private app) and open it.
4. Under API credentials, rotate the Admin API access token.
5. Copy the new token immediately. It is only shown once.

If the app was deleted, create a new private app with the same permissions:read_orders,read_products,read_finances.

Step 3: Re-register the connection

claude mcp add shopify-admin --key YOUR_NEW_TOKEN

This overwrites the previous credentials. No other configuration changes are needed.

Step 4: Verify

claude mcp list

The shopify-admin entry should now show as connected. The Operator health check runs every 2 hours and will update the activation checklist automatically.

If you want to verify immediately, you can trigger an Operator run manually from the portal: Dashboard → Event log → Run Operator now.

If the connection drops repeatedly

Shopify rotates tokens when an app is re-installed or permissions are changed. If the connection drops every few days, check whether another team member or an app is rotating the private app credentials. Consider creating a dedicated FlostackOS private app that only this integration uses.