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.
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.
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.
stdio (Standard-Ein-/Ausgabe) und mit GSE-Web über HTTPS. Kein lokaler Webserver freizugeben. Voraussetzungen
| Element | Erforderlich | Hinweis |
|---|---|---|
Node.js | v18 oder höher | nodejs.org |
npm | Im Lieferumfang von Node.js | - |
Claude Code | Anthropic CLI | npm install -g @anthropic-ai/claude-code |
| Konto GSE-Web | Gültige Anmeldedaten | Gleicher Login wie die Mobil-/Web-App |
| Internetverbindung | Ja | Um 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/"
}
}
}
}
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:
"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) — 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
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)
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:
| Umgebung | Zu kopierende URL |
|---|---|
| Entwicklung / Demo | https://gse-web-dev.xlexe.com/api/mcp_remote.php |
| Produktion | https://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
- 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
- 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
- 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.
- 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
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.
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.
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.
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.
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
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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)
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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)
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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)
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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)
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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)
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
modify_stock |
Menge eines bestehenden Bestands ändern | EDITER_PRODUIT |
change_emplacement |
Lagerplatz eines Bestands ändern | EDITER_PRODUIT |
Massenerstellung (Bulk Create)
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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
| Werkzeug | Beschreibung | Zugriff |
|---|---|---|
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.
| URI | Beschreibung |
|---|---|
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.
Anwendungsfälle nach Rolle
- "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?"
- "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?"
- "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?"
- "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'?"
- "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
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.
Nein. Alle Anfragen enthalten einen aus Ihrem JWT abgeleiteten organisations_id-Filter. Zusätzliche Filter verhindern jeden Zugriff außerhalb Ihrer Organisation.
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.
Nein. Der MCP-Server benötigt eine Internetverbindung, um die GSE-Web-APIs zu erreichen.
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/"
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.
Nach einem git pull des Projekts einfach neu kompilieren:
cd mcp-server && npm install && npm run build
Starten Sie dann Claude Code neu.