Resumen
Gestiona tu tienda en el marketplace de Shop Apotheke desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidentes, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace opera en Alemania, Austria, Italia y Bélgica; inicia sesión con la clave API de la tienda desde tu oficina de vendedor de Shop Apotheke.
Configuración guiada
Conecta Shop Apotheke Marketplace a Claude en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Shop Apotheke Marketplace 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 Shop Apotheke Marketplace
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, haz clic en Conectores → Shop Apotheke Marketplace, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Shop Apotheke Marketplace + Claude
Gestiona tu tienda en el marketplace de Shop Apotheke desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidentes, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace opera en Alemania, Austria, Italia y Bélgica; inicia sesión con la clave API de la tienda desde tu oficina de vendedor de Shop Apotheke.
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:
SHOP_APOTHEKE_API_KEY
Paso 1 — Obtener credenciales
Países: Alemania, Austria, Italia y Bélgica. El marketplace está activo en Alemania y Austria; Italia (redcare.it) y Bélgica (farmaline.be) tienen un programa de socios con sus propios contratos.
Quién puede vender: Shop Apotheke aprueba a cada socio, puede revisar primero el feed de productos y firma un contrato por país; solicita en su página de socios. El conector necesita una cuenta de vendedor que Shop Apotheke ya haya abierto.
Solo las tiendas de Alemania y Austria están confirmadas en esta dirección; se asume que las tiendas italianas y belgas también la utilizan.
La configuración tarda aproximadamente 5 minutos.
- Inicia sesión en la oficina de vendedor de Shop Apotheke:
https://shopapotheke.mirakl.net/login. - En la oficina, abre tu nombre de usuario (arriba a la derecha) > Mis configuraciones de usuario > Clave API y haz clic en Generar una nueva clave (o copia la clave existente). Pégala en
SHOP_APOTHEKE_API_KEY. La clave se envía tal cual en el encabezadoAuthorization, sinBearer. Generar una nueva clave invalida la anterior, por lo que cualquier otra herramienta que la use dejará de funcionar. - Shop Apotheke firma un contrato separado para cada país, por lo que un vendedor en varios países tiene varias tiendas. Si tu usuario tiene más de una tienda, establece
SHOP_APOTHEKE_SHOP_IDal id numérico de la tienda en la que debe funcionar este conector (mostrado en el panel de la oficina junto a Identifier o Shop ID, y devuelto comoshop_idporshop_apotheke_get_account); para trabajar en varias tiendas, instala el conector una vez por tienda. Sin esto, se utilizará tu tienda predeterminada. - Instala y ejecuta
shop_apotheke_get_account: devuelve la tienda a la que pertenece la clave.
Dónde empezar: shop_apotheke_get_account muestra la tienda detrás de la clave (id, nombre, estado, moneda y canales). Para el trabajo diario, utiliza shop_apotheke_list_orders con order_state_codes=WAITING_ACCEPTANCE, shop_apotheke_list_offers para precios y stock y shop_apotheke_list_threads para mensajes que esperan respuesta.
Productos y ofertas competidoras: shop_apotheke_get_products busca productos en el catálogo de Shop Apotheke por EAN u otra referencia y devuelve el SKU del producto en el marketplace; shop_apotheke_list_product_offers lista las ofertas de cada tienda para productos dados, mejor precio primero, a aproximadamente 5 llamadas por minuto.
Flujo de trabajo de pedidos: un nuevo pedido espera en WAITING_ACCEPTANCE. shop_apotheke_accept_order acepta (o rechaza) cada línea; después de que se debite al cliente, el pedido pasa a SHIPPING. Luego, shop_apotheke_update_tracking almacena el transportista y el número de seguimiento (los códigos de transportista provienen de shop_apotheke_list_carriers) y shop_apotheke_ship_order confirma el envío (SHIPPED). Los estados posteriores son TO_COLLECT, RECEIVED, CLOSED, REFUSED y CANCELED. Utiliza shop_apotheke_list_orders con order_state_codes=WAITING_ACCEPTANCE para la lista de tareas diarias y has_incident=true para incidentes abiertos; shop_apotheke_resolve_incident cierra un incidente en una línea de pedido una vez que se resuelve. Los documentos adjuntos a los pedidos (notas de entrega, etiquetas, facturas de clientes) se listan mediante shop_apotheke_list_order_documents.
Escrituras: confirma primero. shop_apotheke_accept_order, shop_apotheke_update_tracking, shop_apotheke_ship_order, shop_apotheke_resolve_incident, shop_apotheke_accept_return, shop_apotheke_receive_return, shop_apotheke_update_offers, shop_apotheke_reply_thread, shop_apotheke_create_order_thread y shop_apotheke_import_products actúan en el marketplace en vivo. Antes de cada llamada, muestra al usuario qué cambiará (id y líneas del pedido, número de seguimiento, SKU de la oferta con el precio o stock antiguo y nuevo, el texto del mensaje y los destinatarios) y espera un sí. Rechazar una línea de pedido la cancela de forma permanente. Ninguna herramienta aquí reembolsa, cancela pedidos o mueve dinero; hazlo en la oficina. shop_apotheke_import_offers puede eliminar ofertas (el modo REPLACE elimina cada oferta que falta en el archivo), por lo que se instala apagado.
Actualización de ofertas (precios y stock): shop_apotheke_update_offers (OF24) reemplaza toda la oferta. Cada campo que dejes fuera se restablece: una quantity faltante se convierte en 0, un discount o description faltante se elimina. Siempre lee la oferta primero (shop_apotheke_get_offer o shop_apotheke_list_offers con sku) y envíala de vuelta completa con solo el cambio previsto: shop_sku, product_id y product_id_type (de product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (su código), min_quantity_alert, description, discount, all_prices, available_started / available_ended (leído como available_start_date / available_end_date) y cualquier offer_additional_fields. Deja update_delete vacío o update. La llamada devuelve un import_id; el cambio se aplica de forma asíncrona, así que revísalo con shop_apotheke_get_offer_import antes de leer la oferta nuevamente. Los códigos de condición para state_code provienen de shop_apotheke_list_offer_conditions, los códigos de clase logística de shop_apotheke_list_logistic_classes.
Importaciones de archivos: shop_apotheke_import_products (P41) y shop_apotheke_import_offers (OF01) toman la URL de un archivo CSV, XLSX o XML en el formato de archivo que Shop Apotheke solicita; el conector lo descarga y lo sube a Shop Apotheke. Rastreálos con shop_apotheke_list_product_imports / shop_apotheke_get_product_import y shop_apotheke_list_offer_imports / shop_apotheke_get_offer_import.
Devoluciones: shop_apotheke_list_returns (RT11) lista las solicitudes de devolución. Donde Shop Apotheke deja que la tienda decida, shop_apotheke_accept_return acepta o rechaza una en WAITING_ACCEPTANCE y shop_apotheke_receive_return confirma que los bienes han llegado. Los reembolsos permanecen en la oficina.
Mensajes: shop_apotheke_list_threads lista conversaciones (filtra con entity_type=MMP_ORDER y entity_id=<order id> para un pedido; entity_id sin entity_type es rechazado), shop_apotheke_get_thread lee uno con sus mensajes, shop_apotheke_reply_thread responde (destinatario CUSTOMER u OPERATOR, que es Shop Apotheke) y shop_apotheke_create_order_thread abre una nueva conversación sobre un pedido. Los códigos de razón para temas provienen de shop_apotheke_list_reasons; deja su locale vacío a menos que sepas que el marketplace tiene ese idioma (un locale inactivo responde 400).
Dinero: shop_apotheke_list_invoices (IV01) lista los documentos contables que Shop Apotheke emite a la tienda y shop_apotheke_list_transactions (TL02) las líneas de transacción (ventas, comisiones, reembolsos, pagos). Si Shop Apotheke utiliza facturación de vendedor mejorada, IV01 no devuelve nuevos documentos; utiliza shop_apotheke_list_document_requests (DR11) y las transacciones entonces.
Listas de referencia: shop_apotheke_list_channels (sitios de país), shop_apotheke_list_carriers, shop_apotheke_list_shipping_zones, shop_apotheke_list_shipping_methods y shop_apotheke_list_logistic_classes cambian raramente; léelos una vez por conversación.
Paginación: pedidos, ofertas, facturas e importaciones de productos se paginan con max (máximo 100) y offset. Hilos, devoluciones, transacciones, solicitudes de documentos e importaciones de ofertas devuelven un next_page_token; pásalo como page_token para obtener la siguiente página (todos los demás filtros se ignoran) hasta que falte.
Fechas son ISO 8601, por ejemplo, 2026-10-01T00:00:00Z; las respuestas están en UTC.
Límites de tasa: Cada API tiene su propio límite y Shop Apotheke puede endurecerlos. Listar ofertas y pedidos está destinado a uso interactivo, importaciones de productos y ofertas a lo sumo cada 15 minutos, shop_apotheke_get_account y las listas de referencia aproximadamente una vez al día. Un 429 lleva un encabezado Retry-After con los segundos a esperar; no intentes de nuevo en un bucle.
Errores: 401 significa que la clave es incorrecta o fue reemplazada por una más nueva, 403 que tu usuario carece del derecho para esta acción, 404 que el pedido, oferta o hilo no existe para esta tienda, 400 un parámetro incorrecto o un pedido en el estado incorrecto (el mensaje lo nombra, por ejemplo, ORDER_INVALID_STATE).
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 muestreYOUR_SERVER_ID.
Ruta recomendada: funciona en claude.ai web sin editar ningún archivo de configuración.
- En Claude, abre Plugins (en algunos planes aún Customize) → Connectors.
- Haz clic en + Add, luego en Add custom connector.
- Introduce un nombre, por ejemplo,
Shop Apotheke Marketplace, y la URL del servidor MCP remotohttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID, luego haz clic en Continue, deja los ajustes detectados y vuelve a hacer clic en Continue. - 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 aparecerán en tu chat: comienza a escribir mensajes.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
shop_apotheke_get_account | Lee la tienda detrás de la clave API en este marketplace (A01): id y nombre de la tienda, estado, canales, moneda, grado y tasa de aprobación, contacto… |
shop_apotheke_list_orders | Lista pedidos (OR11) con sus líneas, cliente, dirección de envío, precios, estado e incidentes. Filtra por estado (por ejemplo, WAITING_ACCEPTANCE para… |
shop_apotheke_list_offers | Lista las ofertas de la tienda (OF21): SKU, producto, precio y descuento, todos los precios de canal, cantidad en stock, condición, tiempo de entrega y si… |
shop_apotheke_get_offer | Lee una oferta completa por su id de oferta (OF22): cada campo de precio, descuento, cantidad, condición, clase logística, tiempo de entrega y campos personalizados… |
shop_apotheke_list_offer_conditions | Lista las condiciones de oferta (OF61) que el marketplace acepta, por ejemplo, nuevo o usado, con el código para poner en state_code al actualizar ofertas |
shop_apotheke_list_offer_imports | Lista importaciones y actualizaciones de ofertas (OF04), desde archivos y desde shop_apotheke_update_offers: estado (WAITING, RUNNING, COMPLETE, FAILED), líneas… |
shop_apotheke_get_offer_import | Lee el estado de una importación de oferta o actualización de oferta (OF02) por su import_id, como lo devuelve shop_apotheke_update_offers o… |
shop_apotheke_export_offers | Inicia una exportación de todas las ofertas de la tienda como archivos (OF52), la forma de leer el catálogo completo (cada SKU con precio y stock) en lugar de paginar shop_apotheke_list_offers |
shop_apotheke_get_offer_export_status | Estado de una exportación de ofertas iniciada con shop_apotheke_export_offers (OF53): PENDING, COMPLETED o FAILED y, una vez completada, las URL de los archivos |
shop_apotheke_get_offer_export_file | Lee un archivo de una exportación de ofertas completada (OF54): las ofertas con su SKU, producto, cantidad, precios y los demás campos exportados, en JSON o CSV |
shop_apotheke_list_product_imports | Lista importaciones de productos (P51) con su estado (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), los conteos de transformación y los… |
shop_apotheke_get_product_import | Lee el estado de una importación de producto (P42) por su import_id: estado de importación, razón, conteos de transformación y los detalles de integración… |
shop_apotheke_get_products | Busca productos en el catálogo del marketplace por sus identificadores (P31), por ejemplo, EAN, y obtén el SKU del producto en el marketplace, título y categoría.… |
shop_apotheke_list_product_offers | Lista las ofertas de cada tienda para productos dados (P11), ordenadas por mejor precio, para comparar tu precio con la competencia. Da product_ids… |
shop_apotheke_list_threads | Lista hilos de mensajes (M11) con clientes y Shop Apotheke: tema, pedido u oferta vinculada, participantes, fecha del último mensaje y desde cuándo un… |
shop_apotheke_get_thread | Lee un hilo de mensaje (M10) con todos sus mensajes, remitentes, destinatarios, adjuntos y el pedido u oferta vinculada |
shop_apotheke_list_returns | Lista solicitudes de devolución (RT11) con su estado, líneas de devolución, razón, RMA, seguimiento y el pedido vinculado. Filtra por estado, pedido o fecha.… |
shop_apotheke_list_reasons | Lista los códigos de razón del marketplace (RE01): incidentes, cancelaciones, reembolsos y razones de mensajes, con sus etiquetas y si la tienda puede… |
shop_apotheke_list_carriers | Lista los transportistas que conoce el marketplace (SH21) con su código, etiqueta y URL de seguimiento. Usa el código como carrier_code en… |
shop_apotheke_list_invoices | Lista los documentos contables que Shop Apotheke emite a la tienda (IV01): facturas y notas de crédito con periodo, totales con y sin impuestos… |
shop_apotheke_list_transactions | Lista las líneas de transacción de la tienda (TL02): montos de pedidos, envío, comisiones, reembolsos, créditos manuales y pagos, con monto, tipo… |
shop_apotheke_list_document_requests | Lista solicitudes de documentos contables (DR11), utilizadas cuando Shop Apotheke ejecuta facturación de vendedor mejorada: facturas y notas de crédito que Shop… |
shop_apotheke_list_order_documents | Lista los documentos adjuntos a uno o más pedidos (OR72): notas de entrega, etiquetas de envío, facturas de clientes y otros archivos, con id, archivo… |
shop_apotheke_list_channels | Lista los canales de venta del marketplace (CH11), generalmente uno por sitio de país, con código y etiqueta. Usa los códigos como channel_codes en… |
shop_apotheke_list_shipping_zones | Lista las zonas de envío activas del marketplace (SH11) con código y etiqueta, por ejemplo, Francia continental o Córcega. Cambios raramente: llámalo… |
shop_apotheke_list_shipping_methods | Lista los métodos de envío activos del marketplace (SH12), por ejemplo, estándar, exprés o recogida, con código, etiqueta, si un número de seguimiento… |
shop_apotheke_list_logistic_classes | Lista las clases logísticas del marketplace (SH31), los tamaños o bandas de peso que deciden los precios de envío, con código y etiqueta. Usa el código como… |
shop_apotheke_accept_order | Acepta o rechaza las líneas de un pedido que espera aceptación (OR21). Cada línea del pedido debe estar listada. Rechazar una línea la cancela… |
shop_apotheke_update_tracking | Establece el transportista y el número de seguimiento de un pedido (OR23). Da carrier_code de shop_apotheke_list_carriers, o carrier_name con… |
shop_apotheke_ship_order | Confirma que un pedido en SHIPPING ha sido enviado (OR24); pasa a SHIPPED y se notifica al cliente. Establece el seguimiento primero con… |
shop_apotheke_update_offers | Crea o actualiza ofertas, incluyendo precio y stock (OF24). Reemplaza cada oferta completamente: cada campo dejado fuera se restablece (una falta… |
shop_apotheke_reply_thread | Responde en un hilo de mensaje (M12) al cliente o a Shop Apotheke. El mensaje se entrega de inmediato y no puede ser retirado: muestra al usuario… |
shop_apotheke_create_order_thread | Inicia un nuevo hilo de mensaje sobre un pedido (OR43) con el cliente, Shop Apotheke o ambos. El mensaje se entrega de inmediato: muestra al usuario el… |
shop_apotheke_resolve_incident | Marca el incidente abierto en una línea de pedido como resuelto (OR64), una vez que se soluciona el problema del cliente. reason_code debe ser un INCIDENT_CLOSE… |
shop_apotheke_accept_return | Acepta o rechaza una solicitud de devolución en WAITING_ACCEPTANCE (RT21). Solo cuando Shop Apotheke maneja devoluciones en la oficina del vendedor y… |
shop_apotheke_receive_return | Confirma que los bienes de una devolución aceptada llegaron a tu almacén (RT25). La devolución pasa a RECEIVED. Actúa en el marketplace en vivo… |
shop_apotheke_import_products | Envía un archivo de producto al marketplace (P41) para crear o enriquecer productos en su catálogo. file_url es la dirección de un CSV, XLSX o XML… |
shop_apotheke_import_offers | Importa un archivo de ofertas (OF01) para crear, actualizar o eliminar ofertas en bloque. El modo REPLACE elimina cada oferta que no está en el archivo, y… |
Ejemplos de mensajes
- "¿Qué pedidos de Shop Apotheke están esperando mi aceptación?"
- "Establece el stock de mis cápsulas de magnesio SKU MG-400-90 en 120."
- "¿Qué solicitudes de devolución están esperando mi decisión?"
- "Añade el seguimiento de DHL 00340434161234567891 al pedido 6604412-A y confirma el envío."
- "Muestra las facturas que Shop Apotheke me emitió en octubre."
Preguntas frecuentes
¿Funciona con Claude Code así como con Claude Desktop? Sí, apunta ambos a https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
¿Dónde obtengo la clave API de Shop Apotheke? En la oficina de vendedor de Shop Apotheke: tu nombre de usuario (arriba a la derecha), Mis configuraciones de usuario, Clave API, luego Generar una nueva clave (o copia la clave existente). Generar una nueva clave invalida la anterior. Shop Apotheke firma un contrato separado para cada país, por lo que un vendedor en varios países tiene varias tiendas. Con más de una tienda, establece SHOP_APOTHEKE_SHOP_ID en la tienda en la que debe funcionar este conector.
¿Quién puede vender en Shop Apotheke y qué países cubre? Shop Apotheke aprueba a cada socio, puede revisar primero el feed de productos y firma un contrato por país; solicita en su página de socios. El conector cubre Alemania, Austria, Italia y Bélgica. El marketplace está activo en Alemania y Austria; Italia (redcare.it) y Bélgica (farmaline.be) tienen un programa de socios con sus propios contratos. Solo las tiendas de Alemania y Austria están confirmadas en esta dirección; se asume que las tiendas italianas y belgas también la utilizan.
¿Puede cancelar pedidos, reembolsar o eliminar ofertas? Ninguna herramienta reembolsa o cancela un pedido; hazlo en la oficina de Shop Apotheke. Rechazar una línea al aceptar un pedido la cancela de forma permanente, por lo que la IA te muestra cada escritura y espera un sí. shop_apotheke_import_offers se instala apagado, porque su modo REPLACE elimina cada oferta que falta en el archivo; actívalo en la página del conector solo si la IA debe usarlo.
Próximos pasos
- Página de inicio del conector
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?