docs: add MCP server documentation

.wordlist.txt

@@ -6,6 +6,7 @@ ADDR
 ADR
 ADRs
 AES
+AI
 AOF
 API's
 APIRequestContext
@@ -71,7 +72,7 @@ AppScripts
 AppServer
 AppServers
 AppSystem
-Archlinux
+ArrayAdapter
 ArrayFacade
 AssociationField
 AsyncAws
@@ -342,6 +343,7 @@ DomainExceptions
 Dotenv
 DynamoDB
 ECDSA
+ECONNREFUSED
 ENUM
 ENUMS
 EOL
@@ -443,6 +445,7 @@ GCM
 GDPR
 GIFs
 GLB
+GPT
 GenericPage
 GenericPageLoader
 GitLab
@@ -567,6 +570,8 @@ LongText
 LongTextField
 Lychee
 MACOSX
+MCP
+MCPs
 MDN
 MJML
 MOV
@@ -591,12 +596,14 @@ ManyToOne
 ManyToOneAssociation
 ManyToOneAssociationField
 MapState
+McpHelloWorld
 MediaDataSelection
 MediaDataSet
 MediaFolderDataSet
 MediaType
 MemcachedSessionHandler
 MenuOffcanvasPagelet
+MerchantAssistant
 Mercure
 MessageAware
 MessageQueue
@@ -712,6 +719,7 @@ PHPStorm
 PHPUnit
 PHPunit
 PII
+PIM
 POC
 POS
 PRs
@@ -961,6 +969,7 @@ StorefrontController
 StorefrontPage
 StorefrontResponse
 Storer
+Streamable
 StringField
 StringFields
 Struct
@@ -978,6 +987,9 @@ SwagB
 SwagBasicExample
 SwagBasicExampleTheme
 SwagDigitalSalesRooms
+SwagMcpAdminUsers
+SwagMcpDevTools
+SwagMcpMerchantAssistant
 SwagMigrationBundleExample
 SwagMyPlugin
 SwagMyPluginSW
@@ -1037,6 +1049,7 @@ UDP
 UI
 UID
 UML
+URIs
 USD
 UUID
 UUIDs
@@ -1146,6 +1159,7 @@ activateShopwareTheme
 adr
 afterSort
 ag
+ai
 ajax
 allowlist
 allowlists
@@ -1385,6 +1399,7 @@ dr
 dragTo
 dropdown
 dropdowns
+dryRun
 dsr
 dunglas
 duplications
@@ -1650,6 +1665,7 @@ minimalistic
 mixin
 mixins
 mocksArentStubs
+modelcontextprotocol
 modifiability
 modularity
 monday
@@ -1902,6 +1918,7 @@ shopName
 shopUrl
 shopware
 shopware's
+shopwareLabs
 shopwarelabs
 shopwarepartners
 shorthands
@@ -1954,6 +1971,8 @@ subfolder
 suboptimal
 subprocessor
 subprocessors
+subrequest
+substring
 supervisord
 svg
 sw
@@ -2026,6 +2045,7 @@ uniqBy
 unminified
 unprefixed
 unregister
+unrequested
 unsecure
 unserialize
 unstorage

guides/development/extensions/index.md

@@ -48,6 +48,13 @@ This comparison table helps you decide which Shopware extension type best fits y
 Extensions must explicitly support target Shopware versions. Review the [Upgrades and Migrations](../../upgrades-migrations/index.md) section before releasing updates to ensure compatibility with upcoming core changes.
 :::
 
+## MCP Server extensibility
+
+Both plugins and apps can contribute custom tools, prompts, and resources to Shopware's built-in [MCP Server](../tooling/mcp-server/index.md). This lets AI clients access your extension's capabilities alongside core platform tools.
+
+- [Extend the MCP Server via Plugin](../../plugins/plugins/mcp-server.md)
+- [Extend the MCP Server via App](../../plugins/apps/mcp-server.md)
+
 ## Extension guides
 
 These guides provide essential information on how to create, configure, and extend your store with Shopware extensions:

guides/development/tooling/fixture-bundle.md

@@ -1,7 +1,7 @@
 ---
 nav:
   title: Fixture Bundle
-  position: 30
+  position: 10
 
 ---
 

guides/development/tooling/index.md

@@ -20,3 +20,5 @@ Shopware provides official tools that support the full lifecycle of a Shopware p
 - For IDE support, Shopware provides a [PHPStorm plugin](shopware-toolbox.md) and [VS Code extension](https://marketplace.visualstudio.com/items?itemName=shopware.shopware-lsp).
 
 - [Shopware CLI](../../../products/cli/index.md): The central command-line tool for working with Shopware projects and extensions, including scaffolding, builds, validation, packaging, Store interaction, CI support, and development workflows such as watchers and [formatting](../../../products/cli/formatter.md).
+
+- [MCP Server](./mcp-server/index.md): A native Model Context Protocol server that lets AI clients (Claude Desktop, Cursor, Claude Code) interact with a Shopware shop through tools, resources, and prompts. Extensible via plugins and apps.