MCP Server: Shopware 6 Admin API
MCP server for the Shopware 6 Admin API with 42 tools: products, content with configurable style profiles, SEO, media, mail templates, flows, orders (read only), cross-selling and SEO URLs.
MCP Server: Shopware 6 Admin API
This documentation always describes the current state of the main branch.
Status: the successor of this server is Sylius Admin. According to its README Shopware is no longer in use. This server's GitHub repository is not archived and itself contains no note about a replacement.
Overview
claude-mcp-shopwareadmin is an MCP (Model Context Protocol) server through which Claude operates the Admin API of a Shopware 6 shop. It provides 42 tools: create and change products, prepare and save descriptions and SEO data, categories, media with alt text audit, mail templates, flows, orders (read only), cross-selling and SEO URLs.
Claude handles shop maintenance directly in the shop, without copy and paste and without switching to the browser. Products are always created inactive, and orders can only be read.
The division of labour: you create variants and images in the Shopware admin, Claude takes over texts, SEO and administration. The content tools do not write text themselves, they provide context and instructions from configurable style profiles, and Claude writes the texts.
graph LR
A["Claude Code"] -->|stdio| B["MCP server shopwareadmin"]
B -->|OAuth2 + Admin API| C["Shopware 6 shop"]
D["content-profiles.json"] --> B
Documentation
| Page | Content |
|---|---|
| Installation | Requirements, build, deployment, registering in Claude Code, update, uninstall |
| Configuration | Environment variables, Shopware integration, content profiles |
| Tool reference | All 42 tools with parameters, limits and return values |
| Usage | Typical workflows from product creation to SEO URL audit |
| Security and privacy | Credentials, token, protections, logging, data flows |
| Troubleshooting | Messages, causes, solutions and frequently asked questions |
| Technical details | Structure, request flow, cache, error format, development |
Features
| Feature | Description |
|---|---|
| Products | Create (always inactive), read, list, search, change, activate and deactivate, with tags, search keywords and custom fields |
| Content and SEO | Instructions for descriptions, SEO metadata and variant texts, saving with content_update |
| Content profiles | Tone, form of address, structure and target audience per style in a JSON file, assigned automatically through the product category |
| Categories | List, details with products, SEO texts and SEO fields |
| Media | List, search, change alt text and title, alt text audit for product images, upload from URL |
| Mail templates and flows | Read and change templates, send test mail, inspect flows and switch them on or off |
| Orders | List, details and statistics, read only |
| Cross-selling | Read, create and change groups and collect candidates for recommendations |
| SEO URLs | List, audit for deleted, duplicate and missing canonical URLs, change |
| Connectivity | OAuth2 client credentials, stdio transport, retry on token expiry and on 429 |
Requirements
| Requirement | Notes |
|---|---|
| Node.js | 20 or newer |
| Claude Code | Or another MCP client with stdio transport |
| Shopware 6 | Admin API reachable, integration with client ID and secret, see Configuration |
| Optional | Plugin providing the mmd-product-snippet entity for text snippets |
License
MIT License - License text on GitHub
Support
Repository: github.com/markus-michalski/claude-mcp-shopwareadmin
Issues: GitHub Issues