Prerequisites

• Shopigent AI GEO installed on your Shopify store
• An MCP API key from Settings → MCP Storefront
• Claude Desktop or Claude Code

Step 1: Get Your MCP API Key

1. Open your Shopigent AI GEO dashboard
2. Go to Settings → MCP Storefront
3. Click Generate Key
4. Copy the key (shown once — store it securely)

Step 2: Configure Claude Desktop

Edit your Claude configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "shopigent-ai-geo": {
      "url": "https://discovery-app-production-4a32.up.railway.app/api/mcp",
      "headers": {
        "Authorization": "Bearer shpg_disc_your_key_here"
      }
    }
  }
}

Step 3: Restart Claude

After saving the configuration file, restart Claude Desktop. The MCP tools will be available automatically.

Step 4: Start Using It

Try these prompts with Claude:

• "What products are available in my store?"
• "What's the most popular product in my store?"
• "Compare my top 3 products by price and rating"
• "Are there any products on sale?"
• "What categories do my products belong to?"

Troubleshooting

Claude doesn't see the tools:

• Check the configuration file syntax (valid JSON)
• Make sure the API key is correct
• Restart Claude completely

"Invalid API key" error:

• Generate a new key from Settings → MCP Storefront
• Update the configuration file with the new key

Connection refused:

• Make sure the app is running (check health at /api/healthz)
• The URL should be the full endpoint including /api/mcp