Set up Shopify Dev MCP Server

The Shopify Dev MCP Server is an official tool built by Shopify and part of the Shopify AI Toolkit. MCP stands for Model Context Protocol, an open standard that lets AI assistants such as Claude Code, Cursor, or Codex access structured external information and actions directly, instead of relying solely on their internal training knowledge. For Shopify specifically, this means the server connects the AI assistant to current Shopify developer documentation, the GraphQL schemas of the Admin and Storefront APIs, and validation tools for Liquid templates and app extensions, so developers do not have to guess which fields or commands are currently valid.

Why a dedicated MCP server for Shopify makes sense

Shopify development depends heavily on platform-specific detail, such as which API version is currently supported or what a configuration field in an app extension must be named. General web search or a language model's built-in knowledge quickly goes stale here, since schemas and best practices can change with every Shopify release. The Dev MCP server closes that gap by giving the assistant fresh access to official reference documentation on every request. According to the provider, this makes it possible to validate GraphQL queries against the real schema, check Liquid code, and even prepare larger migration tasks such as upgrading a checkout extension to a newer API version in an automated way.

Requirements

According to the provider, using the server requires Node.js version 18 or higher, since it ships as an npm package and is typically launched via npx. Supported clients include Claude Code, Codex, Antigravity CLI, Cursor, and Visual Studio Code; a few other environments only offer access through a plugin. No Shopify account or credentials are needed for the Dev MCP server itself, because it works exclusively with public developer documentation and schema information and does not connect to any specific store.

Step-by-step setup

Shopify recommends installing it through a plugin that bundles the whole AI Toolkit and updates itself automatically. Anyone who wants only the MCP server can instead register it directly in their development environment, for example in Claude Code via a command that registers the server under the name shopify-dev-mcp, running it with npx against the dev-mcp package. After restarting the development environment, the server is ready and gets pulled in automatically whenever questions about Shopify APIs, GraphQL schemas, or Liquid syntax come up. Alternatively, individual agent skills can be installed if only specific capabilities, such as Admin API support, are needed.

Security and limitations

The server runs locally on the developer's own machine and, according to the provider, requires no authentication because it only serves publicly accessible documentation and schema metadata rather than processing real store data such as orders or customer records. For tasks that actually touch a live store, such as managing products through the Shopify CLI, Shopify explicitly states that users decide when a prepared action is actually executed; the server drafts suggestions but does not run them on its own. It is also worth distinguishing this server from other Shopify MCP products: the Dev MCP server targets developers building code and apps, while the separate Storefront MCP server is intended for shoppers going through a purchase flow. The two should not be confused.

Practical benefit

In practice, the Dev MCP server mainly reduces errors caused by outdated or hallucinated API knowledge, because requests can be checked live against current schemas. Especially for recurring migration tasks, such as upgrading extensions to new API versions, the provider states that the server can handle much of the repetitive work, while developers still need to review and test the result. It does not replace code review, but it substantially cuts down the time spent looking up correct syntax and field names.