Hable con sus datos GSE-Web en lenguaje natural
El servidor MCP de GSE-Web conecta los asistentes de IA (Claude, ChatGPT, etc.) directamente a su aplicacion de gestion de stock. Haga preguntas, lance acciones, obtenga informes — sin escribir una sola linea de codigo.
?Que es MCP?
MCP (Model Context Protocol) es un estandar abierto creado por Anthropic que permite a una IA conectarse a fuentes de datos externas de forma segura y estructurada.
Pienselo como un traductor universal: la IA habla en lenguaje natural, el servidor MCP traduce en solicitudes tecnicas (API, SQL) y devuelve los resultados en un formato que la IA comprende.
?Por que usar el servidor MCP?
Preguntas en lenguaje natural
Ya no necesita navegar por menus ni saber escribir SQL. Haga sus preguntas como se las haria a un companero.
Respuestas instantaneas
La IA analiza los datos y sintetiza los resultados. Un panel completo en una frase.
Seguridad preservada
Mismas reglas que la aplicacion: autenticacion JWT, permisos por rol (30 derechos), aislamiento por organizacion.
Acciones automatizadas
Cree entradas/salidas de stock, cambie estados de albaranes — directamente desde la conversacion.
Analisis inteligentes
Alertas de rotura, productos caducados, estadisticas — la IA cruza los datos y le avisa proactivamente.
Modulo de formacion
Los docentes pueden seguir las clases, escenarios y el progreso de los alumnos con una simple pregunta.
Sin MCP / Con MCP
Sin MCP
- Abrir la aplicacion GSE-Web
- Navegar por los menus
- Aplicar filtros manualmente
- Exportar a CSV, abrir Excel
- Cruzar datos a mano
- Escribir un informe
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
?Como funciona?
El servidor MCP es un proceso Node.js que se ejecuta localmente en su maquina (o de forma remota via HTTPS). Se autentica con GSE-Web usando sus credenciales y luego expone 44 herramientas que la IA puede llamar.
stdio (entrée/sortie standard) et avec GSE-Web via HTTPS. Pas de serveur web local a exposer.
Requisitos previos
| É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 |
Instalacion paso a paso
Paso 1 — Compilar el servidor TypeScript
Abra un terminal en la carpeta del proyecto GSE-Web y ejecute:
cd mcp-server npm install npm run build
El resultado compilado esta en mcp-server/dist/.
Paso 2 — Verificar la configuracion
En la raiz del proyecto, ya hay un archivo .mcp.json configurado:
{
"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/.
Paso 3 — Lanzar Claude Code
Desde la raiz del proyecto:
claude
Claude Code detecta automaticamente .mcp.json y propone activar el servidor gse-web. Acepte.
Paso 4 — Autenticarse
En la conversacion de Claude, escriba simplemente:
Connecte-moi au serveur de développement GSE-Web avec l'identifiant "mon_login" et le mot de passe "mon_password"
Claude llama a la herramienta authenticate y confirma su conexion con la lista de sus derechos.
Primer uso: ejemplos concretos
Una vez autenticado, haga sus preguntas en lenguaje natural. Aqui hay algunos ejemplos:
"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) — Interfaz principal
Claude Code es la interfaz recomendada para usar el servidor MCP. Detecta automaticamente la configuracion .mcp.json y ofrece activar el servidor.
Instalacion
npm install -g @anthropic-ai/claude-code
Uso
# 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
Compatible con Claude Desktop (Windows/Mac). Configurelo anadiendo la seccion mcpServers al archivo de configuracion.
Configuracion
Edite el archivo de configuracion de Claude Desktop:
# macOS ~/Library/Application Support/Claude/claude_desktop_config.json # Windows %APPDATA%\Claude\claude_desktop_config.json
Anada la seccion 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/"
}
}
}
}
Reinicie Claude Desktop. El servidor aparece en la lista de herramientas disponibles.
Claude.ai — Integracion directa (recomendado)
Para usuarios de Claude Pro, Max o Team: conecte directamente su servidor MCP via la interfaz claude.ai. No se requiere instalacion local.
Lenguaje natural
Claude (Opus, Sonnet, Haiku) comprende el lenguaje natural. Sin palabras clave que recordar, haga sus preguntas como se las diria a un companero.
Incluido en su suscripcion
Sin coste adicional. La integracion MCP usa su suscripcion Claude existente (Pro, Max o Team).
100% en el navegador
Todo funciona en el navegador. Nada que descargar, nada que configurar en su maquina.
Seguridad de grado Claude
Autenticacion por sus credenciales GSE-Web. Aislamiento estricto por organizacion. Ningun dato es almacenado por el servidor MCP.
Lectura + escritura
Consulte sus stocks y tambien cree entradas/salidas — con verificacion de derechos en cada accion.
Analisis avanzados
Claude puede cruzar datos, comparar periodos, generar informes — tiene acceso a 44 herramientas especializadas.
Configuracion (una sola vez, 2 minutos)
Abrir Configuracion
Vaya a claude.ai y haga clic en el icono de engranaje en la parte inferior izquierda para abrir Configuracion.
Anadir una integracion
En la seccion Integraciones, haga clic en "Anadir integracion". Introduzca la URL del servidor 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 |
La integracion aparece en su lista con el nombre "gse-web".
Autenticarse
En una nueva conversacion de Claude, diga simplemente:
Connecte-moi au serveur GSE-Web demo avec l'identifiant "mon_login" et le mot de passe "mon_password"
Claude llama a la herramienta authenticate y confirma su conexion con la lista de sus derechos.
Posez vos questions !
Esta conectado. Pregunte lo que quiera:
"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
Preguntas frecuentes
No. La integración MCP está incluida en su suscripción Claude (Pro a 20 $/mes, Max a 100 $/mes, Team a 30 $/mes/usuario). Sin gastos adicionales por parte de GSE-Web.
Los datos transitan entre el servidor MCP y Claude para formular las respuestas. Anthropic no almacena los datos de las herramientas MCP y no los utiliza para entrenar sus modelos (política de privacidad de Anthropic). La conexión está cifrada en HTTPS de extremo a extremo.
No. La URL del servidor MCP solo permite ver la lista de herramientas disponibles (nombres genéricos como "search_products"). Para acceder a cualquier dato, hay que autenticarse con un login y contraseña reales de GSE-Web. Es el mismo nivel de seguridad que una página de inicio de sesión.
Sí. Cada miembro del equipo añade la URL en sus propios ajustes de Claude, luego se conecta con sus propias credenciales GSE-Web. Cada uno solo ve los datos de su organización.
Sí, la autenticación GSE-Web es por conversación. Al inicio de cada nueva conversación, dígale a Claude que le conecte. La integración MCP en sí permanece configurada permanentemente en sus ajustes.
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.
Referencia de herramientas
44 herramientas disponibles en el servidor MCP de 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...) |
Seguridad
El servidor MCP aplica los mismos mecanismos de seguridad que la aplicacion GSE-Web.
🔑 Autenticacion JWT
Cada sesion comienza con una llamada authenticate. El JWT generado caduca al final de la sesion.
👥 Aislamiento de organizacion
Imposible acceder a los datos de otro cliente. Cada consulta SQL se filtra por organisations_id.
🛡️ 30 derechos granulares
Las herramientas de escritura verifican los derechos del usuario conectado. Sin el derecho EDITER_PRODUIT, es imposible crear una entrada.
🚫 Filtro SQL doble/triple
Servidores compartidos: id + org. Servidores dedicados: id + org + nombre del servidor.
⏱️ Rate limiting
60 lecturas/minuto, 10 escrituras/minuto por sesion. Protege contra abusos.
👁️ Logs trazables
Cada llamada a una herramienta se registra con marca de tiempo, usuario, herramienta y parametros. Pista de auditoria completa.
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. El servidor MCP no persiste nada en disco. El JWT obtenido tras la autenticación se mantiene en memoria únicamente durante la sesión. Cuando cierra Claude Code, todo se borra.
No. Todas las solicitudes incluyen un filtro organisations_id derivado de su JWT. Filtros adicionales impiden cualquier acceso fuera de su organización.
Claude Code siempre pide su aprobación antes de ejecutar una herramienta de escritura. Verá la herramienta y sus parámetros, y puede rechazar. Además, un limitador de velocidad limita las escrituras a 10/minuto.
No. El servidor MCP necesita conexión a internet para acceder a las APIs de GSE-Web.
Sí. Modifique las variables de entorno en .mcp.json:
"GSE_PROXY_BASE_URL": "https://gse-web.xlexe.com" "GSE_DEFAULT_SERVER": "https://www.gse-web.online/"
El servidor MCP en sí es gratuito (código abierto, incluido en el proyecto). El coste está en el lado de la IA: necesita una suscripción a Claude (Pro, Team o Enterprise) para usar Claude Code o Claude Desktop.
Tras un git pull del proyecto, basta con recompilar:
cd mcp-server && npm install && npm run build
Luego reinicie Claude Code.