Parla con i tuoi dati GSE-Web in linguaggio naturale

Il server MCP di GSE-Web connette gli assistenti AI (Claude, ChatGPT, ecc.) direttamente alla tua app di gestione magazzino. Fai domande, lancia azioni, ottieni report — senza scrivere una sola riga di codice.

55 strumenti 3 risorse 30 permessi

Cos'e MCP?

MCP (Model Context Protocol) e uno standard aperto creato da Anthropic che consente a un'AI di connettersi a fonti di dati esterne in modo sicuro e strutturato.

Pensalo come un traduttore universale: l'AI parla in linguaggio naturale, il server MCP traduce in richieste tecniche (API, SQL) e restituisce i risultati in un formato che l'AI comprende.

Vous (langage naturel) Claude / Assistant IA ↓ stdio Serveur MCP GSE-Web (local) ↓ HTTPS Serveur d'hébergement (proxies HTTPS) Bases de données GSE-Web
In breve: scrivi "Quali prodotti sono esauriti?" e l'AI interroga direttamente il tuo database GSE-Web per rispondere con dati reali.

Perche usare il server MCP?

💬

Domande in linguaggio naturale

Non serve piu navigare nei menu o conoscere SQL. Fai le tue domande come le faresti a un collega.

Risposte istantanee

L'AI analizza i dati e sintetizza i risultati. Una dashboard completa in una frase.

🔒

Sicurezza preservata

Stesse regole dell'applicazione: autenticazione JWT, permessi per ruolo (30 diritti), isolamento per organizzazione.

📝

Azioni automatizzate

Crea entrate/uscite di magazzino, cambia stati delle bolle di movimento — direttamente dalla conversazione.

📈

Analisi intelligenti

Alert di esaurimento, prodotti scaduti, statistiche — l'AI incrocia i dati e ti avvisa in modo proattivo.

🎓

Modulo formazione

Gli insegnanti possono seguire le classi, gli scenari e il progresso degli studenti con una semplice domanda.

Senza MCP / Con MCP

Senza MCP

  • Aprire l'applicazione GSE-Web
  • Navigare nei menu
  • Applicare filtri manualmente
  • Esportare in CSV, aprire Excel
  • Incrociare i dati a mano
  • Scrivere un report

Con MCP

  • "Quels produits ont un stock < 5 dans le magasin Central ?"
  • L'IA repond en 3 secondes avec un tableau
  • "Compare les sorties de janvier et fevrier"
  • L'IA génère l'analyse directement
  • "Créeune entrée de 50 unites pour le produit REF-2024"
  • Action effectuee, confirmation instantanée

Come funziona?

Il server MCP e un processo Node.js che gira localmente sulla tua macchina (o in remoto via HTTPS). Si autentica con GSE-Web usando le tue credenziali, poi espone 55 strumenti che l'AI puo chiamare.

Votre machine (local) ↓ Claude + MCP Server Serveur d'hébergément (proxies HTTPS) Bases de données GSE-Web
Nessuna porta da aprire: il server MCP comunica con Claude via stdio (input/output standard) e con GSE-Web via HTTPS. Nessun server web locale da esporre.

Prerequisiti

ElementoRichiestoNota
Node.jsv18 o superiorenodejs.org
npmIncluso con Node.js-
Claude CodeCLI Anthropicnpm install -g @anthropic-ai/claude-code
Account GSE-WebCredenziali valideStesso login dell'applicazione mobile/web
Connessione internetPer raggiungere le API di GSE-Web

Installazione passo per passo

Passo 1 — Compilare il server TypeScript

Apri un terminale nella cartella del progetto GSE-Web ed esegui:

cd mcp-server
npm install
npm run build

Il risultato compilato si trova in mcp-server/dist/.

Passo 2 — Verificare la configurazione

Nella radice del progetto, un file .mcp.json e gia configurato:

{
  "mcpServers": {
    "gse-web": {
      "command": "node",
      "args": ["dist/index.js"],
      "cwd": "/chemin/vers/gse_web_mobile_v2/mcp-server",
      "env": {
        "GSE_PROXY_BASE_URL": "https://gse-web-dev.xlexe.com",
        "GSE_DEFAULT_SERVER": "https://dev.gse-web.online/"
      }
    }
  }
}
Adattate il campo cwd al percorso reale della cartella mcp-server sulla vostra macchina. Per la produzione, sostituite le URL con https://gse-web.xlexe.com e https://www.gse-web.online/.

Passo 3 — Avviare Claude Code

Dalla radice del progetto:

claude

Claude Code rileva automaticamente .mcp.json e propone di attivare il server gse-web. Accetta.

Passo 4 — Autenticarsi

Nella conversazione Claude, scrivi semplicemente:

Connecte-moi au serveur de développement GSE-Web
avec l'identifiant "mon_login" et le mot de passe "mon_password"

Claude chiama lo strumento authenticate e conferma la tua connessione con la lista dei tuoi diritti.

Primo utilizzo: esempi concreti

Una volta autenticato, fai le tue domande in linguaggio naturale. Ecco alcuni esempi:

🔍 Rechercher des produits
"Cherche les produits contenant 'cable' dans la référence"

"Donne-moi les details du produit n°142 avec son stock par emplacement"

"Quelles sont les catégories de produits disponibles ?"

L'IA utilise search_products, get_product_details et get_catégories.

📦 Consulter les stocks
"Montre-moi le stock du magasin Central"

"Quels emplacements existent dans mon organisation ?"

"Y a-t-il des produits en rupture de stock ?"

L'IA utilise get_stock_levels, get_emplacements et get_stock_alerts.

🚚 Gérer les mouvements
"Liste les entrées de stock de cette semaine"

"Montre-moi les bons de mouvement a traiter"

"Affiche les details du bon de mouvement n°85"

L'IA utilise list_entrées, list_bon_mouvements et get_bon_mouvement_details.

✍️ Créer des opérations (droits requis)
"Créeune entrée de 50 unites du produit 142, emplacement A-03, magasin Central"

"Sortie de 10 unites du produit 98 avec le commentaire 'Chantier Bordeaux'"

"Passe le bon de mouvement 85 au statut 'termine'"

L'IA utilise create_entrée, create_sortie et update_bon_mouvement_statut.
Ces outils requierent des droits spécifiques (EDITER_ENTREE, EDITER_SORTIE, etc.).

📊 Obtenir des statistiques
"Donne-moi un résumé du tableau de bord : produits, stock, utilisateurs"

"Y a-t-il des produits qui périmént dans les 30 jours ?"

"Montre-moi les derniers logs d'erreur de l'application"

L'IA utilise get_dashboard_stats, get_stock_alerts et get_recent_logs.

🎓 Module formation
"Liste mes classes de formation"

"Quels scenarios pedagogiques sont disponibles ?"

"Montre la progression des eleves sur le scenario 12"

L'IA utilise list_classes, list_scenarios et get_student_progress.
Requiert le droit FORMATION_ENSEIGNANT.

Claude Code (CLI) — Interfaccia principale

Claude Code e l'interfaccia raccomandata per usare il server MCP. Rileva automaticamente la configurazione .mcp.json e propone di attivare il server.

Installazione

npm install -g @anthropic-ai/claude-code

Utilizzo

# Depuis la racine du projet GSE-Web
cd /chemin/vers/gse_web_mobile_v2

# Lancer Claude Code (detecte .mcp.json automatiquement)
claude

# Claude propose d'activer le serveur MCP "gse-web" → acceptez
# Vous pouvez ensuite discuter normalement :

> Connecte-moi au serveur dev avec login "admin" password "***"
> Quels produits sont en rupture de stock ?
> Créeune entrée de 20 unites pour le produit 45
Suggerimento: Claude Code mantiene il contesto della conversazione. Autenticatevi una sola volta all'inizio della sessione, poi fate tutte le domande che volete.

Claude Desktop

Compatibile con Claude Desktop (Windows/Mac). Configuralo aggiungendo la sezione mcpServers al file di configurazione.

Configurazione

Modifica il file di configurazione di Claude Desktop:

# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows
%APPDATA%\Claude\claude_desktop_config.json

Aggiungi la sezione mcpServers:

{
  "mcpServers": {
    "gse-web": {
      "command": "node",
      "args": ["/chemin/vers/mcp-server/dist/index.js"],
      "env": {
        "GSE_PROXY_BASE_URL": "https://gse-web-dev.xlexe.com",
        "GSE_DEFAULT_SERVER": "https://dev.gse-web.online/"
      }
    }
  }
}

Riavvia Claude Desktop. Il server appare nell'elenco degli strumenti disponibili.

Claude.ai — Integrazione diretta (consigliato)

Il metodo più semplice e potente. Collegate Claude direttamente ai vostri dati GSE-Web da claude.ai, senza installare nulla.

Per gli utenti Claude Pro, Max o Team: connetti direttamente il tuo server MCP tramite l'interfaccia claude.ai. Nessuna installazione locale richiesta.

🧠

Linguaggio naturale

Claude (Opus, Sonnet, Haiku) comprende il linguaggio naturale. Nessuna parola chiave da ricordare, fai le tue domande come le faresti a un collega.

💰

Incluso nel tuo abbonamento

Nessun costo aggiuntivo. L'integrazione MCP usa il tuo abbonamento Claude esistente (Pro, Max o Team).

🌐

100% nel browser

Tutto funziona nel browser. Niente da scaricare, niente da configurare sulla tua macchina.

🔒

Sicurezza di livello Claude

Autenticazione tramite le tue credenziali GSE-Web. Isolamento rigoroso per organizzazione. Nessun dato viene memorizzato dal server MCP.

📝

Lettura + scrittura

Consulta i tuoi stock, ma anche crea entrate/uscite — con verifica dei diritti a ogni azione.

📊

Analisi avanzati

Claude puo incrociare i dati, confrontare periodi, generare report — ha accesso a 55 strumenti specializzati.

Configurazione (una volta sola, 2 minuti)

Aprire le Impostazioni

Vai su claude.ai e clicca sull'icona dell'ingranaggio in basso a sinistra per aprire le Impostazioni.

Aggiungere un'integrazione

Nella sezione Integrazioni, clicca su "Aggiungi integrazione". Inserisci l'URL del server MCP:

AmbienteURL da copiare
Sviluppo / Demohttps://gse-web-dev.xlexe.com/api/mcp_remote.php
Produzionehttps://gse-web.xlexe.com/api/mcp_remote.php

L'integrazione appare nel tuo elenco con il nome "gse-web".

Autenticarsi

In una nuova conversazione Claude, di' semplicemente:

Connecte-moi au serveur GSE-Web demo
avec l'identifiant "mon_login" et le mot de passe "mon_password"

Claude chiama lo strumento authenticate e conferma la tua connessione con la lista dei tuoi diritti.

Fate le vostre domande!

Sei connesso. Chiedi quello che vuoi:

"Quels produits sont en rupture de stock ?"

"Montre-moi le stock sur l'emplacement HALLIDAY"

"Donne-moi le tableau de bord avec les chiffres clés"

"Liste les entrées de la semaine dernière"

"Créeune entrée de 50 gants isolants, emplacement A-03"

"Compare les sorties de janvier et fevrier"

Cosa Claude può fare con i vostri dati

🔍 Ricerca e consultazione
  • Cercare prodotti per referenza, nome, categoria o codice a barre
  • Vedere il dettaglio di un prodotto con il suo stock per ubicazione
  • Elencare lo stock filtrato per ubicazione
  • Consultare le categorie e le ubicazioni disponibili
📈 Analisi e allarmi
  • Dashboard: numero di prodotti, quantità totale, utenti
  • Allarmi rottura di stock (prodotti con quantità 0)
  • Allarmi scadenza (prodotti in scadenza tra 30 giorni)
  • Claude può incrociare e analizzare i risultati di più strumenti per rispondere a domande complesse
🚚 Movimenti di magazzino
  • Storico delle entrate e uscite con filtri per data
  • Elenco dei bolle di movimento con filtro per stato
  • Creare entrate di magazzino (diritto EDITER_ENTREE richiesto)
  • Creare uscite di magazzino (diritto EDITER_SORTIE richiesto)

Claude vi chiederà sempre conferma prima di creare un'entrata o un'uscita.

👥 Amministrazione (diritti ADMIN)
  • Elenco degli utenti dell'organizzazione
  • Consultazione dei diritti e dei ruoli

Differenza con l'Assistente Web

Assistente Web (chat di base)

  • Gratuito, senza abbonamento
  • Comprensione per parole chiave
  • Pulsanti scorciatoia predefiniti
  • Nessuna analisi incrociata
  • Risposte formattate semplici

Claude.ai (IA completa)

  • Abbonamento Claude richiesto (Pro/Max/Team)
  • Comprensione totale del linguaggio naturale
  • Domande complesse e tracciamento del contesto
  • Analisi, confronto, sintesi dei dati
  • Risposte dettagliate con spiegazioni

Domande frequenti

Costa qualcosa in più?

No. L'integrazione MCP è inclusa nel vostro abbonamento Claude (Pro a 20 $/mese, Max a 100 $/mese, Team a 30 $/mese/utente). Nessun costo aggiuntivo da parte di GSE-Web.

I miei dati vengono inviati ad Anthropic?

I dati transitano tra il server MCP e Claude per formulare le risposte. Anthropic non memorizza i dati degli strumenti MCP e non li usa per addestrare i suoi modelli (politica sulla privacy di Anthropic). La connessione è cifrata HTTPS end-to-end.

Qualcuno può accedere ai miei dati con l'URL del server MCP?

No. L'URL del server MCP consente solo di vedere l'elenco degli strumenti disponibili (nomi generici come "search_products"). Per accedere a qualsiasi dato, bisogna autenticarsi con un vero login e password GSE-Web. È lo stesso livello di sicurezza di una pagina di login.

Posso condividere questa integrazione con il mio team?

Sì. Ogni membro del team aggiunge l'URL nelle proprie impostazioni Claude, poi accede con le proprie credenziali GSE-Web. Ognuno vede solo i dati della propria organizzazione.

Devo riconnettermi a ogni conversazione?

, l'autenticazione GSE-Web è per conversazione. All'inizio di ogni nuova conversazione, dite a Claude di connettervi. L'integrazione MCP stessa resta configurata permanentemente nelle vostre impostazioni.

ChatGPT Custom GPT (zero installazione)

Un Custom GPT in ChatGPT permette a qualunque utente di chattare con i dati GSE-Web direttamente da chat.openai.com. Nessuna installazione richiesta.

Configurazione da parte dell'amministratore

Creare un Custom GPT

In ChatGPT, andate su Explore GPTs → Create.

Aggiungere le istruzioni

Incollate queste istruzioni nel campo "Instructions" del GPT:

Tu es l'assistant GSE-Web, un expert en gestion de stock.
Tu aides les utilisateurs a interroger et gérer leurs données
de stock, produits, mouvements et bons de mouvement.

Regles :
1. Commence TOUJOURS par authentifier l'utilisateur (action authenticate)
2. Utilise le token recu pour toutes les requêtes suivantes
3. Reponds en francais, de manière claire et synthetique
4. Pour les tableaux de données, formate-les de manière lisible
5. Ne montre JAMAIS le token JWT a l'utilisateur
6. Pour les actions d'écriture, confirme AVANT d'executer

Configurare le Azioni

Nella scheda Actions, importate lo schema OpenAPI disponibile su:

https://gse-web.xlexe.com/api/gse_assistant_openapi.json

L'autenticazione avviene tramite l'header Authorization: Bearer gestito automaticamente dal GPT dopo il login.

Pubblicare il GPT

Scegliete "Only people with a link" o "Anyone at [la vostra organizzazione]" per condividere con il vostro team.

Utilizzo da parte dei dipendenti

L'utente apre semplicemente il link del Custom GPT e chatta normalmente:

"Connecte-moi au serveur de production, login jean.dupont, mot de passe ***"
"Quels produits sont en rupture ?"
"Donne-moi le tableau de bord"
"Créeune entrée de 50 gants, emplacement A-03"

Assistente Web (senza IA)

L'Assistente Web è un'interfaccia di consultazione rapida con pulsanti scorciatoia e ricerca per parole chiave. Non richiede alcun abbonamento IA ma non utilizza intelligenza artificiale.

Apri l'Assistente Web →

Accesso diretto all'interfaccia chat (credenziali GSE-Web richieste).

Altri strumenti compatibili

⚙️

n8n — Automazione →

Collegate GSE-Web a n8n per creare flussi automatici: allarmi magazzino, report, sync ERP. Guida completa disponibile.

Cursor / Windsurf

IDE con IA integrata. Supportano il protocollo MCP per gli sviluppatori.

Qualsiasi client MCP

Qualsiasi software compatibile MCP può connettersi al server locale gse-web.

Riferimento degli strumenti

55 strumenti disponibili nel server MCP di GSE-Web.

Autenticazione

StrumentoDescrizioneAccesso
authenticate Connettersi a un server GSE-Web con login/password Aperto
get_current_user Vedere il profilo e i diritti dell'utente connesso JWT
list_servers Informazioni sul server dell'utente connesso JWT

Prodotti & Magazzino (lettura)

StrumentoDescrizioneAccesso
search_products Cercare prodotti per parola chiave (referenza, etichetta, categoria) JWT
get_product_details Dettagli completi di un prodotto con stock per ubicazione JWT
get_stock_levels Livelli di stock con filtri per magazzino / ubicazione JWT
get_emplacements Elenco delle ubicazioni di stoccaggio JWT
get_catégories Categorie di prodotti distinte JWT

Movimenti (lettura)

StrumentoDescrizioneAccesso
list_entrées Entrate di magazzino con filtri per data JWT
list_sorties Uscite di magazzino con filtri per data JWT
list_bon_mouvements Bolle di movimento con filtro per stato JWT
get_bon_mouvement_details Dettagli completi di una bolla di movimento JWT

Operazioni di scrittura

StrumentoDescrizioneAccesso
create_entrée Creare un'entrata di magazzino (prodotto, quantità, ubicazione, magasins_id, no_lot...) EDITER_ENTREE
create_sortie Creare un'uscita di magazzino EDITER_SORTIE
update_bon_mouvement_statut Cambiare lo stato di una bolla di movimento EDITER_STATUTS_BDM

Utenti & Organizzazione

StrumentoDescrizioneAccesso
list_users Elenco degli utenti dell'organizzazione ADMIN
get_user_details Dettagli di un utente con gruppi e diritti ADMIN
get_organisation_info Informazioni sull'organizzazione corrente JWT

Analitica & Monitoraggio

StrumentoDescrizioneAccesso
get_stock_alerts Allarmi: rotture di stock, prodotti in scadenza tra 30 giorni JWT
get_dashboard_stats Statistiche chiave: nr prodotti, quantità stock, nr utenti JWT
get_recent_logs Ultimi log applicativi con filtro per livello SUPERADMIN

Formazione

StrumentoDescrizioneAccesso
list_classes Classi di formazione FORMATION
list_scenarios Scenari pedagogici (esercitazioni) FORMATION
get_student_progress Progressione degli allievi su uno scenario FORMATION

Scenari pedagogici (scrittura)

StrumentoDescrizioneAccesso
create_scenario Crea uno scenario pedagogico completo (fasi, risorse opzionali e collegamenti delle fasi) in una sola chiamata; il totale dei punti viene ricalcolato come somma dei punti delle fasi FORMATION_ENSEIGNANT
add_scenario_ressource Aggiunge una risorsa (Video, PDF, Schema, Quiz, URL o File) a uno scenario esistente, con i suoi collegamenti alle fasi FORMATION_ENSEIGNANT
link_quiz_to_scenario Collega un quiz di libreria esistente a uno scenario (crea una risorsa di tipo Quiz, letta dall'app per visualizzare il quiz) FORMATION_ENSEIGNANT

Bolle di ricezione

StrumentoDescrizioneAccesso
list_bons_reception Bolle di ricezione con % ricezione, filtri per data e fornitore JWT
get_bon_reception_details Dettagli di una bolla di ricezione con stato per riga (ricevuto/parziale/in attesa) JWT

Ordini clienti (OMS)

StrumentoDescrizioneAccesso
list_commandes_clients Ordini clienti dal portale OMS con filtri per stato, data e cliente JWT
get_commande_client_details Dettagli completi di un ordine cliente con righe prodotti JWT
get_oms_reconciliation_report Report di riconciliazione OMS (sola lettura): ordini convalidati senza buono di movimento, buoni senza righe di dettaglio, esplosioni di kit bloccate. JWT

Logistica & Approvvigionamento

StrumentoDescrizioneAccesso
list_commandes_fournisseurs Ordini fornitori con filtri per stato JWT
get_commande_fournisseur_details Dettagli ordine con righe (qtà ordinata/ricevuta/restante) JWT
get_reception_status Stato ricezione: % ricevuto, righe in attesa JWT
list_expeditions Spedizioni con numero di pallet e bolle collegate JWT
get_expedition_details Dettagli spedizione con bolle collegate e pallet JWT
get_bon_reliquats Bolle residui (-R1, -R2) di una bolla parzialmente preparata JWT
get_missing_quantities Quantità mancanti (richieste - uscite) per riga JWT
list_ruptures Prodotti in rottura con stato e fornitore JWT
get_stock_history Storico entrate/uscite di un prodotto su un periodo JWT
list_magasins Magazzini dell'organizzazione JWT

Terzi (Fornitori & Clienti)

StrumentoDescrizioneAccesso
list_tiers Fornitori e clienti con filtri per tipo e ricerca JWT
get_tiers_details Dettagli completi di un terzo (30+ campi) JWT

Operazioni magazzino avanzate

StrumentoDescrizioneAccesso
modify_stock Modificare la quantità di uno stock esistente EDITER_PRODUIT
change_emplacement Cambiare l'ubicazione di uno stock EDITER_PRODUIT

Creazione in massa (Bulk Create)

StrumentoDescrizioneAccesso
bulk_create_tiers Crea in massa fino a 100 terzi (fornitori/clienti) in una sola chiamata EDITER_FOURNISSEUR / EDITER_CLIENT
bulk_create_quiz_library Crea in massa fino a 50 quiz di libreria con le loro domande nidificate FORMATION_ENSEIGNANT
bulk_create_products Crea in massa prodotti (catalogo) in una sola chiamata solo claude.ai EDITER_PRODUIT
bulk_create_entrees Crea in massa entrate di magazzino (ricezioni) con validazione post-inserimento dello stock solo claude.ai EDITER_ENTREE

Lotti e Tracciabilità

StrumentoDescrizioneAccesso
list_lots Elenco paginato dei lotti (prodotto, stato qualità, quantità in uscita, resto da controllare, scadenza) JWT
get_lot_details Dettaglio completo di un lotto: info+stato, prodotto, entrate, uscite, stock, storico dei controlli qualità JWT
get_lot_tracking Dashboard di invecchiamento: età dei lotti, scadenze valorizzate, stato qualità, top 10 rotazione, KPI JWT
get_product_composition Distinta base di un prodotto composto (kit): componenti + quantità per assemblaggio JWT
list_composed_products Elenca i prodotti composti (kit) con la loro distinta base e il numero di assemblaggi disponibili JWT

Riferimento: 3 risorse di contesto

Le risorse forniscono contesto statico all'IA per comprendere meglio l'applicazione GSE-Web.

URIDescrizione
gse://schema/tables Struttura del database GSE-Web (tabelle e relazioni principali)
gse://permissions/list I 32 diritti disponibili con la loro descrizione
gse://docs/api Riepilogo degli endpoint dell'API REST (prodotti, stock, movimenti...)

Sicurezza

Il server MCP applica gli stessi meccanismi di sicurezza dell'applicazione GSE-Web.

🔑 Autenticazione JWT

Ogni sessione inizia con una chiamata authenticate. Il JWT generato scade al termine della sessione.

👥 Isolamento organizzazione

Impossibile accedere ai dati di un altro cliente. Ogni query SQL e filtrata per organisations_id.

🛡️ 30 diritti granulari

Gli strumenti di scrittura verificano i diritti dell'utente connesso. Senza il diritto EDITER_PRODUIT, la creazione di un'entrata e impossibile.

🚫 Filtro SQL doppio/triplo

Server condivisi: id + org. Server dedicati: id + org + nome server.

⏱️ Rate limiting

60 letture/minuto, 10 scritture/minuto per sessione. Protegge dagli abusi.

👁️ Log tracciabili

Ogni chiamata a uno strumento viene registrata con timestamp, utente, strumento e parametri. Audit trail completo.

Importante: il server MCP gira localmente sulla vostra macchina. Le vostre credenziali non transitano mai per un servizio terzo. La comunicazione con GSE-Web avviene in HTTPS direttamente verso i server sicuri.

Casi d'uso per ruolo

💼 Gestore di magazzino
  • "Quali prodotti hanno uno stock inferiore alla soglia di allarme?"
  • "Mostrami gli ultimi 10 movimenti sul magazzino Nord"
  • "Crea un'entrata di 200 guanti isolanti, lotto 2026-A, ubicazione B-12"
  • "Quanti prodotti diversi abbiamo in stock totale?"
  • "Ci sono prodotti in scadenza imminente?"
💻 Amministratore
  • "Quanti utenti sono registrati nella nostra organizzazione?"
  • "Quali diritti ha l'utente n°23?"
  • "Mostrami i log d'errore delle ultime 24h"
  • "Dammi le statistiche globali della dashboard"
  • "Su quale server sono connesso?"
📚 Formatore / Insegnante
  • "Elenca le mie classi di formazione"
  • "Quali scenari di esercitazione sono disponibili?"
  • "Mostra la progressione dei miei allievi sullo scenario 'Inventario completo'"
  • "Qual è la nota media della classe sull'ultima esercitazione?"
🛠️ Tecnico / Operatore sul campo
  • "Cerca il prodotto con il codice a barre 3700547800126"
  • "Qual è lo stock di questo prodotto nell'ubicazione C-01?"
  • "Registra un'uscita di 5 unità per il cantiere Lione"
  • "Quali bolle di movimento sono 'da trattare'?"
📊 Sviluppatore / Integratore
  • "Mostrami la struttura del database"
  • "Quali endpoint API sono disponibili?" (risorsa gse://docs/api)
  • "Qual è il formato di risposta dell'API prodotti?"
  • "Quanti diritti diversi esistono nel sistema?" (risorsa gse://permissions/list)
  • Integrate il server MCP nei vostri strumenti compatibili

FAQ

Le mie credenziali sono memorizzate da qualche parte?

No. Il server MCP non persiste nulla su disco. Il JWT ottenuto dopo l'autenticazione viene mantenuto in memoria solo durante la sessione. Quando chiudete Claude Code, tutto viene cancellato.

Posso accedere ai dati di un'altra organizzazione?

No. Tutte le richieste includono un filtro organisations_id derivato dal vostro JWT. Filtri aggiuntivi impediscono qualsiasi accesso al di fuori della vostra organizzazione.

L'IA può modificare i miei dati senza il mio consenso?

Claude Code chiede sempre la vostra approvazione prima di eseguire uno strumento di scrittura. Vedrete lo strumento e i suoi parametri, e potete rifiutare. Inoltre, un rate limiter limita le scritture a 10/minuto.

Il server MCP funziona offline?

No. Il server MCP necessita di una connessione internet per raggiungere le API di GSE-Web.

Posso usare il server MCP in produzione?

Sì. Modificate le variabili d'ambiente in .mcp.json:

"GSE_PROXY_BASE_URL": "https://gse-web.xlexe.com"
"GSE_DEFAULT_SERVER": "https://www.gse-web.online/"
Quanto costa l'utilizzo del server MCP?

Il server MCP stesso è gratuito (open source, incluso nel progetto). Il costo è a livello dell'IA: serve un abbonamento Claude (Pro, Team o Enterprise) per usare Claude Code o Claude Desktop.

Come aggiornare il server MCP?

Dopo un git pull del progetto, basta ricompilare:

cd mcp-server && npm install && npm run build

Poi riavviate Claude Code.