Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Shoper con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
Tiendas online Shoper (Polonia): pedidos con líneas y paquetes, productos y stock por variante, categorías, clientes registrados, estados de pedido, métodos de envío y de pago. Fija cantidades de stock; cambiar el estado de un pedido, que puede enviar un correo al cliente, viene desactivado al instalar.
Prueba a pedir
Prompts de ejemplo para Shoper
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Shoper, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
Shoper + Microsoft Copilot
Tiendas online Shoper (Polonia): pedidos con líneas y paquetes, productos y stock por variante, categorías, clientes registrados, estados de pedido, métodos de envío y de pago. Fija cantidades de stock; cambiar el estado de un pedido, que puede enviar un correo al cliente, viene desactivado al instalar.
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:
SHOPER_SHOP_HOST, SHOPER_API_LOGIN, SHOPER_API_PASSWORD
Paso 1 — Obtener credenciales
La configuración lleva unos 5 minutos. Necesitas acceso de administrador al panel de Shoper de la tienda.
- En el panel de administración de Shoper abre Ustawienia, Ogólne, Administratorzy sklepu (Ajustes, General, Administradores de la tienda). Haz clic en WIĘCEJ, Dodaj grupę administratorów, ponle un nombre (p. ej. AI) y elige el tipo de acceso dostęp do webapi. Guarda.
- Abre el grupo, pestaña Uprawnienia (Permisos): permite la lectura de pedidos, productos, clientes y de los ajustes que deba ver la IA. Permite editar productos solo si la IA debe fijar el stock, y pedidos solo si activas el cambio de estado. Guarda.
- Pestaña Administratorzy, DODAJ ADMINISTRATORA: crea un login y una contraseña e introdúcelos en
SHOPER_API_LOGINySHOPER_API_PASSWORD. Una app de Shoper registrada puede usar aquí su client_id y client_secret. - Define
SHOPER_SHOP_HOSTcon la dirección de la tienda sin https:// y sin ruta, p. ej.myshop.shoparena.plo tu propio dominiosklep.example.pl. - Instala el conector y ejecuta
shoper_list_orders: lista tus pedidos y confirma el login.
El conector inicia sesión en /webapi/rest/auth con HTTP Basic y recibe un token válido durante 30 días, que renueva por su cuenta.
Qué lee: pedidos con fecha, estado, cliente, dirección de facturación y de entrega, total, importe pagado e indicador de pagado, método de envío y de pago, coste de envío, notas, origen, etiquetas y número de paquetes; un pedido completo, con punto de recogida y campos adicionales; las líneas del pedido con producto, variante (stock id), nombre, código, opción, cantidad, unidad, precio, descuento, impuesto y peso; los paquetes con número de seguimiento, indicador de enviado y fecha de envío, contra reembolso y seguro; los productos con traducciones, categorías, fabricante, stock, opciones, atributos, productos relacionados, dimensiones e impuesto; el stock de productos, es decir las variantes vendibles, con cantidad, cantidades por almacén, precio, precio especial, mayorista y de compra y disponibilidad; las categorías y el árbol completo de categorías; los clientes registrados con login, correo, nombre, grupo de clientes, descuento, consentimiento de newsletter, fecha de registro, última visita y puntos de fidelidad; los estados de pedido (con email_change), los métodos de envío y de pago.
Encontrar un pedido: la IA lista pedidos con filters y order (p. ej. un filtro de fecha y -date para los más recientes), lee uno con shoper_get_order, luego las líneas con shoper_list_order_products y los números de seguimiento con shoper_list_parcels, ambos con el filtro order_id. Los nombres de estados, pagos y métodos de envío salen de shoper_list_statuses, shoper_list_payments y shoper_list_shippings. Los pedidos de invitados no tienen user_id; la IA usa en su lugar el correo del pedido.
Filtros: filters es un objeto de condiciones sobre campos unidas con AND. Un valor simple significa igual; los operadores son =, !=, >, >=, <, <=, LIKE (con %), NOT LIKE, IN y NOT IN (con una lista). Los campos anidados usan puntos, p. ej. translations.pl_PL.name.
Qué escribe: shoper_update_product_stock está activa al instalar. Sobrescribe la cantidad de una variante (o la cantidad por almacén si la tienda usa almacenes) y cambia al instante lo que los clientes pueden pedir, así que la IA confirma antes contigo el stock id, la cantidad actual y la nueva.
Desactivada al instalar: shoper_update_order_status. Los estados con email_change 1 envían un correo al cliente en cuanto un pedido pasa a ellos, así que un administrador activa esta herramienta de forma deliberada. Aun así, la IA te muestra el pedido, el estado actual y el nuevo y espera tu sí.
Formatos: las listas responden con count, pages, page y list. Las fechas son YYYY-MM-DD HH:MM:SS en la zona horaria de la tienda; los importes son cadenas en la moneda de la tienda. Los textos van por idioma bajo translations (p. ej. pl_PL, en_GB).
Límites: como máximo 50 elementos por página; la IA vuelve a llamar con la page siguiente hasta que page sea igual a pages. El leaky bucket de Shoper permite una ráfaga de unas 10 llamadas y después 2 por segundo.
Errores comunes: 401 significa login o contraseña incorrectos, o un grupo sin acceso webapi. 403 (insufficient_scope o access_denied) significa que al grupo de administradores le falta el permiso para esa área: amplíalo en Uprawnienia. 404 en cada llamada suele indicar un SHOPER_SHOP_HOST incorrecto. 429 significa que se alcanzó el límite de peticiones: espera a Retry-After.
El conector no crea ni modifica pedidos, productos, precios o clientes, no crea paquetes ni etiquetas de envío y no borra nada.
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 muestraYOUR_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.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - 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.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Shoper. - 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
| Tool | What it does |
|---|---|
shoper_list_orders | List orders of the shop (pass order -date for newest first): order id, date, status_id, customer (user_id, e-mail, billing and delivery… |
shoper_get_order | Get one order with all its fields: status, customer, billing and delivery address, sums, payment and shipping, pickup point, notes… |
shoper_list_order_products | List order line items: order_id, product_id, stock_id, name, code, option (variant), quantity, unit, price, discount, tax rate and value… |
shoper_list_products | List products of the catalogue: product_id, code, EAN, category, producer, translations (name, description, active, SEO per language such… |
shoper_get_product | Get one product with translations, categories, stock (price, quantity, availability), options, attributes, related products, dimensions and… |
shoper_list_product_stocks | List product stocks, i.e. the sellable variants of products: stock_id, product_id, code, EAN, stock quantity, warehouse quantities, price… |
shoper_get_product_stock | Get one product stock (variant) with its quantity, warehouse quantities, prices, availability and options |
shoper_list_categories | List product categories: category_id, order, root flag and translations (name, description, active, SEO per language) |
shoper_get_category_tree | Get the whole category tree as nested nodes (id and children) |
shoper_list_customers | List registered customers (Shoper users): user_id, login, e-mail, first and last name, customer group, discount, newsletter consent, active… |
shoper_get_customer | Get one registered customer by user_id (e.g. the user_id of an order) |
shoper_list_statuses | List the order statuses of the shop: status_id, type (1 new, 2 opened, 3 closed, 4 not completed), translations (names per language)… |
shoper_list_shippings | List shipping methods: shipping_id, name, translations, cost, free shipping threshold, weight and order value limits, zone, allowed… |
shoper_list_payments | List payment methods: payment_id, name, translations, currencies and amount limits |
shoper_list_parcels | List parcels (shipments) of orders: parcel_id, order_id, shipping_id, shipping_code (tracking number), sent flag and send date, weight… |
shoper_update_order_status | Move an order to another status (status_id from shoper_list_statuses) |
shoper_update_product_stock | Set the quantity of one product stock (variant) |
Ejemplos de prompts
- "¿Qué pedidos han entrado desde el lunes y cuáles siguen sin pagar?"
- "Muestra las líneas y el número de seguimiento del pedido 1234."
- "¿Qué variantes de producto tienen 5 unidades o menos en stock?"
- "Busca los pedidos de [email protected] de este año y dime qué compró."
- "Pon el stock de la variante SKU-1-RED en 20. Muéstrame antes la cantidad actual."
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
¿Te ha sido útil esta guía?