docs: add MCP server documentation#2264
Draft
Björn Meyer (BrocksiNet) wants to merge 7 commits intomainfrom
Draft
docs: add MCP server documentation#2264Björn Meyer (BrocksiNet) wants to merge 7 commits intomainfrom
Björn Meyer (BrocksiNet) wants to merge 7 commits intomainfrom
Conversation
Adds complete documentation for Shopware's native MCP server introduced in 6.7: - guides/development/tooling/mcp-server/ — 8 pages covering concepts, getting started, configuration, best practices, examples, troubleshooting, tools reference, and Shopware extensions (Copilot, SwagMcpMerchantAssistant, SwagMcpDevTools, ai-coding-tools) - guides/plugins/plugins/mcp-server.md — how-to for extending via plugin - guides/plugins/apps/mcp-server.md — how-to for extending via app (webhook) - 4 Admin UI screenshots for tool allowlist and ACL privilege flows - Navigation entries in tooling, plugins, apps, and extensions indexes
references - Fix McpContextProvider namespace (Context\ sub-namespace) and requirePrivilege return value pattern in plugin sample code - Fix shopware-media-upload has no dryRun, theme-config action/config defaults, debug:mcp column list, tool count claim - Add extending.md: side-by-side quick reference for tools/prompts/resources across app, plugin, and bundle - Add webhook handler examples for prompts and resources in apps/mcp-server.md - Link SwagMcpAdminUsers and McpHelloWorld example repos in plugin and app docs - Expand MCP acronym on first use in mcp-concepts.md, fix lowercase mcp in headings to use backticks - Fix duplicate heading in shopware-extensions.md
- Document required-privileges in app mcp.xml (informational only; apps must enforce ACL themselves) - Add array/object to supported input schema property types - Add internal URL mode (url="/...") for routing to app scripts - Document integration.mcp_tool_allowlist semantics (null/array/empty) - Replace stale mcp.yaml snippet with mcp.php note; clarify the bundle loads automatically when MCP_SERVER feature flag is active - Add --integration flag to debug:mcp; remove non-existent --all flag - Add Symfony bundle stub guide
reference - Add three new subsections to best-practices.md: writing descriptions for agent routing, the DI container cache requirement after description changes, and using the system prompt as the disambiguation override layer - Fix shopware-theme-config salesChannelId row in tools-reference.md to reflect that it is optional in the schema and validated at runtime
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds complete documentation for Shopware's native MCP server introduced in 6.7:
Related links
relates: shopware/shopware#15346
Checklist
PageRefreferences where relevant..gitbook.yamlif pages were moved, renamed, or deleted..wordlist.txt(and sorted it) if spellcheck flags new legitimate terms.Notes