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 issued an MCP API key from the dashboard. 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 orders_list 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.

Shopigent will show a confirmation prompt in the app before the discount is created. Approve it, and 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