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.
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.
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 44 strumenti che l'AI puo chiamare.
stdio (entrée/sortie standard) et avec GSE-Web via HTTPS. Pas de serveur web local a exposer.
Prerequisiti
| Élément | Requis | Note |
|---|---|---|
Node.js | v18 ou supérieur | nodejs.org |
npm | Inclus avec Node.js | - |
Claude Code | CLI Anthropic | npm install -g @anthropic-ai/claude-code |
| Compte GSE-Web | Identifiants valides | Meme login que l'application mobile/web |
| Connexion internet | Oui | Pour atteindre les APIs 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/"
}
}
}
}
cwd au chemin reel du dossier mcp-server sur votre machine.
Pour la production, remplacez les URLs par https://gse-web.xlexe.com et 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:
"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.
"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.
"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é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.).
"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.
"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
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)
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 44 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:
| Environnement | URL a copier |
|---|---|
| Développement / Demo | https://gse-web-dev.xlexe.com/api/mcp_remote.php |
| Production | https://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.
Posez vos questions !
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"
Ce que Claude peut faire avec vos données
- Rechercher des produits par référence, nom, catégorie ou code-barre
- Voir le detail d'un produit avec son stock par emplacement
- Lister le stock filtre par emplacement
- Consulter les catégories et emplacements disponibles
- Tableau de bord : nombre de produits, quantite totale, utilisateurs
- Alertes rupture de stock (produits a quantite 0)
- Alertes péremption (produits expirant dans 30 jours)
- Claude peut croiser et analyser les résultats de plusieurs outils pour repondre a des questions complexes
- Historique des entrées et sorties avec filtres par date
- Liste des bons de mouvement avec filtre par statut
- Créer des entrées de stock (droit EDITER_ENTREE requis)
- Créer des sorties de stock (droit EDITER_SORTIE requis)
Claude vous demandera toujours confirmation avant de créer une entrée ou une sortie.
- Liste des utilisateurs de l'organisation
- Consultation des droits et roles
Différence avec l'Assistant Web
Assistant Web (chat basique)
- Gratuit, sans abonnement
- Compréhension par mots-clés
- Boutons raccourcis pre-definis
- Pas d'analyse croisee
- Réponses formatees simples
Claude.ai (IA complete)
- Abonnement Claude requis (Pro/Max/Team)
- Compréhension langage naturel totale
- Questions complexes et suivi de contexte
- Analyse, comparaison, synthese des données
- Réponses détaillées avec explications
Domande frequenti
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 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.
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.
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.
Sì, 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 installation)
Un Custom GPT dans ChatGPT permet a n'importe quel utilisateur de discuter avec les données GSE-Web directement depuis chat.openai.com. Aucune installation requise.
Configuration par l'administrateur
Créer un Custom GPT
Dans ChatGPT, allez dans Explore GPTs → Create.
Ajouter les instructions
Collez ces instructions dans le champ "Instructions" du 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
Configurer les Actions
Dans l'onglet Actions, importez le schema OpenAPI disponible a :
https://gse-web.xlexe.com/api/gse_assistant_openapi.json
L'authentification se fait via le header Authorization: Bearer gere automatiquement par le GPT apres login.
Publier le GPT
Choisissez "Only people with a link" ou "Anyone at [votre organisation]" pour partager avec votre equipe.
Utilisation par les employes
L'utilisateur ouvre simplement le lien du Custom GPT et discute normalement :
"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"
Assistant Web (sans IA)
L'Assistant Web est une interface de consultation rapide avec boutons raccourcis et recherche par mots-clés. Il ne nécessite aucun abonnement IA mais n'utilise pas d'intelligence artificielle.
Ouvrir l'Assistant Web →
Accès direct a l'interface de chat (identifiants GSE-Web requis).
Autres outils compatibles
n8n — Automatisation →
Connectez GSE-Web à n8n pour créer des workflows automatiques : alertes stock, rapports, sync ERP. Guide complet disponible.
Cursor / Windsurf
IDE avec IA intégrée. Supportent le protocole MCP pour les développeurs.
Tout client MCP
Tout logiciel compatible MCP peut se connectér au serveur local gse-web.
Riferimento degli strumenti
44 strumenti disponibili nel server MCP di GSE-Web.
Authentification
| Outil | Description | Accès |
|---|---|---|
authenticate |
Se connectér a un serveur GSE-Web avec login/mot de passe | Ouvert |
get_current_user |
Voir le profil et les droits de l'utilisateur connecté | JWT |
list_servers |
Informations sur le serveur de l'utilisateur connecté | JWT |
Produits & Stock (lecture)
| Outil | Description | Accès |
|---|---|---|
search_products |
Rechercher des produits par mot-cle (référence, libellé, catégorie) | JWT |
get_product_details |
Détails complets d'un produit avec stock par emplacement | JWT |
get_stock_levels |
Niveaux de stock avec filtres par magasin / emplacement | JWT |
get_emplacements |
Liste des emplacements de stockage | JWT |
get_catégories |
Catégories de produits distinctes | JWT |
Mouvements (lecture)
| Outil | Description | Accès |
|---|---|---|
list_entrées |
Entrées de stock avec filtres par date | JWT |
list_sorties |
Sorties de stock avec filtres par date | JWT |
list_bon_mouvements |
Bons de mouvement avec filtre par statut | JWT |
get_bon_mouvement_details |
Détails complets d'un bon de mouvement | JWT |
Operations d'écriture
| Outil | Description | Accès |
|---|---|---|
create_entrée |
Créer une entrée de stock (produit, quantité, emplacement, magasins_id, no_lot...) | EDITER_ENTREE |
create_sortie |
Créer une sortie de stock | EDITER_SORTIE |
update_bon_mouvement_statut |
Changer le statut d'un bon de mouvement | EDITER_STATUTS_BDM |
Utilisateurs & Organisation
| Outil | Description | Accès |
|---|---|---|
list_users |
Liste des utilisateurs de l'organisation | ADMIN |
get_user_details |
Détails d'un utilisateur avec groupes et droits | ADMIN |
get_organisation_info |
Informations sur l'organisation courante | JWT |
Analytique & Monitoring
| Outil | Description | Accès |
|---|---|---|
get_stock_alerts |
Alertes : ruptures de stock, produits périmés dans 30 jours | JWT |
get_dashboard_stats |
Statistiques clés : nb produits, quantite stock, nb utilisateurs | JWT |
get_recent_logs |
Derniers logs applicatifs avec filtre par niveau | SUPERADMIN |
Formation
| Outil | Description | Accès |
|---|---|---|
list_classes |
Classes de formation | FORMATION |
list_scenarios |
Scenarios pedagogiques (TP) | FORMATION |
get_student_progress |
Progression des eleves sur un scenario | FORMATION |
Bons de réception
| Outil | Description | Accès |
|---|---|---|
list_bons_reception |
Bons de réception avec % réception, filtres par date et fournisseur | JWT |
get_bon_reception_details |
Détails d'un bon de réception avec statut par ligne (reçu/partiel/en attente) | JWT |
Commandes clients (OMS)
| Outil | Description | Accès |
|---|---|---|
list_commandes_clients |
Commandes clients du portail OMS avec filtres par statut, date et client | JWT |
get_commande_client_details |
Détails complets d'une commande client avec lignes produits | JWT |
Logistique & Approvisionnement
| Outil | Description | Accès |
|---|---|---|
list_commandes_fournisseurs |
Commandes fournisseurs avec filtres par statut | JWT |
get_commande_fournisseur_details |
Détails commande avec lignes (qté commandée/reçue/restante) | JWT |
get_reception_status |
Statut réception : % réceptionné, lignes en attente | JWT |
list_expeditions |
Expéditions avec nombre de palettes et bons liés | JWT |
get_expedition_details |
Détails expédition avec bons liés et palettes | JWT |
get_bon_reliquats |
Bons reliquats (-R1, -R2) d'un bon partiellement préparé | JWT |
get_missing_quantities |
Quantités manquantes (demandées - sorties) par ligne | JWT |
list_ruptures |
Produits en rupture avec statut et fournisseur | JWT |
get_stock_history |
Historique entrées/sorties d'un produit sur une période | JWT |
list_magasins |
Magasins (entrepôts) de l'organisation | JWT |
Tiers (Fournisseurs & Clients)
| Outil | Description | Accès |
|---|---|---|
list_tiers |
Fournisseurs et clients avec filtres par type et recherche | JWT |
get_tiers_details |
Détails complets d'un tiers (30+ champs) | JWT |
Opérations stock avancées
| Outil | Description | Accès |
|---|---|---|
modify_stock |
Modifier la quantité d'un stock existant | EDITER_PRODUIT |
change_emplacement |
Changer l'emplacement d'un stock | EDITER_PRODUIT |
Référence : 3 ressources de contexte
Les ressources fournissent du contexte statique a l'IA pour mieux comprendre l'application GSE-Web.
| URI | Description |
|---|---|
gse://schema/tables |
Structure de la base de données GSE-Web (tables et relations principales) |
gse://permissions/list |
Les 32 droits disponibles avec leur description |
gse://docs/api |
Résumé des endpoints de l'API REST (produits, stocks, mouvements...) |
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.
Cas d'usage par role
- "Quels produits ont un stock inferieur au seuil d'alerte ?"
- "Montre-moi les 10 derniers mouvements sur le magasin Nord"
- "Créeune entrée de 200 gants isolants, lot 2026-A, emplacement B-12"
- "Combien de produits différents avons-nous en stock total ?"
- "Y a-t-il des produits qui périmént bientot ?"
- "Combien d'utilisateurs sont enregistres dans notre organisation ?"
- "Quels droits a l'utilisateur n°23 ?"
- "Montre-moi les logs d'erreur des dernières 24h"
- "Donne-moi les statistiques globales du dashboard"
- "Sur quel serveur suis-je connecté ?"
- "Liste mes classes de formation"
- "Quels scenarios de TP sont disponibles ?"
- "Montre la progression de mes eleves sur le scenario 'Inventaire complet'"
- "Quel est le score moyen de la classe sur le dernier TP ?"
- "Cherche le produit avec le code-barre 3700547800126"
- "Quel est le stock de ce produit dans l'emplacement C-01 ?"
- "Enregistre une sortie de 5 unites pour le chantier Lyon"
- "Quels bons de mouvement sont 'a traiter' ?"
- "Montre-moi la structure de la base de données"
- "Quels endpoints API sont disponibles ?" (resource
gse://docs/api) - "Quel est le format de réponse de l'API produits ?"
- "Combien de droits différents existent dans le système ?" (resource
gse://permissions/list) - Integrez le serveur MCP dans vos propres outils compatibles
FAQ
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.
No. Tutte le richieste includono un filtro organisations_id derivato dal vostro JWT. Filtri aggiuntivi impediscono qualsiasi accesso al di fuori della vostra organizzazione.
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.
No. Il server MCP necessita di una connessione internet per raggiungere le API di GSE-Web.
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/"
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.
Dopo un git pull del progetto, basta ricompilare:
cd mcp-server && npm install && npm run build
Poi riavviate Claude Code.