Troubleshooting & FAQ

Connection issues

401 Unauthorized The API key is invalid or revoked. Generate a new key in the dashboard and update your MCP client config. Remember: keys are shown only once.

MCP client can't find the server Check the endpoint URL and that your client actually reloaded its config (Cursor and Claude Desktop need a full restart).

Missing or failing tools

A tool doesn't appear in the tools list The category is toggled off in Curated Tools, or your plan doesn't include it (e.g. theme tools require Pro).

plan_upgrade_required error The tool exists but your plan is read-only for it. See Plans & Billing.

rate_limited error You hit the daily call allowance (Free 25/day, Growth 500/day). The error includes the reset time (midnight UTC).

Confirmation gate

"Action pending confirmation" — nothing happens The action is waiting for approval in the Shopigent dashboard. Open the app in Shopify admin and approve or reject it.

Can I turn off confirmations? No — that's deliberate. Every destructive action requires human approval. Use dry_run for previews instead.

General

Does Shopigent work with any MCP client? Yes — anything that speaks Model Context Protocol: Claude, Cursor, Hermes, custom agents.

Can agents see data in disabled categories? No. Disabled categories aren't listed to the agent at all.

Where do I see what my agent did? The Audit Log in the dashboard — every call with input, result, and latency.

How do I completely revoke an agent's access? Revoke its API key. Effect is immediate.

Still stuck? Email shopigent@greeknous.com.