Shopify 저장소에 Claude를 직접 연결하는 모델 Context Protocol (MCP) 서버. 제품 관리, 주문, 고객, 컬렉션, 재고, 성취 - 모든 자연 언어를 통해.

---

당신이 이것을 할 수있는 것

연결되면 Shopify 저장소에 대화 할 수 있습니다.

• • “오늘의 모든 unfulfilled 주문보기”*
• • “여름 티셔츠, 가격 € 29.99, 초안으로 설정”*
• • “많은 활성 제품은 우리가 가지고 있습니까?”*
• • "이메일 [email protected]"으로 고객 검색 *
• • “제품 123 ~ 50 단위의 재고를 업데이트”*

---

요구 사항

• Python 3.11 이상
• Shopify 가게 (모든 플랜)
• Claude.ai Pro, 팀, 또는 기업 계정 ( 먼 MCP 연결을 위해)

---

1 단계 — Shopify 자격 증명 받기

두 가지가 필요합니다. store name 및 Admin API 액세스 토큰.

가게 이름 찾기

가게 이름은 .myshopify.com의 일부입니다. 예: 관리자 URL이 https://acme-store.myshopify.com/admin인 경우, 저장 이름은 acme-store입니다.

사용자 정의 앱을 만들고 액세스 토큰을 받으세요

⚠️ ** 중요 : ** 일반 Shopify API 키가 작동하지 않습니다.

Shopify MCP Server

A Model Context Protocol (MCP) server that connects Claude directly to your Shopify store. Manage products, orders, customers, collections, inventory, and fulfillments — all through natural language.

---

What you can do with this

Once connected, you can talk to your Shopify store like this:

• “Show me all unfulfilled orders from today”
• “Create a new product called Summer T-Shirt, price €29.99, set it to draft”
• “How many active products do we have?”
• “Search for customers with the email [email protected]”
• “Update inventory for product 123 to 50 units”

---

Requirements

• Python 3.11 or higher
• A Shopify store (any plan)
• A Claude.ai Pro, Team, or Enterprise account (for remote MCP connections)

---

Step 1 — Get your Shopify credentials

You need two things: your store name and an Admin API access token.

Find your store name

Your store name is the part before .myshopify.com. Example: if your admin URL is https://acme-store.myshopify.com/admin, your store name is acme-store.

Create a Custom App and get your access token

⚠️ Important: A regular Shopify API key will NOT work. You need an Admin API access token from a Custom App. Follow these steps exactly.

1. Go to Shopify Admin → Settings → Apps and sales channels
2. Click Develop apps in the top right corner
3. If prompted, click Allow custom app development
4. Click Create an app, give it a name (e.g. MCP Server), click Create app
5. Go to the Configuration tab → click Configure Admin API scopes
6. Enable the scopes you need. For full access, select:
   • read_products, write_products
   • read_orders, write_orders
   • read_customers, write_customers
   • read_inventory, write_inventory
   • read_fulfillments, write_fulfillments
   • read_webhooks, write_webhooks
7. Click Save
8. Go to the API credentials tab → click Install app → confirm
9. Click Reveal token once and copy the token immediately — it starts with shpat_

💡 Shopify only shows this token once. If you lose it, go back to API credentials, uninstall the app, then reinstall to generate a new one.

---

Step 2 — Set up the server locally

Clone this repo

git clone https://github.com/daanjonk/shopify-mcp.git
cd shopify-mcp

Install dependencies

pip install -r requirements.txt

Configure your environment variables

cp .env.example .env

Open .env and fill in your values:

SHOPIFY_STORE=your-store-name
SHOPIFY_ACCESS_TOKEN=shpat_xxxxxxxxxxxxxxxxxxxx

Only these two are required. Leave everything else as-is.

Run the server

python server.py

You should see output like:

INFO  Token mode: static SHOPIFY_ACCESS_TOKEN (no auto-refresh)
INFO  Uvicorn running on http://0.0.0.0:8000

Your MCP server is running at http://localhost:8000/mcp.

---