Connections and permissions
A connection defines which ShopMCP features an AI client can call. Create separate connections for different tasks and people. Start with read access.
Skill settings are workflow instructions. They do not change Shopify scopes or restrict MCP tools that are already allowed. For a reliable read-only analysis, the connection itself must have read-only access. Shopify app permissions and the signed-in staff account also limit every call.
API keys use the installed ShopMCP app permissions for the store together with the connection's permissions. They do not inherit an individual Shopify staff member's permissions. OAuth connections remember who approved them and with which Shopify access scopes. When the store owner connects, the connection works like an API key with the connection's permissions; logging out of the Shopify admin does not disconnect it. It lasts up to 90 days from approval as long as it is used at least every 30 days. When a staff or collaborator account connects, Shopify additionally limits access to the scopes that person had when connecting; finer staff permissions below the scope level are not enforced by Shopify in this case.
Only the store owner manages API keys, connections that have an API key, connections created by someone else, skills and the theme archive, because a key passes on the app access of the whole store. Staff and collaborator accounts can create connections without an API key that work through OAuth only, and they manage those connections themselves: they can change permissions, limits and API operations, pause and delete them, and revoke connected clients. Saved changes reach their own connected AI client without reconnecting. This stays bounded by their own Shopify permissions, because every call runs with the scopes that person had when connecting. Once the owner generates an API key for such a connection, it becomes owner-managed. Connections from older versions without a recorded creator can be managed by any staff account, and staff see all other connections read-only. They add the connector URL https://shopmcp.app/mcp in their AI client, sign in with their own Shopify login and choose the connection. Access is always the intersection of the person's Shopify scopes at the time of connecting, the connection permissions and the consent they gave. A staff connection lasts at most 7 days from consent and must then be reconnected; if Shopify cannot issue a restricted token, it ends with the person's Shopify session after 24 hours at the latest. When you remove a staff account in Shopify, also revoke its client under "Connected apps" in the connection.
Advanced connection limits can separately restrict product content, prices, media, customer-data tools, and refunds. Price changes require both product-content and price approval. Refunds are also capped at the exact declared total amount. Batches are limited to 250 entries. Inventory locations and metafield namespaces can be restricted with allowlists.
When customer-data access is disabled, structured customer, contact, and address fields are removed from tool responses. Free-text fields can still contain personal information. Review those contents carefully too.
Disable or revoke connections that are no longer used. Review connection permissions and the audit log regularly. Do not share API keys in prompts or screenshots.