Guía de conector6 minutos de lectura9 herramientas MCP7 idiomas

Conectar Spartoo Marketplace MCP con Cursor

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

HCPor el equipo de HelpCodeActualizado 6 min de lectura Código abierto en GitHub

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

Spartoo Marketplace

Spartoo Marketplace

Spartoo marketplace web services for sellers: orders with customer and delivery details, accepting and shipping orders with a tracking number, returns, the status of a product on the site and stock updates per size. Partner code as a form field, XML answers read as JSON.

herramientas

9

Región

INTL

Categoría

E-commerce

Autenticación

API credentials

Env vars requeridas

SPARTOO_HOSTSPARTOO_PARTNER_KEY
Instalar con un clic en Cloud

7 días de prueba gratis · Sin tarjeta de crédito

  • Prueba gratis de 7 días
    Sin tarjeta de crédito
  • RGPD y SOC 2 ready
    Datos en la UE, registros de auditoría
  • Código abierto en GitHub
    Open source · AGPL-3.0
  • Funciona con ChatGPT, Claude, Gemini
    Cualquier cliente compatible con MCP

Resumen

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Configuración guiada

Conecta Spartoo Marketplace a Cursor en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta Spartoo Marketplace con la configuración guiada y añade tu URL MCP a Cursor. Sin código y sin servidores que mantener.

Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible

Prueba a pedir

Prompts de ejemplo para Spartoo Marketplace

Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.

Spartoo Marketplace · live vía MCP
Compartir
Opus 4.7

Claude es IA y puede equivocarse. Verifica siempre las respuestas.

💡 ¿No tienes instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Spartoo Marketplace, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Spartoo Marketplace + Cursor

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Requisitos previos

Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:

SPARTOO_HOST, SPARTOO_PARTNER_KEY

Paso 1 — Obtener credenciales

La configuración tarda aproximadamente 3 minutos.

  1. Inicia sesión en el back office de Spartoo marketplace y abre Documentación, luego Webservices y cualquier página de servicio, por ejemplo, Exportar pedidos.
  2. La línea Webservice URL nombra la dirección del servicio web de tu sitio Spartoo, por ejemplo, https://sws.spartoo.eu o https://sws.spartoo.it. Coloca la parte antes de /mp/ en SPARTOO_HOST.
  3. En la misma página, la fila partner muestra tu código único cuando has iniciado sesión. Colócalo en SPARTOO_PARTNER_KEY. Si la página no muestra ningún código, pregunta a tu contacto de Spartoo marketplace por el código del servicio web de tu cuenta.

Dónde empezar: spartoo_list_orders con una fecha de inicio. spartoo_get_order lee un pedido por su id.

Pedidos: un pedido llega en estado 11 (verificado). spartoo_accept_order lo mueve a 2 (en preparación): después de eso, su nombre, dirección y transportista ya no pueden cambiar. spartoo_ship_order lo mueve de 2 a 3 (enviado) con el número de seguimiento del transportista, y Spartoo envía el enlace de seguimiento al cliente. spartoo_cancel_order (estado 41) está instalado apagado: el cliente es reembolsado y no se puede deshacer. Los estados 45 (paquete perdido) y 47 (paquete no entregado) son establecidos por Spartoo.

Devoluciones: spartoo_list_returns y spartoo_get_return. Una devolución contiene un producto. Estados de devolución: 2 esperando ser recibida, 3 rechazada, 4 paquete recibido y devolución aceptada, 5 pagada, 7 reembolso, 14 esperando la etiqueta de devolución prepagada del comerciante. Este conector no acepta ni rechaza devoluciones.

Productos y stock: spartoo_check_product_status indica si un producto está en el sitio (OK), fuera de stock (OS), creado pero aún no en línea (EC) o desconocido (KO), con la razón. spartoo_update_stock establece el stock de un tamaño. Ambos utilizan tus propias referencias: reference_partenaire es el producto en un color, size_reference un tamaño de este. Stock 0 retira el tamaño del sitio.

Notas de campo

  • Los ids de pedidos y devoluciones son códigos cortos como 90D813EA1A2365A8.
  • El filtro de fecha de pedido se escribe YYYY-MM-DD:hh:mm:ss con dos puntos entre el día y la hora. El filtro de fecha de devolución es un timestamp Unix en segundos. Spartoo no documenta la zona horaria.
  • Los precios son números decimales en la moneda del sitio del pedido; products_final_price es el precio unitario con descuento multiplicado por la cantidad.
  • Un pedido para un punto de recogida tiene relay_info en lugar de la dirección de entrega.
  • Los valores de texto llegan como cadenas, incluidos los números. Un pedido o producto en una lista llega como un objeto, varios como un array.

Errores: cada respuesta lleva un código. 1 significa sin error. -1 y -2: falta o es desconocido el código de socio. -3: falta la fecha o el id. -4: formato de fecha incorrecto. -6 y -28: pedido o devolución no encontrados. -8: número de seguimiento rechazado. -9: el pedido ya tiene ese estado. -19: orden incorrecta de estados (2 solo de 11, 3 solo de 2). -14: producto no encontrado. -16, -18 y -20: stock no cambiado (no es posible, ya tiene ese valor, o el tamaño ya no es válido). -30: pedido demasiado antiguo para enviar, contacta a Spartoo. -428: cuenta desactivada. -429: demasiadas solicitudes en una hora. El conector informa un código negativo como una llamada fallida.

No cubierto: creación y edición de productos, precios y descuentos (se gestionan a través de un archivo de catálogo XML), albaranes y decisiones de devolución.

Paso 2 — Instalar el adaptador

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 Cursor

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.

Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "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 Cursor.
  3. Abre Cursor → Settings → MCP y comprueba que anythingmcp aparece en la lista y está conectado.
  4. Empieza a chatear: el agente ya puede usar las herramientas de Spartoo Marketplace.

Herramientas disponibles

HerramientaQué hace
spartoo_list_ordersLista los pedidos realizados desde una fecha, opcionalmente solo aquellos en un estado. Por pedido bajo root.orders.order: orders_id, customers…
spartoo_get_orderLee un pedido por su id: detalles del cliente y de entrega (o el punto de recogida en relay_info), método de pago, nombre y precio de envío, pedido…
spartoo_accept_orderAcepta un nuevo pedido: lo mueve del estado 11 (verificado) a 2 (en preparación). Después de eso, el nombre del pedido, la dirección de entrega y el transportista pueden…
spartoo_ship_orderMarca un pedido aceptado como enviado con el número de seguimiento del transportista: lo mueve del estado 2 a 3, y Spartoo envía el enlace de seguimiento a…
spartoo_cancel_orderCancela un pedido que no ha sido enviado (estado 41). El cliente no recibe el pedido y es reembolsado por Spartoo; no se puede deshacer…
spartoo_list_returnsLista las devoluciones registradas desde un momento, opcionalmente solo aquellas en un estado. Por devolución bajo root.returns.return: return_id…
spartoo_get_returnLee las devoluciones de un pedido, o una devolución por su id: id de devolución y fecha, id y nombre de estado, razón, id de pedido y el producto devuelto…
spartoo_check_product_statusVerifica si uno de tus productos está en el sitio de Spartoo. Devuelve bajo root.products.product tu referencia, un estado (OK en el sitio…
spartoo_update_stockEstablece el stock de un tamaño de un producto, en tiempo real. Stock 0 retira ese tamaño del sitio; un producto cuyos tamaños son todos 0 se desconecta.…

Ejemplos de indicaciones

  • "¿Qué pedidos de Spartoo llegaron desde el lunes y aún necesitan ser aceptados?"
  • "Acepta el pedido 90D813EA1A2365A8 y envíalo con el seguimiento de Royal Mail AB123456789GB."
  • "¿Qué devoluciones están esperando ser recibidas?"
  • "¿Está mi producto REF-BOOT-221 en línea, y si no, por qué?"
  • "Establece el stock del tamaño 38 de REF-BOOT-221 a 6."

Preguntas frecuentes

¿De dónde proviene el código de socio? En el back office de Spartoo marketplace, Documentación, Webservices, cualquier página de servicio: la fila partner muestra tu código y la línea Webservice URL nombra la dirección de tu sitio. Si no se muestra ningún código, pregunta a tu contacto de Spartoo marketplace.

¿Qué cubre y qué no? Pedidos con detalles del cliente y de entrega, aceptación y envío con un número de seguimiento, devoluciones, estado del producto y stock por tamaño. No acepta ni rechaza devoluciones. Para buscar en el catálogo de Spartoo como comprador, utiliza el conector Spartoo Shop.

¿Qué herramientas se instalan apagadas? spartoo_cancel_order, porque una cancelación reembolsa al cliente y no se puede deshacer. Actívala en la página del conector solo si la IA debe usarla.

¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.

Próximos pasos

¿Te ha sido útil esta guía?

Conecta Spartoo Marketplace a Cursor en 2 minutos

Empieza la prueba gratuita en AnythingMCP Cloud, conecta Spartoo Marketplace con la configuración guiada y añade tu URL MCP a Cursor. Sin código y sin servidores que mantener.

Guías relacionadas

Conectores

Conectar Spartoo Marketplace MCP con ChatGPT

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Conectores

Conectar Spartoo Marketplace MCP con Claude

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Conectores

Spartoo Marketplace MCP con Microsoft Copilot

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Conectores

Spartoo Marketplace MCP con Gemini CLI

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Conectores

Spartoo Marketplace MCP con Meta Muse

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.

Conectores

Spartoo Marketplace MCP: pedidos y stock

Servicios web de Spartoo marketplace para vendedores: pedidos con detalles del cliente y de entrega, aceptación y envío de pedidos con un número de seguimiento, devoluciones, el estado de un producto en el sitio y actualizaciones de stock por tamaño. Código de socio como campo de formulario, respuestas XML leídas como JSON.