Sprechen Sie mit Ihren GSE-Web-Daten in naturlicher Sprache

Der GSE-Web MCP-Server verbindet KI-Assistenten (Claude, ChatGPT usw.) direkt mit Ihrer Lagerverwaltungs-App. Stellen Sie Fragen, starten Sie Aktionen, erhalten Sie Berichte — ohne eine einzige Codezeile zu schreiben.

55 Werkzeuge 3 Ressourcen 30 Berechtigungen

Was ist MCP?

MCP (Model Context Protocol) ist ein von Anthropic erstellter offener Standard, der es einer KI ermoglicht, sich sicher und strukturiert mit externen Datenquellen zu verbinden.

Stellen Sie es sich als einen universellen Ubersetzer vor: Die KI spricht in naturlicher Sprache, der MCP-Server ubersetzt in technische Anfragen (API, SQL) und gibt die Ergebnisse in einem Format zuruck, das die KI versteht.

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
Kurz gesagt: Sie tippen "Welche Produkte sind ausverkauft?" und die KI fragt direkt Ihre GSE-Web-Datenbank ab, um mit echten Daten zu antworten.

Warum den MCP-Server verwenden?

💬

Fragen in naturlicher Sprache

Kein Navigieren durch Menus oder SQL-Kenntnisse mehr notig. Stellen Sie Fragen wie im Gesprach mit einem Kollegen.

Sofortige Antworten

Die KI analysiert die Daten und fasst die Ergebnisse zusammen. Ein vollstandiges Dashboard in einem Satz.

🔒

Sicherheit erhalten

Dieselben Regeln wie die Anwendung: JWT-Authentifizierung, rollenbasierte Berechtigungen (30 Rechte), Organisations-Isolation.

📝

Automatisierte Aktionen

Erstellen Sie Lagerzugange/-abgange, andern Sie Bewegungsschein-Status — direkt aus dem Gesprach.

📈

Intelligente Analysen

Lagerausfallbenachrichtigungen, abgelaufene Produkte, Statistiken — die KI verknupft Daten und benachrichtigt Sie proaktiv.

🎓

Ausbildungsmodul

Lehrkrafte konnen Klassen, Szenarien und Schulerfortschritt durch einfache Fragen verfolgen.

Ohne MCP / Mit MCP

Ohne MCP

  • GSE-Web-Anwendung offnen
  • Durch Menus navigieren
  • Filter manuell anwenden
  • Als CSV exportieren, Excel offnen
  • Daten manuell verknupfen
  • Einen Bericht schreiben

Mit 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

Wie funktioniert es?

Der MCP-Server ist ein Node.js-Prozess, der lokal auf Ihrem Gerat lauft (oder remote uber HTTPS). Er authentifiziert sich bei GSE-Web mit Ihren Anmeldedaten und stellt dann 55 Werkzeuge bereit, die die KI aufrufen kann.

Votre machine (local) ↓ Claude + MCP Server Serveur d'hébergément (proxies HTTPS) Bases de données GSE-Web
Kein Port zu öffnen: der MCP-Server kommuniziert mit Claude über stdio (Standard-Ein-/Ausgabe) und mit GSE-Web über HTTPS. Kein lokaler Webserver freizugeben.

Voraussetzungen

ElementErforderlichHinweis
Node.jsv18 oder höhernodejs.org
npmIm Lieferumfang von Node.js-
Claude CodeAnthropic CLInpm install -g @anthropic-ai/claude-code
Konto GSE-WebGültige AnmeldedatenGleicher Login wie die Mobil-/Web-App
InternetverbindungJaUm die GSE-Web-APIs zu erreichen

Schritt-fur-Schritt-Installation

Schritt 1 — TypeScript-Server kompilieren

Offnen Sie ein Terminal im GSE-Web-Projektordner und fuhren Sie aus:

cd mcp-server
npm install
npm run build

Das kompilierte Ergebnis befindet sich in mcp-server/dist/.

Schritt 2 — Konfiguration prufen

Im Projektstamm ist bereits eine .mcp.json-Datei konfiguriert:

{
  "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/"
      }
    }
  }
}
Passen Sie das Feld cwd an den tatsächlichen Pfad des mcp-server-Ordners auf Ihrem Rechner an. Für die Produktion ersetzen Sie die URLs durch https://gse-web.xlexe.com und https://www.gse-web.online/.

Schritt 3 — Claude Code starten

Vom Projektstamm:

claude

Claude Code erkennt .mcp.json automatisch und schlagt die Aktivierung des gse-web-Servers vor. Akzeptieren.

Schritt 4 — Authentifizieren

In der Claude-Konversation, tippen Sie einfach:

Connecte-moi au serveur de développement GSE-Web
avec l'identifiant "mon_login" et le mot de passe "mon_password"

Claude ruft das authenticate-Werkzeug auf und bestatigt Ihre Verbindung mit Ihrer Rechtsliste.

Erste Nutzung: Konkrete Beispiele

Nach der Authentifizierung stellen Sie Fragen in naturlicher Sprache. Hier sind einige Beispiele:

🔍 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 opérations (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) — Hauptschnittstelle

Claude Code ist die empfohlene Schnittstelle fur den MCP-Server. Es erkennt automatisch die .mcp.json-Konfiguration und bietet die Serveraktivierung an.

Installation

npm install -g @anthropic-ai/claude-code

Verwendung

# 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
Tipp: Claude Code behält den Konversationskontext. Authentifizieren Sie sich einmal zu Beginn der Sitzung und stellen Sie dann beliebig viele Fragen.

Claude Desktop

Kompatibel mit Claude Desktop (Windows/Mac). Konfigurieren Sie es durch Hinzufugen des mcpServers-Abschnitts zur Konfigurationsdatei.

Konfiguration

Bearbeiten Sie die Claude Desktop-Konfigurationsdatei:

# macOS
~/Library/Application Support/Claude/claude_desktop_config.json

# Windows
%APPDATA%\Claude\claude_desktop_config.json

Fugen Sie den mcpServers-Abschnitt hinzu:

{
  "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/"
      }
    }
  }
}

Starten Sie Claude Desktop neu. Der Server erscheint in der Liste der verfugbaren Werkzeuge.

Claude.ai — Direkte Integration (empfohlen)

Die einfachste und leistungsstärkste Methode. Verbinden Sie Claude direkt mit Ihren GSE-Web-Daten über claude.ai, ohne etwas zu installieren.

Fur Claude Pro-, Max- oder Team-Nutzer: Verbinden Sie Ihren MCP-Server direkt uber die claude.ai-Oberflache. Keine lokale Installation erforderlich.

🧠

Naturliche Sprache

Claude (Opus, Sonnet, Haiku) versteht naturliche Sprache. Keine zu merkenden Schlusselworter, stellen Sie Fragen wie im Gesprach mit einem Kollegen.

💰

Im Abonnement enthalten

Keine zusatzlichen Kosten. Die MCP-Integration nutzt Ihr bestehendes Claude-Abonnement (Pro, Max oder Team).

🌐

100% browserbasiert

Alles funktioniert im Browser. Nichts herunterzuladen, nichts auf Ihrem Gerat zu konfigurieren.

🔒

Claude-grade Sicherheit

Authentifizierung uber Ihre GSE-Web-Anmeldedaten. Strikte Organisations-Isolation. Keine Daten werden vom MCP-Server gespeichert.

📝

Lesen + Schreiben

Sehen Sie Ihren Lagerbestand ein und erstellen Sie Zugange/Abgange — mit Rechtsprufung bei jeder Aktion.

📊

Erweiterte Analysen

Claude kann Daten verknupfen, Zeitraume vergleichen, Berichte erstellen — es hat Zugang zu 55 spezialisierten Werkzeugen.

Einrichtung (einmalig, 2 Minuten)

Einstellungen offnen

Gehen Sie zu claude.ai und klicken Sie auf das Zahnrad-Symbol unten links, um die Einstellungen zu offnen.

Integration hinzufugen

Klicken Sie im Abschnitt Integrationen auf "Integration hinzufugen". Geben Sie die MCP-Server-URL ein:

UmgebungZu kopierende URL
Entwicklung / Demohttps://gse-web-dev.xlexe.com/api/mcp_remote.php
Produktionhttps://gse-web.xlexe.com/api/mcp_remote.php

Die Integration erscheint in Ihrer Liste mit dem Namen "gse-web".

Authentifizieren

In einer neuen Claude-Konversation sagen Sie einfach:

Connecte-moi au serveur GSE-Web demo
avec l'identifiant "mon_login" et le mot de passe "mon_password"

Claude ruft das authenticate-Werkzeug auf und bestatigt Ihre Verbindung mit Ihrer Rechtsliste.

Stellen Sie Ihre Fragen!

Sie sind verbunden. Fragen Sie, was Sie mochten:

"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"

Was Claude mit Ihren Daten tun kann

🔍 Suche und Abfrage
  • Produkte nach Referenz, Name, Kategorie oder Barcode suchen
  • Produktdetails mit Bestand pro Lagerplatz anzeigen
  • Bestand nach Lagerplatz gefiltert auflisten
  • Verfügbare Kategorien und Lagerplätze anzeigen
📈 Analysen und Warnungen
  • Dashboard: Anzahl Produkte, Gesamtmenge, Benutzer
  • Fehlbestandswarnungen (Produkte mit Menge 0)
  • Verfallswarnungen (Produkte, die in 30 Tagen ablaufen)
  • Claude kann die Ergebnisse mehrerer Werkzeuge verknüpfen und analysieren, um komplexe Fragen zu beantworten
🚚 Bestandsbewegungen
  • Historie der Ein- und Ausgänge mit Datumsfiltern
  • Liste der Bewegungsbelege mit Statusfilter
  • Bestandseingänge erstellen (Recht EDITER_ENTREE erforderlich)
  • Bestandsausgänge erstellen (Recht EDITER_SORTIE erforderlich)

Claude wird immer um Bestätigung bitten, bevor ein Ein- oder Ausgang erstellt wird.

👥 Verwaltung (ADMIN-Rechte)
  • Liste der Benutzer in der Organisation
  • Anzeige der Rechte und Rollen

Unterschied zum Web-Assistenten

Web-Assistent (einfacher Chat)

  • Kostenlos, ohne Abonnement
  • Schlüsselwortbasiertes Verständnis
  • Vordefinierte Verknüpfungsschaltflächen
  • Keine Querschnittsanalyse
  • Einfache formatierte Antworten

Claude.ai (vollständige KI)

  • Claude-Abonnement erforderlich (Pro/Max/Team)
  • Vollständiges Verständnis natürlicher Sprache
  • Komplexe Fragen und Kontextverfolgung
  • Analyse, Vergleich, Datensynthese
  • Detaillierte Antworten mit Erklärungen

Häufig gestellte Fragen

Kostet das etwas extra?

Nein. Die MCP-Integration ist in Ihrem Claude-Abonnement enthalten (Pro für 20 $/Monat, Max für 100 $/Monat, Team für 30 $/Monat/Benutzer). Keine zusätzlichen Gebühren auf GSE-Web-Seite.

Werden meine Daten an Anthropic gesendet?

Die Daten fließen zwischen dem MCP-Server und Claude, um die Antworten zu formulieren. Anthropic speichert keine Daten aus MCP-Tools und verwendet sie nicht zum Trainieren seiner Modelle (Anthropic-Datenschutzrichtlinie). Die Verbindung ist Ende-zu-Ende HTTPS-verschlüsselt.

Kann jemand mit der MCP-Server-URL auf meine Daten zugreifen?

Nein. Die MCP-Server-URL erlaubt nur die Liste der verfügbaren Tools einzusehen (generische Namen wie "search_products"). Um auf irgendwelche Daten zuzugreifen, muss man sich mit einem echten GSE-Web-Login und Passwort authentifizieren. Es ist das gleiche Sicherheitsniveau wie eine Login-Seite.

Kann ich diese Integration mit meinem Team teilen?

Ja. Jedes Teammitglied fügt die URL in seinen eigenen Claude-Einstellungen hinzu und meldet sich dann mit seinen eigenen GSE-Web-Zugangsdaten an. Jeder sieht nur die Daten seiner Organisation.

Muss ich mich für jede Unterhaltung neu verbinden?

Ja, die GSE-Web-Authentifizierung erfolgt pro Unterhaltung. Sagen Sie Claude zu Beginn jeder neuen Unterhaltung, dass er Sie anmelden soll. Die MCP-Integration selbst bleibt dauerhaft in Ihren Einstellungen konfiguriert.

ChatGPT Custom GPT (keine Installation)

Ein Custom GPT in ChatGPT ermöglicht es jedem Benutzer, direkt von chat.openai.com aus mit den GSE-Web-Daten zu chatten. Keine Installation erforderlich.

Konfiguration durch den Administrator

Einen Custom GPT erstellen

Gehen Sie in ChatGPT zu Explore GPTs → Create.

Anweisungen hinzufügen

Fügen Sie diese Anweisungen in das Feld "Instructions" des GPT ein:

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

Aktionen konfigurieren

Importieren Sie im Tab Actions das OpenAPI-Schema unter:

https://gse-web.xlexe.com/api/gse_assistant_openapi.json

Die Authentifizierung erfolgt über den Header Authorization: Bearer, der nach dem Login automatisch vom GPT verwaltet wird.

Den GPT veröffentlichen

Wählen Sie "Only people with a link" oder "Anyone at [Ihre Organisation]", um mit Ihrem Team zu teilen.

Verwendung durch die Mitarbeiter

Der Benutzer öffnet einfach den Custom-GPT-Link und chattet ganz normal:

"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"

Web-Assistent (ohne KI)

Der Web-Assistent ist eine schnelle Abfrageschnittstelle mit Verknüpfungsschaltflächen und Schlüsselwortsuche. Er erfordert kein KI-Abonnement, verwendet aber keine künstliche Intelligenz.

Web-Assistenten öffnen →

Direkter Zugriff auf die Chat-Schnittstelle (GSE-Web-Anmeldedaten erforderlich).

Andere kompatible Werkzeuge

⚙️

n8n — Automatisierung →

Verbinden Sie GSE-Web mit n8n, um automatische Workflows zu erstellen: Bestandswarnungen, Berichte, ERP-Sync. Vollständiger Leitfaden verfügbar.

Cursor / Windsurf

IDE mit integrierter KI. Unterstützen das MCP-Protokoll für Entwickler.

Jeder MCP-Client

Jede MCP-kompatible Software kann sich mit dem lokalen gse-web-Server verbinden.

Werkzeug-Referenz

55 Werkzeuge im GSE-Web MCP-Server verfugbar.

Authentifizierung

WerkzeugBeschreibungZugriff
authenticate Verbindung zu einem GSE-Web-Server mit Login/Passwort herstellen Offen
get_current_user Profil und Rechte des angemeldeten Benutzers anzeigen JWT
list_servers Informationen zum Server des angemeldeten Benutzers JWT

Produkte & Bestand (Lesen)

WerkzeugBeschreibungZugriff
search_products Produkte nach Schlüsselwort suchen (Referenz, Bezeichnung, Kategorie) JWT
get_product_details Vollständige Details eines Produkts mit Bestand pro Lagerplatz JWT
get_stock_levels Bestandsniveaus mit Filtern nach Lager / Lagerplatz JWT
get_emplacements Liste der Lagerplätze JWT
get_catégories Eindeutige Produktkategorien JWT

Bewegungen (Lesen)

WerkzeugBeschreibungZugriff
list_entrées Bestandseingänge mit Datumsfiltern JWT
list_sorties Bestandsausgänge mit Datumsfiltern JWT
list_bon_mouvements Bewegungsbelege mit Statusfilter JWT
get_bon_mouvement_details Vollständige Details eines Bewegungsbelegs JWT

Schreibvorgänge

WerkzeugBeschreibungZugriff
create_entrée Einen Bestandseingang erstellen (Produkt, Menge, Lagerplatz, magasins_id, no_lot...) EDITER_ENTREE
create_sortie Einen Bestandsausgang erstellen EDITER_SORTIE
update_bon_mouvement_statut Den Status eines Bewegungsbelegs ändern EDITER_STATUTS_BDM

Benutzer & Organisation

WerkzeugBeschreibungZugriff
list_users Liste der Benutzer in der Organisation ADMIN
get_user_details Details eines Benutzers mit Gruppen und Rechten ADMIN
get_organisation_info Informationen zur aktuellen Organisation JWT

Analytik & Überwachung

WerkzeugBeschreibungZugriff
get_stock_alerts Warnungen: Fehlbestände, in 30 Tagen ablaufende Produkte JWT
get_dashboard_stats Wichtige Statistiken: Anzahl Produkte, Bestandsmenge, Anzahl Benutzer JWT
get_recent_logs Neueste Anwendungslogs mit Stufenfilter SUPERADMIN

Ausbildung

WerkzeugBeschreibungZugriff
list_classes Ausbildungsklassen FORMATION
list_scenarios Pädagogische Szenarien (Praxisarbeiten) FORMATION
get_student_progress Fortschritt der Schüler in einem Szenario FORMATION

Pädagogische Szenarien (Schreiben)

WerkzeugBeschreibungZugriff
create_scenario Erstellt ein vollständiges pädagogisches Szenario (Schritte, optionale Ressourcen und Schritt-Verknüpfungen) in einem einzigen Aufruf; die Gesamtpunktzahl wird als Summe der Punkte der Schritte neu berechnet FORMATION_ENSEIGNANT
add_scenario_ressource Fügt einem bestehenden Szenario eine Ressource (Video, PDF, Schema, Quiz, URL oder Datei) mit ihren Schritt-Verknüpfungen hinzu FORMATION_ENSEIGNANT
link_quiz_to_scenario Verknüpft ein bestehendes Bibliotheks-Quiz mit einem Szenario (erstellt eine Ressource vom Typ Quiz, die von der App zum Anzeigen des Quiz gelesen wird) FORMATION_ENSEIGNANT

Wareneingangsbelege

WerkzeugBeschreibungZugriff
list_bons_reception Wareneingangsbelege mit % Eingang, Filtern nach Datum und Lieferant JWT
get_bon_reception_details Details eines Wareneingangsbelegs mit Status pro Zeile (erhalten/teilweise/ausstehend) JWT

Kundenaufträge (OMS)

WerkzeugBeschreibungZugriff
list_commandes_clients Kundenaufträge aus dem OMS-Portal mit Filtern nach Status, Datum und Kunde JWT
get_commande_client_details Vollständige Details eines Kundenauftrags mit Produktzeilen JWT
get_oms_reconciliation_report OMS-Abgleichsbericht (nur Lesezugriff): validierte Bestellungen ohne Bewegungsschein, Scheine ohne Detailzeilen, blockierte Kit-Auflösungen. JWT

Logistik & Beschaffung

WerkzeugBeschreibungZugriff
list_commandes_fournisseurs Lieferantenbestellungen mit Statusfiltern JWT
get_commande_fournisseur_details Bestelldetails mit Zeilen (bestellt/erhalten/verbleibend) JWT
get_reception_status Eingangsstatus: % erhalten, ausstehende Zeilen JWT
list_expeditions Versendungen mit Anzahl Paletten und verknüpften Belegen JWT
get_expedition_details Versanddetails mit verknüpften Belegen und Paletten JWT
get_bon_reliquats Restbelege (-R1, -R2) eines teilweise vorbereiteten Belegs JWT
get_missing_quantities Fehlende Mengen (angefordert - ausgegeben) pro Zeile JWT
list_ruptures Produkte ohne Bestand mit Status und Lieferant JWT
get_stock_history Ein-/Ausgangshistorie eines Produkts über einen Zeitraum JWT
list_magasins Lager (Warenlager) der Organisation JWT

Dritte (Lieferanten & Kunden)

WerkzeugBeschreibungZugriff
list_tiers Lieferanten und Kunden mit Filtern nach Typ und Suche JWT
get_tiers_details Vollständige Details eines Dritten (30+ Felder) JWT

Erweiterte Bestandsvorgänge

WerkzeugBeschreibungZugriff
modify_stock Menge eines bestehenden Bestands ändern EDITER_PRODUIT
change_emplacement Lagerplatz eines Bestands ändern EDITER_PRODUIT

Massenerstellung (Bulk Create)

WerkzeugBeschreibungZugriff
bulk_create_tiers Erstellt in einem Aufruf bis zu 100 Geschäftspartner (Lieferanten/Kunden) auf einmal EDITER_FOURNISSEUR / EDITER_CLIENT
bulk_create_quiz_library Erstellt bis zu 50 Bibliotheks-Quiz mit ihren verschachtelten Fragen auf einmal FORMATION_ENSEIGNANT
bulk_create_products Erstellt Produkte (Katalog) in einem Aufruf auf einmal nur claude.ai EDITER_PRODUIT
bulk_create_entrees Erstellt Lagerzugänge (Wareneingänge) mit Bestandsvalidierung nach dem Einfügen nur claude.ai EDITER_ENTREE

Chargen & Rückverfolgbarkeit

WerkzeugBeschreibungZugriff
list_lots Paginierte Liste der Chargen (Produkt, Qualitätsstatus, ausgegebene Menge, Restkontrolle, MHD) JWT
get_lot_details Vollständiges Chargendetail: Info+Status, Produkt, Zugänge, Abgänge, Bestände, Verlauf der Qualitätskontrollen JWT
get_lot_tracking Alterungs-Dashboard: Chargenalter, bewertete MHD-Fristen, Qualitätsstatus, Top-10-Rotation, KPIs JWT
get_product_composition Stückliste eines zusammengesetzten Produkts (Kit): Komponenten + Menge pro Baugruppe JWT
list_composed_products Listet zusammengesetzte Produkte (Kits) mit ihrer Stückliste und der Anzahl verfügbarer Baugruppen auf JWT

Referenz: 3 Kontextressourcen

Ressourcen liefern der KI statischen Kontext, um die GSE-Web-Anwendung besser zu verstehen.

URIBeschreibung
gse://schema/tables GSE-Web-Datenbankstruktur (Haupttabellen und -beziehungen)
gse://permissions/list Die 32 verfügbaren Rechte mit ihrer Beschreibung
gse://docs/api Zusammenfassung der REST-API-Endpunkte (Produkte, Bestände, Bewegungen...)

Sicherheit

Der MCP-Server wendet dieselben Sicherheitsmechanismen wie die GSE-Web-Anwendung an.

🔑 JWT-Authentifizierung

Jede Sitzung beginnt mit einem authenticate-Aufruf. Das generierte JWT lauft nach der Sitzung ab.

👥 Organisations-Isolation

Unmoglicher Zugriff auf Daten anderer Mandanten. Jede SQL-Anfrage wird nach organisations_id gefiltert.

🛡️ 30 granulare Rechte

Schreib-Werkzeuge prufen die Rechte des eingeloggten Benutzers. Ohne das EDITER_PRODUIT-Recht ist die Erstellung eines Zugangs unmoglich.

🚫 Doppelter/Dreifacher SQL-Filter

Gemeinsame Server: ID + Org. Dedizierte Server: ID + Org + Servername.

⏱️ Rate-Limiting

60 Lesevorgange/Minute, 10 Schreibvorgange/Minute pro Sitzung. Schutzt vor Missbrauch.

👁️ Nachverfolgbare Logs

Jeder Werkzeugaufruf wird mit Zeitstempel, Benutzer, Werkzeug und Parametern protokolliert. Vollstandiger Audit-Trail.

Wichtig: der MCP-Server läuft lokal auf Ihrem Rechner. Ihre Anmeldedaten gehen nie durch einen Drittanbieterdienst. Die Kommunikation mit GSE-Web erfolgt direkt per HTTPS zu den sicheren Servern.

Anwendungsfälle nach Rolle

💼 Bestandsverwalter
  • "Welche Produkte haben einen Bestand unter dem Alarmschwellenwert?"
  • "Zeig mir die letzten 10 Bewegungen im Nord-Lager"
  • "Erstelle einen Eingang von 200 Isolierhandschuhen, Charge 2026-A, Lagerplatz B-12"
  • "Wie viele verschiedene Produkte haben wir insgesamt auf Lager?"
  • "Gibt es Produkte, die bald ablaufen?"
💻 Administrator
  • "Wie viele Benutzer sind in unserer Organisation registriert?"
  • "Welche Rechte hat Benutzer Nr. 23?"
  • "Zeig mir die Fehlerprotokolle der letzten 24 Stunden"
  • "Gib mir die globalen Dashboard-Statistiken"
  • "Mit welchem Server bin ich verbunden?"
📚 Ausbilder / Lehrer
  • "Liste meine Ausbildungsklassen auf"
  • "Welche Praxisarbeitsszenarien sind verfügbar?"
  • "Zeige den Fortschritt meiner Schüler im Szenario 'Vollständige Inventur'"
  • "Was ist die Durchschnittsnote der Klasse bei der letzten Praxisarbeit?"
🛠️ Techniker / Feldoperator
  • "Suche das Produkt mit dem Barcode 3700547800126"
  • "Was ist der Bestand dieses Produkts im Lagerplatz C-01?"
  • "Erfasse einen Ausgang von 5 Einheiten für die Baustelle Lyon"
  • "Welche Bewegungsbelege sind 'zu bearbeiten'?"
📊 Entwickler / Integrator
  • "Zeige mir die Datenbankstruktur"
  • "Welche API-Endpunkte sind verfügbar?" (Ressource gse://docs/api)
  • "Was ist das Antwortformat der Produkte-API?"
  • "Wie viele verschiedene Rechte gibt es im System?" (Ressource gse://permissions/list)
  • Integrieren Sie den MCP-Server in Ihre eigenen kompatiblen Werkzeuge

FAQ

Werden meine Zugangsdaten irgendwo gespeichert?

Nein. Der MCP-Server persistiert nichts auf der Festplatte. Das nach der Authentifizierung erhaltene JWT wird nur während der Sitzung im Speicher gehalten. Wenn Sie Claude Code schließen, wird alles gelöscht.

Kann ich auf Daten einer anderen Organisation zugreifen?

Nein. Alle Anfragen enthalten einen aus Ihrem JWT abgeleiteten organisations_id-Filter. Zusätzliche Filter verhindern jeden Zugriff außerhalb Ihrer Organisation.

Kann die KI meine Daten ohne meine Zustimmung ändern?

Claude Code fordert vor der Ausführung eines Schreib-Tools immer Ihre Genehmigung an. Sie sehen das Tool und seine Parameter und können ablehnen. Ein Rate Limiter begrenzt die Schreibvorgänge zudem auf 10/Minute.

Funktioniert der MCP-Server offline?

Nein. Der MCP-Server benötigt eine Internetverbindung, um die GSE-Web-APIs zu erreichen.

Kann ich den MCP-Server in der Produktion verwenden?

Ja. Ändern Sie die Umgebungsvariablen in .mcp.json:

"GSE_PROXY_BASE_URL": "https://gse-web.xlexe.com"
"GSE_DEFAULT_SERVER": "https://www.gse-web.online/"
Was kostet die Nutzung des MCP-Servers?

Der MCP-Server selbst ist kostenlos (Open Source, im Projekt enthalten). Die Kosten liegen auf der KI-Ebene: Sie benötigen ein Claude-Abonnement (Pro, Team oder Enterprise), um Claude Code oder Claude Desktop zu nutzen.

Wie aktualisiere ich den MCP-Server?

Nach einem git pull des Projekts einfach neu kompilieren:

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

Starten Sie dann Claude Code neu.