Skip to content
Merged
Changes from 1 commit
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 16 additions & 0 deletions products/tools/mcp-server/getting-started.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,8 @@ SHOPWARE_SECRET_ACCESS_KEY=...
The `--admin` flag grants full Admin API access. For production use, omit `--admin`, create a dedicated ACL role with only the required permissions, and assign it to the integration. See [Configuration](./configuration.md#acl-and-permissions) for details.
:::

<YoutubeRef video="cjk7nTa1O6I" title="How to Connect AI agent to Shopware Using the MCP Server | Step-by-Step Tutorial" target="_blank" />

## Step 3: Configure your AI client

### Claude Desktop and Cursor
Expand Down Expand Up @@ -165,6 +167,20 @@ When a tool is enabled, its declared dependencies are automatically included. Fo

See [Configuration](./configuration.md) for the global `allowed_tools` safety switch, the full per-principal allowlist reference, and session store options.

## Try your first prompts

Your AI client is now connected to Shopware. Try a few prompts to verify that the MCP server is working correctly.

For example:

* Show all products in my store.
* Find products with stock below five units.
* Find all active products without descriptions.
* Generate SEO-friendly meta titles for your products (eg, guitars)
* Increase prices of products in a specific category by 5%. Show a preview before applying the changes.
Comment thread
sushmangupta marked this conversation as resolved.
Outdated

If the AI can retrieve data and respond to these requests, your integration is ready to use.

## Next steps

- [Tools Reference](./tools-reference.md): explore all built-in tools and resources
Expand Down
Loading