Why the Shopify Dev Toolkit Matters

Building on Shopify used to mean juggling the admin, a code editor, and a dozen browser tabs. The modern Shopify dev toolkit — the CLI, the Dev MCP server, and the developer docs integration — pulls all of that into your terminal and your AI assistant. Here's how to switch it on.

Step 1: Install the Shopify CLI

The CLI is the foundation. On macOS with Homebrew:

• Install Node.js 18 or newer
• Run the Shopify CLI install (npm install -g @shopify/cli or the Homebrew formula)
• Verify with shopify version

The CLI scaffolds themes, apps, functions, and extensions, and handles login to your store and Partner account.

Step 2: Authenticate

Run shopify auth login to connect your Partner account, then shopify theme dev or shopify app dev to spin up a local preview against a development store. Development stores are free from the Partner Dashboard.

Step 3: Enable the Shopify Dev MCP Server

The Model Context Protocol (MCP) server lets an AI assistant read Shopify's live documentation and GraphQL schemas so it stops hallucinating field names. Add the Shopify Dev MCP server to your assistant's config (Claude Code, Cursor, or VS Code), point it at the official endpoint, and restart the editor. Your assistant can now look up the current Admin and Storefront GraphQL schemas on demand.

Step 4: Scaffold Your First Project

With the toolkit live, try:

• shopify theme init for a new theme
• shopify app init for an embedded app
• shopify app generate extension for checkout UI, functions, or admin blocks

Each command wires up the right folder structure, config, and dev server.

Step 5: Use Functions and Extensions

Shopify Functions let you customize backend logic — discounts, delivery, payment rules — in Rust or JavaScript, deployed straight from the CLI. Combine them with UI extensions to add branded content to checkout without touching the core.

A Sensible Daily Workflow

1. Pull the store locally with the CLI 2. Let your MCP-connected assistant draft queries against the real schema 3. Preview live with hot reload 4. Deploy with a single command

Common Setup Gotchas

• Node version mismatches break the CLI — pin it with nvm
• MCP servers need a full editor restart to load
• Development stores can't process real payments; use test mode

--- Setting up a Shopify development environment or building a custom app? ANF STUDIO ships Shopify apps, themes, and functions end to end. Talk to our dev team.