Shopware 6 MCP Server

MCP server for Shopware 6 e-commerce platform integration.

Features

• get_products - Query products with filters
• get_categories - List product categories
• get_orders - List orders with status
• update_stock - Update inventory levels (with confirmation)
• save_descriptions - Save product descriptions (with confirmation)

Installation

npm install
cp .env.example .env

Configuration

Edit .env:

# AI Integration API
API_URL=wss://api.ai-integration.com
API_TOKEN=sk_live_your_token_here

# Shopware 6 Admin API
SHOPWARE_URL=https://your-shop.com
SHOPWARE_CLIENT_ID=your_client_id
SHOPWARE_CLIENT_SECRET=your_client_secret

To get Shopware API credentials:

1. Go to Settings > System > Integrations
2. Create new integration with Admin API access
3. Copy Client ID and Client Secret

Usage

Development

npm run dev

Production

npm run build
npm start

Docker

docker build -t mcp-shopware .
docker run --env-file .env mcp-shopware

Tools Reference

get_products

Query products from the catalog.

Parameters: | Name | Type | Description | |------|------|-------------| | categoryId | string | Filter by category ID | | search | string | Search in product name | | active | boolean | Filter by active status | | limit | number | Max results (default: 25) |

get_categories

List product categories.

Parameters: | Name | Type | Description | |------|------|-------------| | parentId | string | Filter by parent category | | active | boolean | Filter by active status |

get_orders

List orders with optional status filter.

Parameters: | Name | Type | Description | |------|------|-------------| | status | string | Filter: open, in_progress, completed, cancelled | | limit | number | Max results (default: 25) |

update_stock

Update product stock levels. Requires confirmation.

Parameters: | Name | Type | Required | Description | |------|------|----------|-------------| | updates | array | Yes | [{productId, stock}] | | confirmed | boolean | Yes | Must be true to update |

save_descriptions

Save product descriptions. Requires confirmation.

Parameters: | Name | Type | Required | Description | |------|------|----------|-------------| | items | array | Yes | [{productId, description}] | | confirmed | boolean | Yes | Must be true to save |

API Permissions

Required Shopware integration permissions:

• Products: read, write
• Categories: read
• Orders: read
• Inventory: write

License

MIT