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.

44 herramientas 3 recursos 30 permisos

?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.

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
En resumen: escribe "?Que productos estan sin stock?" y la IA consulta directamente su base de datos GSE-Web para responder con datos reales.

?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.

Votre machine (local) ↓ Claude + MCP Server Serveur d'hébergément (proxies HTTPS) Bases de données GSE-Web
Aucun port a ouvrir : le serveur MCP communique avec Claude via stdio (entrée/sortie standard) et avec GSE-Web via HTTPS. Pas de serveur web local a exposer.

Requisitos previos

ÉlémentRequisNote
Node.jsv18 ou supérieurnodejs.org
npmInclus avec Node.js-
Claude CodeCLI Anthropicnpm install -g @anthropic-ai/claude-code
Compte GSE-WebIdentifiants validesMeme login que l'application mobile/web
Connexion internetOuiPour 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/"
      }
    }
  }
}
Adaptez le champ 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:

🔍 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 operations (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) — 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
Astuce : Claude Code garde le contexte de conversation. Authentifiez-vous une seule fois en debut de session, puis posez autant de questions que vous voulez.

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)

La méthode la plus simple et la plus puissante. Connectez Claude directement a vos données GSE-Web depuis claude.ai, sans rien installer.

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:

EnvironnementURL a copier
Développement / Demohttps://gse-web-dev.xlexe.com/api/mcp_remote.php
Productionhttps://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

🔍 Recherche et consultation
  • 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
📈 Analyses et alertes
  • 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
🚚 Mouvements de stock
  • 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.

👥 Administration (droits ADMIN)
  • 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

¿Cuesta algo extra?

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.

¿Se envían mis datos a Anthropic?

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.

¿Puede alguien acceder a mis datos con la URL del servidor MCP?

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.

¿Puedo compartir esta integración con mi equipo?

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.

¿Tengo que reconectarme en cada conversación?

, 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

OutilDescriptionAccè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)

OutilDescriptionAccè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)

OutilDescriptionAccè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

OutilDescriptionAccè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

OutilDescriptionAccè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

OutilDescriptionAccè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

OutilDescriptionAccè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

OutilDescriptionAccè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)

OutilDescriptionAccè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

OutilDescriptionAccè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)

OutilDescriptionAccè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

OutilDescriptionAccè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.

URIDescription
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.

Important : le serveur MCP tourne localement sur votre machine. Vos identifiants ne transitent jamais par un service tiers. La communication avec GSE-Web se fait en HTTPS directement vers les serveurs sécurisés.

Cas d'usage par role

💼 Gestionnaire de stock
  • "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 ?"
💻 Administrateur
  • "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é ?"
📚 Formateur / Enseignant
  • "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 ?"
🛠️ Technicien / Operateur terrain
  • "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' ?"
📊 Développeur / Integrateur
  • "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

¿Se almacenan mis credenciales en algún sitio?

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.

¿Puedo acceder a los datos de otra organización?

No. Todas las solicitudes incluyen un filtro organisations_id derivado de su JWT. Filtros adicionales impiden cualquier acceso fuera de su organización.

¿Puede la IA modificar mis datos sin mi consentimiento?

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.

¿Funciona el servidor MCP sin conexión?

No. El servidor MCP necesita conexión a internet para acceder a las APIs de GSE-Web.

¿Puedo usar el servidor MCP en producción?

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/"
¿Cuánto cuesta usar el servidor MCP?

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.

¿Cómo actualizar el servidor MCP?

Tras un git pull del proyecto, basta con recompilar:

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

Luego reinicie Claude Code.