colbymchenry/shopify-graphql-admin-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

21 stars 4 forks Качество 59 Тренд 10

Repository Install

Connect Claude to your Shopify store, and unlock the full power of Claude for your store.

Обзор

MCP server providing full access to Shopify's Admin GraphQL API. Introspects the live schema on startup so it's always up-to-date with the latest API version — no stale docs, no embeddings needed. - — run any query or mutation against the Admin API - — search and explore the full GraphQL schema (2,700+ types) directly from your AI assistant - — typed, no-GraphQL-needed CRUD for products, collections, metaobjects, metafields, customers, orders, and inventory - — supports both OAuth client credentials (new Dev Dashboard apps) and legacy access tokens (shpat_) - — OAuth tokens are refreshed automatically before expiry Configure these scopes on your app to enable all tools: You only need scopes for the tools you plan to use. At minimum for schema introspection and raw GraphQL to work, you need at least one read scope. For apps created in the Shopify Dev Dashboard: 1. Create an app in the Dev Dashboard 2. Configure the Admin API scopes listed above 3.

README

Показан фрагмент оригинального README. Открыть оригинал.

shopify-graphql-admin-mcp

MCP server providing full access to Shopify’s Admin GraphQL API. Introspects the live schema on startup so it’s always up-to-date with the latest API version — no stale docs, no embeddings needed.

Features

Raw GraphQL execution — run any query or mutation against the Admin API
Live schema introspection — search and explore the full GraphQL schema (2,700+ types) directly from your AI assistant
29 convenience tools — typed, no-GraphQL-needed CRUD for products, collections, metaobjects, metafields, customers, orders, and inventory
Dual auth — supports both OAuth client credentials (new Dev Dashboard apps) and legacy access tokens (shpat_)
Auto token refresh — OAuth tokens are refreshed automatically before expiry

Quick Start

# With a legacy access token
npx shopify-graphql-admin-mcp --store mystore.myshopify.com --access-token shpat_xxxxx

# With OAuth client credentials (Dev Dashboard app)
npx shopify-graphql-admin-mcp --store mystore.myshopify.com --client-id YOUR_ID --client-secret YOUR_SECRET

Tools

Core

Tool	Description
`shopify_graphql`	Execute any raw GraphQL query or mutation
`shopify_schema_search`	Search the live schema by keyword (types, queries, mutations)
`shopify_schema_details`	Get full details for a specific type, query, or mutation

Products

Tool	Description
`shopify_products_list`	List/search products with pagination
`shopify_product_get`	Get product by ID with variants and metafields
`shopify_product_create`	Create a new product
`shopify_product_update`	Update an existing product
`shopify_product_delete`	Delete a product

Collections

Tool	Description
`shopify_collections_list`	List/search collections with pagination
`shopify_collection_get`	Get collection by ID with products
`shopify_collection_create`	Create a collection (manual or smart)
`shopify_collection_update`	Update a collection
`shopify_collection_delete`	Delete a collection

Metaobjects

Tool	Description
`shopify_metaobject_definitions_list`	List all metaobject type definitions
`shopify_metaobjects_list`	List entries of a specific metaobject type
`shopify_metaobject_get`	Get a single metaobject entry
`shopify_metaobject_create`	Create a new metaobject entry
`shopify_metaobject_update`	Update an existing metaobject entry
`shopify_metaobject_delete`	Delete a metaobject entry

Metafields

Tool	Description
`shopify_metafields_list`	List metafields on any resource
`shopify_metafields_set`	Set (upsert) metafields on any resource
`shopify_metafield_delete`	Delete a metafield

Customers

Tool	Description

Открыть полный README на GitHub

Установка

npx shopify-graphql-admin-mcp --store mystore.myshopify.com --access-token shpat_xxxxx

Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "shopify": {
      "command": "npx",
      "args": [
        "shopify-graphql-admin-mcp",
        "--store", "mystore.myshopify.com",
        "--access-token", "shpat_xxxxx"
      ]
    }
  }
}