Cómo conectar Shoper a Gemini vía MCP

💡 ¿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 + Gemini

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.

1. 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.
2. 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.
3. Pestaña Administratorzy, DODAJ ADMINISTRATORA: crea un login y una contraseña e introdúcelos en SHOPER_API_LOGIN y SHOPER_API_PASSWORD. Una app de Shoper registrada puede usar aquí su client_id y client_secret.
4. Define SHOPER_SHOP_HOST con la dirección de la tienda sin https:// y sin ruta, p. ej. myshop.shoparena.pl o tu propio dominio sklep.example.pl.
5. 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 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 Shoper.

Herramientas disponibles

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

¿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