Guía de conector11 minutos de lectura27 herramientas MCP7 idiomas

Conectar Skroutz MCP con Claude: pedidos y stock

API de Skroutz Marketplace (Smart Cart) para vendedores en el mercado griego y chipriota: leer, aceptar y programar pedidos, marcar como listo, seguimiento, carga de facturas, devoluciones, stock gestionado por Skroutz, órdenes de compra y proveedores, actualizaciones masivas de precios y stock y órdenes CPS. Token de API desde el panel de comerciantes.

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

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

Skroutz

Skroutz

Skroutz Marketplace (Smart Cart) API for sellers on the Greek and Cypriot marketplace: read, accept and schedule orders, Set as Ready, tracking, invoice uploads, returns, Fulfilled by Skroutz stock, purchase orders and suppliers, bulk price and stock updates and CPS orders. API token from the merchants panel.

herramientas

27

Región

INTL

Categoría

E-commerce

Autenticación

API credentials

Env vars requeridas

SKROUTZ_API_TOKEN
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

API de Skroutz Marketplace (Smart Cart) para vendedores en el mercado griego y chipriota: leer, aceptar y programar pedidos, marcar como listo, seguimiento, carga de facturas, devoluciones, stock gestionado por Skroutz, órdenes de compra y proveedores, actualizaciones masivas de precios y stock y órdenes CPS. Token de API desde el panel de comerciantes.

Configuración guiada

Conecta Skroutz a Claude en 2 minutos

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

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

AnythingMCP está en el directorio de conectores de Claude: añádelo a Claude con un clic (se abre en una pestaña nueva), inicia sesión y elige qué servidores MCP puede usar Claude.

Prueba a pedir

Prompts de ejemplo para Skroutz

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

Skroutz · 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 → Skroutz, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin git clone, sin servidor local.

Skroutz + Claude

API de Skroutz Marketplace (Smart Cart) para vendedores en el mercado griego y chipriota: leer, aceptar y programar pedidos, marcar como listo, seguimiento, carga de facturas, devoluciones, stock gestionado por Skroutz, órdenes de compra y proveedores, actualizaciones masivas de precios y stock y órdenes CPS. Token de API desde el panel de comerciantes.

Requisitos previos

Consulta las instrucciones de configuración completas 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:

SKROUTZ_API_TOKEN

Paso 1 — Obtener credenciales

La configuración tarda aproximadamente 3 minutos.

  1. Inicia sesión en el panel de comerciantes de Skroutz y abre Servicios, Skroutz Marketplace (la página de configuración de Smart Cart).
  2. Genera el token de API y pégalo en SKROUTZ_API_TOKEN. Una tienda tiene un token activo: generar uno nuevo finaliza el anterior, por lo que un token utilizado por otra integración deja de funcionar allí.
  3. Opcional, para actualizaciones masivas de precios y stock: en Productos, Actualizaciones de Feed genera el token de API de Productos y pégalo en SKROUTZ_PRODUCTS_TOKEN.
  4. Opcional, para órdenes CPS de tu propia tienda web: en Παραγγελίες καταστήματος, Αυτόματη διαχείριση (órdenes de tienda, gestión automática) genera el token CPS y pégalo en SKROUTZ_CPS_TOKEN.

Cada llamada envía el token como Authorization: Bearer con el tipo de medio application/vnd.skroutz+json; version=3.0. La verificación de instalación lee el pedido de demostración DEMO-OPEN, lo que prueba el token del mercado sin tocar datos reales.

Dónde empezar: la API no tiene lista de pedidos. Los pedidos llegan a una tienda a través del webhook de pedidos, el panel de comerciantes y los correos electrónicos de pedidos, así que pide al usuario el código del pedido (como 191128-1234567) y léelo con skroutz_get_order. Los códigos de demostración DEMO-OPEN, DEMO-ACCEPTED, DEMO-REJECTED, DEMO-INVOICE, DEMO-FBS, DEMO-STORE-PICKUP y DEMO-RETURN son seguros para leer, aceptar y rechazar para pruebas: nada se almacena.

Pedidos: un pedido abierto lleva accept_options y reject_options y debe ser gestionado antes de expires_at. Acepta con skroutz_accept_order, enviando un id de ubicación de recogida y el id de una de las ventanas de recogida de esa ubicación (las ventanas difieren por ubicación). Skroutz luego reserva el mensajero y el PDF del voucher aparece en courier_voucher. Los pedidos exprés son aceptados automáticamente por Skroutz. skroutz_reject_order está instalado apagado: una rechazo no se puede deshacer y cuenta en contra de la tienda. Para cambiar la recogida de un pedido aceptado, léelo con action_options 1 justo antes y usa skroutz_reschedule_order_pickup (una fecha de reschedule_options) o skroutz_relocate_order_pickup (un id de relocate_options); las listas se reducen con el tiempo. skroutz_request_preorder_voucher crea el voucher de un pedido anticipado aceptado temprano.

Marcar como listo: cuando un pedido muestra set_as_ready_required verdadero, Skroutz Last Mile solo lo recoge después de skroutz_set_order_ready; descargar el voucher ya no lo marca como listo (desde el 30 de marzo de 2026). Marcarlo temprano puede mover la recogida a una ventana anterior. skroutz_set_order_not_ready lo deshace antes de la recogida. Las tiendas con set_as_ready_required falso no lo necesitan.

Envío y documentos: skroutz_update_tracking_details envía el mensajero y el código de seguimiento de cada envío de un pedido Fulfilled by Merchant (FBM) solamente. skroutz_upload_invoice y skroutz_upload_credit_invoice toman un enlace público al PDF, PNG o JPG (máximo 7 MB); el conector lo descarga y sube el archivo, uno por pedido, reemplazando una carga anterior.

Devoluciones: skroutz_get_return lee una devolución por su código (como R-111111-1111111, desde el webhook de devoluciones o el panel de comerciantes; las returns de un pedido solo dan un uuid y códigos de seguimiento). skroutz_handle_return (decidir una devolución esperando revisión antes de review.expires_at, incluyendo enviar una parte faltante a costa de la tienda) y skroutz_submit_service_inspection (informe técnico sobre un artículo defectuoso, como un enlace de archivo) están instalados apagados, porque conducen a reembolsos, reemplazos o envíos pagados. skroutz_file_compensation_request también está apagado: reclama dinero a Skroutz por artículos devueltos, y a través de este conector solo por razones que no necesitan fotos.

Fulfilled by Skroutz: skroutz_list_fbs_products (stock en almacenes de Skroutz), skroutz_list_fbs_purchase_orders, skroutz_list_fbs_purchase_order_items, skroutz_list_fbs_suppliers, skroutz_create_fbs_supplier y skroutz_update_fbs_supplier. skroutz_create_fbs_purchase_order está apagado, porque las tarifas de almacén derivan de ello. Las listas están paginadas con page y vienen con meta.pagination (100 filas por página). Una tienda sin FBS recibe un 401 aquí.

API de Productos (necesita SKROUTZ_PRODUCTS_TOKEN): skroutz_validate_product_updates verifica un lote sin cambiar nada; skroutz_update_products (apagado) actualiza disponibilidad, precio y cantidad de hasta 500 productos existentes y variaciones, de forma asincrónica; skroutz_get_product_update_status informa éxito, no_change o fallo por producto. Los precios aquí son centavos de euro enteros (1050 son 10.50 EUR), mientras que los montos de pedidos son euros decimales. No crea productos: estos provienen del feed XML. Un 422 que dice que el XML está siendo escaneado significa que debes intentar de nuevo más tarde.

Órdenes CPS (necesita SKROUTZ_CPS_TOKEN): skroutz_get_cps_order lee una venta de tu propia tienda web por tu propio número de pedido, con ingresos y comisión; skroutz_reject_cps_order (apagado) la rechaza para que no se cobre comisión.

Notas de campo: los tiempos son ISO 8601 con el desfase de Atenas (+02:00 en invierno, +03:00 en verano). Etiquetas como ventanas de recogida, razones de rechazo y estados CPS vienen en griego. Los ids de línea son cadenas cortas (l39vKqxqwe); shop_uid es tu propio id de producto. Los errores llevan un array errors con un code y messages: 422 order_status significa que el pedido no está en un estado para esa acción. Un token de mercado incorrecto o reemplazado responde 403. El conector nunca mueve dinero: rechazos, decisiones de devolución, reclamaciones de compensación, órdenes de compra y actualizaciones masivas de productos están instalados apagados para que un administrador los active deliberadamente.

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 Claude

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

Ruta recomendada: funciona en claude.ai web sin editar ningún archivo de configuración.

  1. En Claude, abre Plugins (en algunos planes aún Customize) → Connectors.
  2. Haz clic en + Add, luego en Add custom connector.
  3. Ingresa un nombre, por ejemplo Skroutz, y la URL del servidor MCP remoto https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, luego haz clic en Continue, deja los ajustes detectados y vuelve a hacer clic en Continue.
  4. Elige Sign in now, haz clic en Add e inicia sesión en AnythingMCP (OAuth) para permitir el acceso.

Todas las herramientas a continuación aparecen en tu chat: comienza a escribir indicaciones.

Herramientas disponibles

HerramientaQué hace
skroutz_get_orderLee un pedido de Skroutz Marketplace (Smart Cart) por su código: estado (abierto, aceptado, rechazado, cancelado, expirado, despachado, entregado…
skroutz_accept_orderAcepta un pedido abierto: Skroutz luego reserva el mensajero y emite el voucher (llega en el pedido como courier_voucher). Envía un…
skroutz_reject_orderRechaza un pedido abierto, ya sea por línea de artículo con un id de razón de reject_options (con available_quantity cuando la razón tiene…
skroutz_reschedule_order_pickupMueve la recogida del mensajero de un pedido aceptado a otra fecha. Lee el pedido con action_options 1 justo antes y envía uno de sus…
skroutz_relocate_order_pickupMueve la recogida del mensajero de un pedido aceptado a otra de las ubicaciones de recogida de la tienda, manteniendo la fecha y el horario de recogida. El mensajero es…
skroutz_set_order_readyMarca un pedido aceptado como empaquetado y listo para despachar (Marcar como listo). Requerido para tiendas cuyos pedidos muestran set_as_ready_required verdadero…
skroutz_set_order_not_readyDeshace Marcar como listo en un pedido aceptado que el mensajero aún no ha recogido. Skroutz intenta mover la recogida de vuelta a la fecha original.…
skroutz_update_tracking_detailsEnvía el mensajero y el código de seguimiento de cada envío de un pedido Fulfilled by Merchant (FBM), para que el cliente pueda seguirlo. Solo para FBM…
skroutz_request_preorder_voucherSolicita el voucher del mensajero de un pedido anticipado aceptado ahora, cuando el producto llegó antes de la fecha de envío planificada (el panel de Crear…
skroutz_upload_invoiceSube el recibo o factura de un pedido desde un enlace al archivo (PDF, PNG o JPG, máximo 7 MB). Un archivo por pedido: una nueva carga…
skroutz_upload_credit_invoiceSube la factura de crédito de un pedido que fue cancelado, devuelto, parcialmente devuelto o devuelto al remitente después de su recibo o factura…
skroutz_file_compensation_requestPide a Skroutz que compense a la tienda por artículos de línea devueltos, enviados como JSON sin fotos, solo por razones que no necesitan ninguna…
skroutz_get_returnLee una devolución por su código: estado (pending_merchant_review, returning, pending_physical_review, pending_service_inspection, returned…
skroutz_handle_returnDecide una devolución en estado pending_merchant_review con una de sus handle_options: aprobar, un rechazo como not_faulty (con comentario cuando…
skroutz_submit_service_inspectionEnvía el resultado de la inspección técnica de un artículo defectuoso devuelto (devolución en estado pending_service_inspection): el id del artículo, uno de sus…
skroutz_list_fbs_productsLista los productos Fulfilled by Skroutz (FBS) de la tienda almacenados en los almacenes de Skroutz: id, shop_uid (tu id de producto), activo (comprable desde el…
skroutz_list_fbs_purchase_ordersLista las órdenes de compra Fulfilled by Skroutz de la tienda (stock enviado a los almacenes de Skroutz): código, created_at, expected_date y received_at.…
skroutz_list_fbs_purchase_order_itemsLista los artículos de línea de una orden de compra Fulfilled by Skroutz: product_id, shop_uid, activo, expected_quantity y actual_quantity…
skroutz_create_fbs_purchase_orderAnuncia una nueva orden de compra Fulfilled by Skroutz: el stock que entregarás a un almacén de Skroutz, con la fecha esperada, el proveedor…
skroutz_list_fbs_suppliersLista los proveedores Fulfilled by Skroutz de la tienda: id (úsalo para órdenes de compra), código, nombre, dirección, ciudad, área, código postal, teléfono…
skroutz_create_fbs_supplierAñade un proveedor Fulfilled by Skroutz (que envía stock al almacén de Skroutz por ti) con un código único, nombre, dirección, ciudad, área, código postal…
skroutz_update_fbs_supplierCambia campos de un proveedor Fulfilled by Skroutz; solo los campos que envíes cambian. Responde success: true
skroutz_validate_product_updatesVerifica un lote de actualizaciones de productos (disponibilidad, precio en centavos, cantidad, variaciones) sin cambiar nada: Skroutz ejecuta cada verificación…
skroutz_update_productsActualiza disponibilidad, precio (centavos de euro) y cantidad de hasta 500 productos existentes y sus variaciones en un lote; no crea…
skroutz_get_product_update_statusLee el resultado de una actualización de lote de productos: estado (in_progress mientras cualquier producto esté pendiente, luego completado), created_at, y por producto…
skroutz_get_cps_orderLee una orden CPS (una venta en tu propia tienda web que vino de Skroutz, pagada por comisión) por el código de pedido que tu tienda le dio: fecha…
skroutz_reject_cps_orderRechaza una orden CPS para que Skroutz no cobre comisión sobre ella, con una de sus reject_options (user_cancel, user_return, undelivered…

Ejemplos de indicaciones

  • "Muestra el pedido 251114-3920517 con sus artículos, sus opciones de recogida y cuándo expira."
  • "Acepta el pedido 251114-3920517 para la primera ventana de recogida de mi almacén en Atenas."
  • "El pedido 251112-1187340 necesita Marcar como listo: ¿está listo para marcar, y cuándo es la recogida?"
  • "¿Qué dice la devolución R-251110-2045318, y hasta cuándo tengo que revisarla?"
  • "¿Cuántas unidades de cada producto tengo en los almacenes de Skroutz?"

Preguntas frecuentes

¿Funciona con Claude Code así como con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.

¿De dónde vienen los tokens? Desde el panel de comerciantes de Skroutz, y son tres tokens separados: el token de API del mercado bajo Servicios, Skroutz Marketplace (pedidos, devoluciones, Fulfilled by Skroutz), el token de API de Productos opcional bajo Productos, Actualizaciones de Feed para actualizaciones masivas de precios y stock, y el token CPS opcional para órdenes de tu propia tienda web. Generar un nuevo token de mercado finaliza el anterior.

¿Puede listar mis pedidos? No. La API de Skroutz no tiene lista de pedidos: los pedidos llegan a una tienda a través del webhook, el panel de comerciantes y los correos electrónicos de pedidos. Dale a la IA el código del pedido (como 251114-3920517) y lee el pedido. Los códigos de demostración como DEMO-OPEN son seguros para pruebas.

¿Qué herramientas están instaladas apagadas? skroutz_reject_order y skroutz_reject_cps_order, porque un rechazo no se puede deshacer, las herramientas de devolución skroutz_handle_return, skroutz_submit_service_inspection y skroutz_file_compensation_request, skroutz_create_fbs_purchase_order, que conduce a tarifas de almacén, y skroutz_update_products.

Próximos pasos

¿Te ha sido útil esta guía?

Conecta Skroutz a Claude en 2 minutos

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

Guías relacionadas

Conectores

Conectar Skroutz MCP con ChatGPT: pedidos y stock

API de Skroutz Marketplace (Smart Cart) para vendedores en el mercado griego y chipriota: leer, aceptar y programar pedidos, marcar como listo, seguimiento, carga de facturas, devoluciones, stock gestionado por Skroutz, órdenes de compra y proveedores, actualizaciones masivas de precios y stock y órdenes CPS. Token de API desde el panel de comerciantes.

Conectores

Conectar Skroutz MCP con Microsoft Copilot

API de Skroutz Marketplace (Smart Cart) para vendedores en el mercado griego y chipriota: leer, aceptar y programar pedidos, marcar como listo, seguimiento, carga de facturas, devoluciones, stock gestionado por Skroutz, órdenes de compra y proveedores, actualizaciones masivas de precios y stock y órdenes CPS. Token de API desde el panel de comerciantes.

Conectores

Conectar Skroutz MCP con Cursor: pedidos y stock

API de Skroutz Marketplace (Smart Cart) para vendedores en el mercado griego y chipriota: leer, aceptar y programar pedidos, marcar como listo, seguimiento, carga de facturas, devoluciones, stock gestionado por Skroutz, órdenes de compra y proveedores, actualizaciones masivas de precios y stock y órdenes CPS. Token de API desde el panel de comerciantes.

Conectores

Conectar Skroutz MCP con Gemini CLI: pedidos y stock

API de Skroutz Marketplace (Smart Cart) para vendedores en el mercado griego y chipriota: leer, aceptar y programar pedidos, marcar como listo, seguimiento, carga de facturas, devoluciones, stock gestionado por Skroutz, órdenes de compra y proveedores, actualizaciones masivas de precios y stock y órdenes CPS. Token de API desde el panel de comerciantes.

Conectores

Conectar Skroutz MCP con Meta Muse: pedidos y stock

API de Skroutz Marketplace (Smart Cart) para vendedores en el mercado griego y chipriota: leer, aceptar y programar pedidos, marcar como listo, seguimiento, carga de facturas, devoluciones, stock gestionado por Skroutz, órdenes de compra y proveedores, actualizaciones masivas de precios y stock y órdenes CPS. Token de API desde el panel de comerciantes.

Conectores

Servidor Skroutz MCP: pedidos, stock y devoluciones

API de Skroutz Marketplace (Smart Cart) para vendedores en el mercado griego y chipriota: leer, aceptar y programar pedidos, Marcar como Listo, seguimiento, carga de facturas, devoluciones, stock Gestionado por Skroutz, pedidos de compra y proveedores, actualizaciones masivas de precios y stock y pedidos CPS. Token de API desde el panel de comerciantes.