Shopigent Shopigent

Getting Started with Shopigent

This guide walks you through connecting an AI agent to your Shopify store with Shopigent.

1. Install

Install Shopigent from the Shopify App Store and grant the scopes your store needs.

2. Enable tool categories

Open the Curated Tools dashboard in the app. Each category (Products, Orders, Customers, etc.) has a toggle — enable only what you want your agent to access.

3. Issue an MCP API key

From the dashboard, generate an MCP API key. The plaintext key is shown once — store it securely. Shopigent stores only a hash.

4. Connect your AI agent

Now that you have an API key, choose your tool and follow the dedicated guide:

Or read the Prompts & Best Practices guide for tips and examples.

5. Confirmation gate

Any destructive action (create, edit, delete, refund) triggers a confirmation prompt. Approve it to proceed. Every action is recorded in the audit log.

Reauthorizing after an app update

When Shopigent ships a new scope (e.g. the read_files and write_files pair from a recent update), already-installed stores need to reauthorize the app before the new tool becomes available. Here is the lifecycle:

  1. Deploy. The app update ships with the new scope declared in its configuration.
  2. Detect. The Scopes & Permissions page shows the scope as Not yet granted and lists the exact missing handle.
  3. Grant. Click Enable new scopes — this redirects to the Shopify install screen. Your store sees the exact new permissions requested.
  4. Approve. Shopify asks you to confirm the new permissions. Approve to complete reauthorization.
  5. Persist. The app stores the updated grant and verifies it against a live Shopify snapshot.
  6. Refresh. Capability caches are invalidated. The Curated Tools page updates instantly — uploadProductMedia changes from a warning badge to a green "available" state.
  7. Verify. The tool is now executable. Retry the agent call with the same full payload.

Enabled vs. granted: The checkbox toggle in Curated Tools controls whether a tool shows up in the control panel. It does not add or remove Shopify OAuth scopes. A tool can be enabled in Shopigent but unavailable until the store grants the underlying permission. The dashboard shows both states independently.

Next steps