Cómo conectar QLS a ChatGPT vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → QLS, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

QLS + ChatGPT

Pakketdienst QLS (Países Bajos): envíos de paquetes con etiquetas y seguimiento, productos de envío y puntos de recogida, pedidos de fulfilment preparados en el almacén de QLS, artículos y stock de fulfilment, backorders, devoluciones y órdenes de compra entrantes. Borrar artículos y cancelar pedidos quedan desactivados 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:

QLS_USERNAME, QLS_PASSWORD

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas una cuenta en mijn.pakketdienstqls.nl.

1. QLS autentica la API con HTTP Basic y los datos de acceso del portal mijn.pakketdienstqls.nl. Si tu cuenta lo permite, usa un usuario aparte para la API (pídelo al soporte de IT de QLS en [email protected]), para que el cambio de contraseña de una persona no rompa el conector.
2. Pon el nombre de usuario (normalmente un email) en QLS_USERNAME y la contraseña en QLS_PASSWORD.
3. Instala el conector y ejecuta qls_list_companies. Devuelve el id de empresa (un UUID) que todas las demás herramientas piden como company_id; qls_get_company muestra una empresa.

Qué API: la QLS Fulfilment and Parcel Service API en https://api.pakketdienstqls.nl (OpenAPI en https://api.pakketdienstqls.nl/swagger/). QLS publica una v1 y una v2; el conector usa la v2 donde QLS la ofrece (creación de envíos, devoluciones, órdenes de compra) y la v1 para el resto.

Ids que necesitas primero: el id de empresa de qls_list_companies; el id de marca de qls_list_brands (una marca lleva las direcciones de remitente, devolución y aduanas y hace falta para envíos y pedidos); los productos de envío de qls_list_shipping_products, con combinations[].id como product_combination_id, options[].tag como opciones de entrega, precios por país y tramo de peso y medidas máximas. Los puntos de recogida salen de qls_list_service_points o, para un solo producto de envío, de qls_list_product_service_points; su servicepoint_code va en el envío o el pedido.

Qué lee: envíos de paquetes con estado (created, printed, pre_transit, in_transit, delivered, returned_to_sender), código de barras, id y URL de seguimiento, filtrados por referencia, código de barras, estado, marca, campos del destinatario, fechas o búsqueda libre; un envío con su peso y, con with_label, las URL de la etiqueta en PDF y ZPL; el envío de devolución de un paquete; pedidos de fulfilment con estado, cantidades pedidas, reservadas y entregadas, destinatario, entregas y los envíos que salieron del almacén; artículos de fulfilment con EAN, SKU, número de artículo, precios, totales de stock y ubicaciones del almacén (zona, estantería, balda, consumo preferente); el stock por artículo (total, reservado, disponible, vendible, vendido, backorder, entrante, previsto) y por ubicación con lote; backorders; devoluciones con estado, consumidor, envío y pedido originales y los artículos devueltos con motivo; órdenes de compra (entregas entrantes anunciadas) con estado, artículos, proveedores y entregas, también las que están en tránsito; proveedores.

Qué escribe: qls_create_shipment reserva un paquete con el transportista y devuelve código de barras, URL de seguimiento y label_pdf_url; remitente y dirección de devolución salen de la marca por defecto. qls_create_fulfillment_order hace que QLS prepare, embale y envíe artículos de tu stock. qls_update_fulfillment_order retiene un pedido, lo libera o cambia la fecha de proceso, la referencia, las notas o el punto de recogida. qls_create_fulfillment_product y qls_update_fulfillment_product mantienen artículos; qls_create_return_from_order anuncia una devolución; qls_create_purchase_order anuncia mercancía que llega al almacén. Un envío cuesta dinero y un pedido de fulfilment envía stock real, así que antes de cada escritura la IA muestra destinatario, artículos y cantidades y producto de envío y espera tu sí.

Desactivados al instalar: qls_delete_fulfillment_product y qls_cancel_fulfillment_order, que no se pueden deshacer. Un administrador los activa cuando el equipo los necesita.

Formatos de datos: cada respuesta viene envuelta como {"meta": {"code": 200}, "errors": [], "data": ..., "pagination": ...}; los datos están en data. Los pesos van en gramos, los precios y el contra reembolso en euros, las medidas en milímetros. Los ids de empresas, marcas, pedidos, artículos y envíos son cadenas UUID; los ids de productos de envío y combinaciones son enteros. Los estados de los pedidos de fulfilment son error_validation, concept, received, pending, partically_sent (grafía de QLS) y sent. Los filtros de fecha de stock y órdenes de compra usan d-m-Y H:i (p. ej. 1-10-2026 00:00); los demás, una fecha o fecha y hora como 2026-10-01 00:00:00.

Paginación: las listas devuelven hasta 100 entradas por página. pagination trae page, pageCount, count y nextPage; la IA pide la siguiente page mientras nextPage sea true.

Errores comunes: 401 significa usuario o contraseña incorrectos: son los datos de acceso de mijn.pakketdienstqls.nl. 404 (Niet Gevonden) significa un id desconocido o un id de empresa que no es tuyo: toma los ids de las herramientas de listado. 422 o una lista errors con contenido es un problema de validación; QLS responde en neerlandés.

El conector no cancela envíos de paquetes, no lee facturas de QLS y no cambia marcas ni ajustes de la empresa: no hay herramientas para ello.

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 ChatGPT

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.

ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
2. Escribe un nombre, por ejemplo Name: QLS.
3. En Connection, introduce como Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.

Herramientas disponibles

Ejemplos de prompts

• "¿Qué productos de envío de QLS podemos usar para Países Bajos y Bélgica, con su precio por tramo de peso?"
• "Busca los puntos de recogida de DHL cerca del código postal 3011 AB."
• "Crea un paquete de PostNL para el pedido 1042 a Jan de Vries, Rotterdam, 1.200 gramos. Enséñame antes destinatario, producto y peso."
• "¿Qué artículos de fulfilment tienen menos de 20 unidades disponibles y qué está entrando?"
• "Lista los pedidos de fulfilment de esta semana que siguen en pending o partically_sent."

FAQ

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot