Cómo conectar Shopware 6 Admin API a Microsoft Copilot vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Shopware 6 Admin API, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Shopware 6 Admin API + Microsoft Copilot

Shopware 6 Admin API, la API de back office de la tienda (no la Store API): busca cualquier entidad, mantiene productos, categorías, layouts de Shopping Experiences hasta el slot y medios, y lee canales de venta, promociones y URL SEO. Escrituras genéricas, borrado y sync masivo vienen desactivados.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

SHOPWARE_URL, SHOPWARE_ACCESS_KEY_ID, SHOPWARE_SECRET_ACCESS_KEY

Paso 1 — Obtener credenciales

Admin API, no la Store API: este conector usa la Admin API (/api) de una tienda Shopware 6, la API que usa la propia Shopware Administration para gestionar la tienda: productos, categorías, layouts de Shopping Experiences y la biblioteca de medios. Es un conector distinto de Shopware 6 Store API (shopware-6), que lee el escaparate público con la clave de acceso de un canal de venta. Instala este cuando la IA deba trabajar con los datos de administración de la tienda.

La configuración lleva unos 3 minutos. Necesitas acceso a la Shopware Administration de la tienda.

1. En la Shopware Administration abre Settings > System > Integrations y crea una nueva integración.
2. Ponle un nombre y activa Administrator o asígnale un rol con los permisos que deba tener la IA. Con un rol de solo lectura, cada herramienta de escritura falla con 403.
3. Copia el Access key ID (empieza por SWIA) en SHOPWARE_ACCESS_KEY_ID y la Secret access key en SHOPWARE_SECRET_ACCESS_KEY. La clave secreta se muestra una sola vez; si la pierdes, crea una clave nueva en la integración.
4. Define SHOPWARE_URL con la dirección de la tienda sin ruta, p. ej. https://shop.example.com. No añadas /api ni /admin.
5. Instala el conector y ejecuta shopware_6_admin_get_version: muestra la versión de Shopware y confirma las credenciales.

AnythingMCP obtiene un token bearer de corta duración en /api/oauth/token de la tienda con el grant OAuth2 client credentials y lo renueva por su cuenta.

Qué lee: productos con búsqueda libre y filtros (número de producto, activo, stock, fabricante, categorías, propiedades, variantes por parentId) y un producto con sus propios campos (nombre, número, stock, precio, descripción, campos SEO, campos personalizados); categorías con categoría padre, posición, tipo, layout, indicadores de activa y visible y ruta de navegación; los layouts de Shopping Experiences (páginas CMS) y un layout con sus secciones, bloques y slots, incluida la config de cada slot; la biblioteca de medios con URL, nombre de archivo, texto alternativo, título y carpeta; los canales de venta con sus dominios (la clave de acceso de la Store API se elimina de la respuesta); las promociones con códigos, validez y límites de canje; las URL SEO. Cualquier otra entidad de la Admin API, por ejemplo pedidos, clientes, fabricantes, grupos y opciones de propiedades, reglas, idiomas, monedas o snippets, se lee con shopware_6_admin_search_entities y shopware_6_admin_get_entity.

Criterios de búsqueda: cada herramienta de búsqueda acepta los criteria de Shopware: term, ids, filter (equals, equalsAny, contains, prefix, suffix, range, not, multi), sort, associations, includes, limit, page y total_count_mode; los productos y la búsqueda genérica aceptan también aggregations. Los campos relacionados se filtran con rutas con puntos como categories.id o manufacturer.name. La IA pasa includes cuando no necesita los registros completos, porque un producto completo es grande. Los id son 32 caracteres hexadecimales sin guiones; la IA los encuentra con las herramientas de búsqueda y nunca los adivina.

Idiomas y variantes: los textos están traducidos por idioma. Con language_id (enviado como cabecera sw-language-id) una lectura devuelve esa traducción y una escritura cambia esa traducción; sin él se usa el idioma del sistema de la tienda. Los idiomas se listan con shopware_6_admin_search_entities y la entidad language. Los registros nuevos se crean primero en el idioma del sistema. Las variantes son productos con parentId y heredan los campos vacíos del producto padre; inheritance: true muestra los valores heredados.

Qué escribe: shopware_6_admin_update_product (textos, campos SEO, campos personalizados, indicador activo, stock, liquidación, EAN, precio; un precio sustituye toda la lista de precios), shopware_6_admin_add_product_property y shopware_6_admin_remove_product_property (solo vinculan o desvinculan una opción), shopware_6_admin_create_property_option, shopware_6_admin_create_category y shopware_6_admin_update_category (también mover una categoría en el árbol), shopware_6_admin_create_cms_page, shopware_6_admin_update_cms_page (las secciones, bloques y slots con id se actualizan, los que no tienen id se añaden, no se elimina nada), shopware_6_admin_create_cms_block, shopware_6_admin_update_cms_slot (la config sustituye la del slot para ese idioma), shopware_6_admin_create_media seguido de shopware_6_admin_upload_media_from_url, shopware_6_admin_update_media y shopware_6_admin_create_media_folder. Estas herramientas están activas al instalar y cambian la tienda en vivo: los compradores ven el cambio en cuanto se refresca la caché de la tienda. Subir por URL requiere la enable_url_upload_feature de Shopware (activa por defecto) y una URL pública, y sustituye el archivo que ya tenga el medio.

Desactivadas al instalar: shopware_6_admin_create_entity, shopware_6_admin_update_entity (cualquier entidad, incluidos pedidos, clientes, canales de venta y ajustes), shopware_6_admin_delete_entity (definitivo, los registros dependientes pueden borrarse con él) y shopware_6_admin_sync (upsert y borrado masivos con la Sync API). Un admin del workspace las activa de forma deliberada.

Respuestas: las actualizaciones, subidas y borrados responden con un 204 vacío, así que la IA vuelve a leer el registro para confirmar el cambio. Las herramientas de creación devuelven el registro nuevo con su id. Las listas devuelven total, data y aggregations.

Límites: el máximo predeterminado de Shopware es 500 resultados por página; la IA pagina con page. total_count_mode 1 devuelve el total exacto, 2 solo si existe una página siguiente.

Errores comunes: 401 significa un Access key ID o una clave secreta incorrectos: cópialos de nuevo o crea una clave nueva en la integración. 403 significa que el rol de la integración no puede hacerlo: activa Administrator o amplía el rol. 404 en cada llamada suele indicar que SHOPWARE_URL contiene /api, /admin u otra ruta.

Con las herramientas activas al instalar, el conector no crea ni modifica pedidos, clientes o ajustes y no borra nada. Solo sube medios desde una URL pública, no desde tu ordenador. Para leer el escaparate público con la clave de acceso de un canal de venta, usa el conector Shopware 6 Store API.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en Microsoft Copilot

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Shopware 6 Admin API.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.

Herramientas disponibles

Ejemplos de prompts

• "Busca todos los productos activos con menos de 5 unidades en stock y muestra número de producto, nombre y stock."
• "Reescribe el meta title y la meta description del producto SW10001 en alemán e inglés. Muéstrame los textos antes de guardar."
• "Muestra el layout de Shopping Experiences de nuestra landing page de verano con sus secciones, bloques y slots."
• "Sube la imagen https://example.com/banner.jpg a la carpeta de medios Banners y pon su texto alternativo."
• "¿Qué promociones están activas ahora mismo, con sus códigos y fechas de validez?"

FAQ

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a ChatGPT
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse