Cómo conectar Shopware 6 Admin API a Gemini 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 + Gemini

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 Gemini

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.

Gemini CLI lee los servidores MCP de ~/.gemini/settings.json (en Windows, %USERPROFILE%\.gemini\settings.json). Añade:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de YOUR_MCP_API_KEY.
2. Guarda el archivo y reinicia gemini.
3. Ejecuta /mcp dentro de Gemini CLI (o gemini mcp list en tu terminal): anythingmcp debería aparecer como conectado.
4. Empieza a escribir prompts: Gemini CLI ya puede llamar a las herramientas de Shopware 6 Admin API.

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

¿Dónde busca Gemini CLI los servidores MCP? En ~/.gemini/settings.json para tu usuario, o en .gemini/settings.json dentro de un proyecto. gemini mcp list muestra cada servidor y si se conecta.

Siguientes pasos

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