Parlez à vos données GSE-Web en langage naturel

Introduction

Votre GSE-Web, accessible à votre assistant IA

MCP (Model Context Protocol) est un standard ouvert créé par Anthropic qui permet à une IA de se connecter à des sources de données externes de façon sécurisée et structurée. Pensez-y comme à une prise universelle : n'importe quel assistant compatible peut s'y brancher, et GSE-Web décide précisément ce qu'il a le droit de voir et de faire.

Concrètement, vous écrivez « Quels produits sont en rupture dans le magasin principal ? » et l'assistant interroge directement votre GSE-Web — avec vos accès, dans votre organisation, rien d'autre.

Ce qui change avec la nouvelle génération

Comment ça fonctionne ?

1. Vous posez une question à votre assistant

   « Où en est la réception de la commande fournisseur CF-2026-0142 ? »

2. L'assistant choisit le bon outil GSE-Web

   Ici purchasing_get_reception_status — chaque outil décrit précisément ce qu'il fait, l'assistant ne devine pas.

3. GSE-Web répond avec vos données

   L'assistant reformule : « 60 % reçus, une ligne partielle, aucun écart signalé au fournisseur. »

Mise en route

Trois choses suffisent

L'adresse du serveur

https://app.gse-web.online/mcp

C'est tout. Pas de port, pas de fichier à télécharger. Le transport est « Streamable HTTP », le standard actuel du protocole MCP.

Obtenir son jeton d'accès

Le jeton identifie votre compte : ne le partagez pas, il donne exactement vos accès. Deux façons de l'obtenir :

Option A — demander à votre administrateur, qui peut vous le fournir avec vos identifiants.

Option B — le récupérer vous-même avec votre e-mail et votre mot de passe GSE-Web :

curl -s -X POST https://app.gse-web.online/api/auth/sign-in/email \
  -H "Content-Type: application/json" \
  -d '{"email":"vous@entreprise.fr","password":"votre-mot-de-passe"}'

La réponse contient un champ token : c'est votre jeton. Il se transmet ensuite à chaque appel dans l'en-tête Authorization: Bearer <jeton> — les clients ci-dessous le font pour vous une fois configurés.

Connecter son assistant

Choisissez votre client

Claude Code (terminal) — le plus direct

claude mcp add --transport http gse-web https://app.gse-web.online/mcp \
  --header "Authorization: Bearer VOTRE_JETON"

Ouvrez ensuite une conversation : les outils GSE-Web apparaissent automatiquement. Idéal pour les utilisateurs à l'aise avec le terminal et pour l'automatisation.

Claude Desktop

Claude Desktop se connecte aux serveurs MCP distants via le petit pont mcp-remote (Node.js requis sur le poste, c'est la seule exception au « rien à installer »). Dans le fichier de configuration (Paramètres → Développeur → Modifier la configuration) :

{
  "mcpServers": {
    "gse-web": {
      "command": "npx",
      "args": [
        "mcp-remote", "https://app.gse-web.online/mcp",
        "--header", "Authorization: Bearer VOTRE_JETON"
      ]
    }
  }
}

Redémarrez Claude Desktop : l'icône des connecteurs liste « gse-web ».

claude.ai (navigateur)

Selon votre abonnement Claude, les connecteurs personnalisés (Paramètres → Connecteurs → Ajouter un connecteur personnalisé) acceptent l'URL du serveur. Si votre interface ne propose pas de champ d'authentification par en-tête, passez par Claude Desktop ou Claude Code, qui le gèrent nativement.

Autres clients (Cursor, Windsurf, n8n…)

Tout client qui parle « MCP Streamable HTTP » fonctionne : renseignez l'URL et l'en-tête Authorization: Bearer <jeton>. Pour vérifier la connexion sans assistant, l'inspecteur officiel fait l'affaire :

npx @modelcontextprotocol/inspector
# Transport : Streamable HTTP · URL : https://app.gse-web.online/mcp
# Header : Authorization: Bearer VOTRE_JETON

Référence

Les 63 outils, domaine par domaine

Chaque outil porte un nom explicite — domaine_action_objet — et une description que l'assistant lit avant de choisir. lecture consulte, ✏️ écriture modifie (permission dédiée exigée, voir Sécurité).

Catalogue produits

Stock et traçabilité

Bons de mouvement et expéditions

Achats et fournisseurs

Clients, partenaires et commandes clients

Qualité et chantiers

Formation

Mon compte, mon organisation, divers

Au quotidien

Des exemples à copier tels quels

📦 Gestionnaire de stock

• « Quels produits sont en rupture ou sous leur seuil, et chez quel fournisseur les commander ? »
• « Montre-moi l'historique des mouvements de la référence VIS-M8 sur les 30 derniers jours. »
• « Enregistre une entrée de 200 unités de VIS-M8 dans le magasin principal, coût unitaire 0,12 €. »
• « Quels lots arrivent à péremption ce mois-ci ? »
• « Déplace la ligne de stock du lot L-0042 vers l'emplacement A-12. »

🛒 Acheteur / approvisionnements

• « Où en est la réception de la commande CF-2026-0142 ? »
• « Quel est le tarif contractuel de ce produit chez ce fournisseur pour 500 pièces ? »
• « Liste les écarts tarifaires à traiter entre réceptions et contrats. »
• « Combien nous reste-t-il à faire pour atteindre le prochain palier de remise de fin d'année ? »

🎓 Enseignant (module formation)

• « Crée un scénario de TP “Réception fournisseur” en 5 étapes pour des débutants. »
• « Génère un quiz de 10 questions sur les règles de stockage et rattache-le à ce scénario. »
• « Quelle est la progression de la classe de terminale sur les scénarios publiés ? »

📊 Dirigeant / administrateur

• « Quel est notre taux de service sur les commandes clients des 30 derniers jours ? »
• « Liste les utilisateurs de l'organisation et leurs rôles. »
• « Résume l'activité : ruptures en cours, réceptions attendues, bons à préparer. »

Sécurité

Ce qui protège vos données

Enfin, les mêmes règles métier que l'application s'appliquent partout : un stock ne devient jamais négatif, un lot en quarantaine ne sort pas, une création en masse est « tout ou rien » — jamais un lot à moitié écrit.

Migration

Vous utilisiez l'ancienne version ?

Le périmètre complet de l'ancien serveur est couvert. Trois choses à savoir :

• Plus de serveur local. Vous pouvez désinstaller l'ancien serveur Node.js : la connexion se fait désormais directement à l'URL GSE-Web (voir Mise en route).
• Cinq outils renommés pour la cohérence : catalog_price_book → catalog_get_price_book, projects_list → projects_list_projects, projects_get → projects_get_project, tickets_list → tickets_list_tickets, tickets_get → tickets_get_ticket. Si vous aviez des instructions ou prompts enregistrés citant les anciens noms, mettez-les à jour.
• Quelques outils consolidés. Par exemple, l'historique produit, les entrées et les sorties sont réunis dans inventory_list_movements — plus simple pour l'assistant, même information pour vous.

FAQ

Les questions qui reviennent