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

``bash
npm install
cp .env.example .env
`

Configuration

Edit .env:

`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

$3

`bash
npm run dev
`

$3

`bash
npm run build
npm start
`

$3

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

Tools Reference

$3

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) |

$3

List product categories.

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

$3

List orders with optional status filter.

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

$3

Update product stock levels. Requires confirmation.

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

$3

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