Shopigent Shopigent

Connect Claude to your store

This guide shows how to connect Claude (Desktop or Code) to Shopigent's MCP endpoint.

Prerequisite: You've installed Shopigent and generated a connection key on the dashboard. The button is Generate connection key, or Regenerate connection key when one already exists. See Getting Started.

1. Add the MCP server

Add Shopigent to your Claude MCP configuration (claude_desktop_config.json or ~/.claude/mcp.json):

{
  "mcpServers": {
    "shopigent": {
      "url": "https://mcp.shopigent.greeknous.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

2. Verify the connection

Ask Claude something read-only first:

List my 5 most recent orders with customer name and total.

Claude should call list_orders and return real data from your store.

3. Example prompts for Claude

Explore your store

Describe my store: how many products, customers, orders, and active discounts? 
Use the appropriate tools one at a time.

Show me a dashboard: my top 3 products by revenue this month, my 3 lowest-stock 
items, and how many pending orders I have — all in one response.

Merchandising

Find 5 products with no meta description. For each one, draft a compelling 
meta description based on its title and tags. Show me the drafts, then 
update them if I approve.

Which products in my store are tagged "clearance" but still at full price? 
List them with options to mark them down.

Customer insights

Who are my top 5 customers by total spend? Show name, email, order count, 
and total spent. Don't change anything — just report.

I want to send a birthday promo. List customers with birthdays this month, 
their email, and their favourite product category based on purchase history.

4. Try a write action (Growth/Pro)

Create a 10% discount code SUMMER10 valid until end of month for all products.

create_discount ships with confirmation off, so this example can run as soon as the Discounts category is enabled on a paid plan. Turn on Require confirmation for that tool if you want your AI client to pause first. Approval happens in the AI client, or on the Confirmations page in the Shopigent admin. That page lists the stored arguments with secrets and contact-shaped values redacted, and it does not show the token. Then check the audit log.

Bulk operations (always dry-run first)

Dry-run: set the price of all products tagged "sale" to 20% off their current 
price. Show me the before/after for 3 examples before executing.

Troubleshooting