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 55 strumenti che l'AI puo chiamare.
stdio (input/output standard) e con GSE-Web via HTTPS. Nessun server web locale da esporre. Prerequisiti
| Elemento | Richiesto | Nota |
|---|---|---|
Node.js | v18 o superiore | nodejs.org |
npm | Incluso con Node.js | - |
Claude Code | CLI Anthropic | npm install -g @anthropic-ai/claude-code |
| Account GSE-Web | Credenziali valide | Stesso login dell'applicazione mobile/web |
| Connessione internet | Sì | Per 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/"
}
}
}
}
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:
"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 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:
| Ambiente | URL da copiare |
|---|---|
| Sviluppo / Demo | https://gse-web-dev.xlexe.com/api/mcp_remote.php |
| Produzione | 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.
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
- 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
- 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
- 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.
- 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
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 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
| Strumento | Descrizione | Accesso |
|---|---|---|
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)
| Strumento | Descrizione | Accesso |
|---|---|---|
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)
| Strumento | Descrizione | Accesso |
|---|---|---|
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
| Strumento | Descrizione | Accesso |
|---|---|---|
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
| Strumento | Descrizione | Accesso |
|---|---|---|
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
| Strumento | Descrizione | Accesso |
|---|---|---|
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
| Strumento | Descrizione | Accesso |
|---|---|---|
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)
| Strumento | Descrizione | Accesso |
|---|---|---|
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
| Strumento | Descrizione | Accesso |
|---|---|---|
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)
| Strumento | Descrizione | Accesso |
|---|---|---|
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
| Strumento | Descrizione | Accesso |
|---|---|---|
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)
| Strumento | Descrizione | Accesso |
|---|---|---|
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
| Strumento | Descrizione | Accesso |
|---|---|---|
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)
| Strumento | Descrizione | Accesso |
|---|---|---|
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à
| Strumento | Descrizione | Accesso |
|---|---|---|
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.
| URI | Descrizione |
|---|---|
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.
Casi d'uso per ruolo
- "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?"
- "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?"
- "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?"
- "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'?"
- "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
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.