Skip to content

Build MCP server usecase personas#2360

Open
Su (sushmangupta) wants to merge 1 commit into
mainfrom
adhoc/mcpserver-docs-usecases
Open

Build MCP server usecase personas#2360
Su (sushmangupta) wants to merge 1 commit into
mainfrom
adhoc/mcpserver-docs-usecases

Conversation

@sushmangupta

Copy link
Copy Markdown
Contributor

Summary

Related links

Checklist

  • I reviewed affected links, code samples, and cross-references, including PageRef references where relevant.
  • I added or updated redirects in .gitbook.yaml if pages were moved, renamed, or deleted.
  • I updated .wordlist.txt (and sorted it) if spellcheck flags new legitimate terms.
  • Any required dependent changes in downstream modules have already been merged and published.
  • This pull request is ready for review.

Notes

Copilot AI review requested due to automatic review settings June 30, 2026 15:45
@shopware-dev-docs-connector

shopware-dev-docs-connector Bot commented Jun 30, 2026

Copy link
Copy Markdown

Developer Docs healthcheck

Status: Completed with success.
Repository: shopware/docs
Commit: b39f2af
Preview: https://developer-documentation-h6x9myo02-shopware-frontends.vercel.app
Workflow run: #4317

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new documentation tutorial (“Build an AI Merchant Assistant”) for using the Shopware Admin MCP Server, and updates the MCP ecosystem list to include the shopware-admin-mcp repository.

Changes:

  • Added sample-implementation.md tutorial describing an end-to-end “merchant assistant” use case and safe write-operation flow.
  • Updated MCP ecosystem table to list the shopware-admin-mcp repository.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 6 comments.

File Description
products/tools/mcp-server/sample-implementation.md New tutorial page describing how to build a merchant assistant using the Shopware Admin MCP Server.
products/tools/mcp-server/index.md Adds shopware-admin-mcp to the MCP ecosystem repository list.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.


Because the assistant communicates through the Shopware MCP Server, all requests follow Shopware's authentication, authorization, and extension mechanisms.

# What you'll build
- Install the Shopware Admin MCP Server
- Configure Authentication

# Step 1 — Install the Shopware Admin MCP Server
Comment on lines +21 to +24
- Retrieve Shopware entities
- Execute merchant operations
- Abide Shopware ACL permissions
- Execute write operations safely
Comment on lines +1 to +6
---
nav:
title: Build an AI Merchant Assistant
position: 15

---
Comment on lines +148 to +153
# Step 6 — Execute write operations safely

Write operations support **Dry Run** mode.

Before updating Shopware data, execute the operation in Dry Run mode to validate:

Comment on lines +213 to +218
| Repository | Purpose |
|------------|---------|
| `shopware/shopware` | Core Shopware platform |
| `shopware-admin-mcp` | Shopware Admin MCP Server |
| `SwagMcpMerchantTools` | Merchant-specific MCP capabilities |
| `SwagMcpDevTools` | Development and debugging tools |
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants