shopify-mcp

Shopify MCP Integration Guide

Model Context Protocol (MCP) servers connect Claude to Shopify data and operations. There are three deployment patterns: Shopify Dev MCP (developer-centric), Storefront MCP (merchant-centric), and custom MCPs (specialized workflows). This guide covers setup, configuration, implementation patterns, and agentic commerce use cases.

Shopify Dev MCP: Developer Tools for Claude Code

Shopify Dev MCP is a read-only developer toolkit integrated into Claude Code. It provides access to admin APIs, schema introspection, development store management, and app testing utilities without building a custom MCP.

Installation and Setup

The Shopify Dev MCP is installed via command-line setup:

npx -y @shopify/dev-mcp setup

This command:

1. Prompts for Shopify organization/store selection
2. Creates a development app or reuses existing one
3. Stores authentication tokens securely in system keychain
4. Registers the MCP server in ~/.claude.json/mcpServers
5. Restarts Claude Code to load the new MCP

No additional configuration is required post-setup. The MCP automatically handles token refresh and scope validation.

Claude Code Configuration

After setup, ~/.claude.json/mcpServers contains:

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": ["-y", "@shopify/dev-mcp", "run"],
      "env": {
        "SHOPIFY_AUTH_TOKEN": "shpat_...",
        "SHOPIFY_STORE": "dev-store-name.myshopify.com",
        "SHOPIFY_ORG_ID": "gid://shopify/Organization/12345"
      }
    }
  }
}

Manual configuration is unnecessary unless you need environment-specific tokens or custom server paths. For advanced setups (air-gapped networks, custom HTTP proxies), edit the env dict directly.

Dev MCP Capabilities

The Shopify Dev MCP provides these read-only tools:

Admin API Query Tool

• Execute GraphQL queries against the API version configured for the connected development store
• Full schema support (Products, Orders, Customers, Fulfillments, Inventory, etc.)
• Automatic scope validation (app must have required scopes)
• Response size limit: 5MB per query
• Query complexity limit: 100 points (Admin API default)