Come collegare QLS a Gemini via MCP

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → QLS, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

QLS + Gemini

Pakketdienst QLS (Paesi Bassi): spedizioni di pacchi con etichette e tracking, prodotti di spedizione e punti di ritiro, ordini di fulfilment evasi dal magazzino QLS, articoli e giacenze di fulfilment, backorder, resi e ordini di acquisto in entrata. Eliminare articoli e annullare ordini sono disattivati all'installazione.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

QLS_USERNAME, QLS_PASSWORD

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti serve un account su mijn.pakketdienstqls.nl.

1. QLS autentica l'API con HTTP Basic e le credenziali del portale mijn.pakketdienstqls.nl. Se il tuo account lo consente, usa un utente separato per l'API (chiedi al supporto IT di QLS a [email protected]), così il cambio di password di una persona non blocca il connettore.
2. Inserisci il nome utente (di solito un indirizzo email) in QLS_USERNAME e la password in QLS_PASSWORD.
3. Installa il connettore ed esegui qls_list_companies. Restituisce l'id dell'azienda (un UUID) che ogni altro strumento richiede come company_id; qls_get_company mostra un'azienda.

Quale API: la QLS Fulfilment and Parcel Service API su https://api.pakketdienstqls.nl (OpenAPI su https://api.pakketdienstqls.nl/swagger/). QLS pubblica una v1 e una v2; il connettore usa la v2 dove QLS la offre (creazione spedizioni, resi, ordini di acquisto) e la v1 per il resto.

Id che ti servono prima: l'id dell'azienda da qls_list_companies; l'id del brand da qls_list_brands (un brand porta gli indirizzi di mittente, reso e dogana ed è necessario per spedizioni e ordini); i prodotti di spedizione da qls_list_shipping_products, con combinations[].id come product_combination_id, options[].tag come opzioni di consegna, prezzi per paese e fascia di peso e dimensioni massime. I punti di ritiro arrivano da qls_list_service_points o, per un solo prodotto di spedizione, da qls_list_product_service_points; il loro servicepoint_code va sulla spedizione o sull'ordine.

Cosa legge: le spedizioni di pacchi con stato (created, printed, pre_transit, in_transit, delivered, returned_to_sender), barcode, id e URL di tracking, filtrate per riferimento, barcode, stato, brand, campi del destinatario, date o ricerca libera; una spedizione con il peso e, con with_label, gli URL dell'etichetta in PDF e ZPL; la spedizione di reso di un pacco; gli ordini di fulfilment con stato, quantità ordinate, riservate e consegnate, destinatario, consegne e spedizioni uscite dal magazzino; gli articoli di fulfilment con EAN, SKU, codice articolo, prezzi, totali di giacenza e ubicazioni di magazzino (zona, scaffale, ripiano, scadenza); la giacenza per articolo (totale, riservata, disponibile, vendibile, venduta, backorder, in arrivo, prevista) e per ubicazione con lotto; i backorder; i resi con stato, consumatore, spedizione e ordine originali e gli articoli resi con motivo; gli ordini di acquisto (consegne in entrata annunciate) con stato, articoli, fornitori e consegne, anche quelli in transito; i fornitori.

Cosa scrive: qls_create_shipment prenota un pacco presso il corriere e restituisce barcode, URL di tracking e label_pdf_url; mittente e indirizzo di reso sono quelli del brand se non indicati. qls_create_fulfillment_order fa prelevare, imballare e spedire a QLS gli articoli dalla tua giacenza. qls_update_fulfillment_order mette un ordine in attesa, lo rilascia o cambia data di lavorazione, riferimento, note o punto di ritiro. qls_create_fulfillment_product e qls_update_fulfillment_product gestiscono gli articoli; qls_create_return_from_order annuncia un reso; qls_create_purchase_order annuncia merce in arrivo al magazzino. Una spedizione costa e un ordine di fulfilment spedisce giacenza reale, quindi prima di ogni scrittura l'AI mostra destinatario, articoli e quantità e prodotto di spedizione e aspetta il tuo sì.

Disattivati all'installazione: qls_delete_fulfillment_product e qls_cancel_fulfillment_order, che non si possono annullare. Un amministratore li attiva quando il team ne ha bisogno.

Formati dei dati: ogni risposta è racchiusa come {"meta": {"code": 200}, "errors": [], "data": ..., "pagination": ...}; i dati stanno in data. I pesi sono in grammi, prezzi e contrassegno in euro, le dimensioni in millimetri. Gli id di aziende, brand, ordini, articoli e spedizioni sono stringhe UUID; gli id di prodotti di spedizione e combinazioni sono interi. Gli stati degli ordini di fulfilment sono error_validation, concept, received, pending, partically_sent (grafia di QLS) e sent. I filtri di data su giacenze e ordini di acquisto usano d-m-Y H:i (ad es. 1-10-2026 00:00), gli altri una data o data e ora come 2026-10-01 00:00:00.

Paginazione: gli elenchi restituiscono fino a 100 voci per pagina. pagination contiene page, pageCount, count e nextPage; l'AI chiede la page successiva finché nextPage è true.

Errori comuni: 401 significa nome utente o password errati: sono le credenziali di mijn.pakketdienstqls.nl. 404 (Niet Gevonden) significa un id sconosciuto o un id azienda che non è tuo: prendi gli id dagli strumenti di elenco. 422 o una lista errors piena indica un problema di validazione; QLS risponde in olandese.

Il connettore non annulla spedizioni di pacchi, non legge le fatture QLS e non modifica brand o impostazioni aziendali: non ci sono strumenti per farlo.

Step 2 — Installa l'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

Step 3 — Aggiungi il connettore in Gemini

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di QLS.

Tool disponibili

Esempi di prompt

• "Quali prodotti di spedizione QLS possiamo usare per Paesi Bassi e Belgio, con il prezzo per fascia di peso?"
• "Trova i punti di ritiro DHL vicino al CAP 3011 AB."
• "Crea un pacco PostNL per l'ordine 1042 a Jan de Vries, Rotterdam, 1.200 grammi. Mostrami prima destinatario, prodotto e peso."
• "Quali articoli di fulfilment hanno meno di 20 pezzi disponibili, e cosa è in arrivo?"
• "Elenca gli ordini di fulfilment di questa settimana ancora pending o partically_sent."

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Meta Muse
• Collegare a Microsoft Copilot