shopware-admin

This MCP server provides AI-assisted access to Shopware Admin API capabilities for managing products, categories, sales channels, media, orders, and theme configurations. It exposes a range of tools that let you list, create, update, and delete entities, upload media by URL, and fetch schema or entity information to drive dynamic prompts. You can invoke tools like product_list to search products with pagination, product_create to add new products with pricing and media, category_create for bulk category operations, and upload_media_by_url to pull images directly from URLs. The server also supports theme changes per sales channel and order operations, enabling a cohesive assistant workflow for commerce tasks.

Prerequisites:

• Node.js 22+ (used by the MCP tooling and the Shopware Admin MCP)
• Access to a Shopware 6 instance with an admin integration that provides API credentials

Installation steps:

1. Install Node.js if not already installed. Visit https://nodejs.org/ and follow the installer for your platform.

2. Ensure you have an integration in Shopware Admin with permissions to manage products, categories, orders, media, and themes, and note the API URL, Client ID, and Client Secret.

3. Install or run the MCP server via npx as described in the repository usage. You can also install locally by adding the server to your mcp.json configuration:

claude mcp add shopware-admin-mcp \
  --env SHOPWARE_API_URL=https://your-shopware-instance.com \
  --env SHOPWARE_API_CLIENT_ID=your-integration-client-id \
  --env SHOPWARE_API_CLIENT_SECRET=your-integration-client-secret \
  -- npx -y @shopware-ag/admin-mcp

4. If you are configuring via mcp.json, create or update your mcp.json with the following structure (adjust environment values accordingly):

{
  "mcpServers": {
    "shopware-admin-mcp": {
      "command": "npx",
      "args": ["-y", "@shopware-ag/admin-mcp"],
      "env": {
        "SHOPWARE_API_URL": "https://your-shopware-instance.com",
        "SHOPWARE_API_CLIENT_ID": "your-integration-client-id",
        "SHOPWARE_API_CLIENT_SECRET": "your-integration-client-secret"
      }
    }
  }
}

5. Start the MCP server using your preferred deployment method (Claude CLI, mcp.json runner, or docker if available in your setup).

Tips:

• Ensure the Shopware API URL and credentials are kept secure; use environment variables to avoid leaking secrets in logs.
• Some operations may require specific permissions in the Shopware integration (read vs. write vs. delete). Align the integration scopes with your intended tasks.
• When using upload_media_by_url, ensure the provided URL is accessible from the server environment and that the target domain is allowed by Shopware.
• For large product catalogs, consider using category_create and product_create with bulk-like inputs where supported to minimize API calls.
• If you encounter authentication errors, re-check the client credentials and that the integration is not expired or rotated.