MCP
WAMA mit KI nutzen (MCP)
WAMA kann über MCP (Model Context Protocol) mit gängigen KI-Tools sprechen. Nach einer kurzen Einrichtung können Sie den Assistenten zu Produkten, Bestand, Verkäufen, Lieferanten und Einkäufen für eine Verkaufsstelle fragen — die, die Sie beim Verbinden wählen.
Server-Adresse (für alle Tools gleich):
Tipp
Sie brauchen ein WAMA-Konto. Bevorzugen Sie Nur Lesen, sofern der Assistent keine Daten schreiben soll (Bestand, Verkäufe, Bestellentwürfe oder Lieferanten).
Zwei Wege zur Verbindung
| Methode | Wann |
|---|---|
| Mit WAMA anmelden (empfohlen) | Das KI-Tool öffnet den Browser und bittet um Anmeldung |
| API-Schlüssel einfügen | Das Tool fragt nur nach einem Schlüssel, oder Anmeldung ist nicht verfügbar |
Mit WAMA anmelden
- Fügen Sie die Server-Adresse oben in Ihrem KI-Tool hinzu.
- Wenn nach einer Client-ID gefragt wird, geben Sie ein:
wama-mcp - Schließen Sie die Anmeldung im Browser ab, wählen Sie eine Verkaufsstelle und den Umfang read oder read & write.
- Kehren Sie zum KI-Tool zurück — Sie sind verbunden.
Den Zugriff können Sie später in der Web-App widerrufen: Einstellungen → Integrationen.
API-Schlüssel einfügen
- In der WAMA-Web-App: Einstellungen → Integrationen → API-Schlüssel erstellen.
- Verkaufsstelle und Umfang wählen, dann den Schlüssel kopieren (wird nur einmal angezeigt).
- Im KI-Tool dieselbe Server-Adresse hinterlegen und den Schlüssel im Authorization-Header so setzen:
Mehr dazu: Integrationen und API-Leitfaden.
Cursor
- Öffnen Sie Cursor Settings → MCP (oder die MCP-Konfigurationsdatei).
- Fügen Sie einen Server
wamamit URLhttps://mcp.wama.cloud/mcphinzu. - Bevorzugen Sie Anmeldung: Client-ID
wama-mcpund Scoperead(oderread_writebei Bedarf). - Genehmigen Sie die Browser-Anmeldung und stellen Sie eine einfache Frage wie „Liste ein paar Produkte“.
Beispielkonfiguration (Anmeldung):
Alternative mit Schlüssel: dieselbe URL und Authorization-Header mit Bearer wama_….
Claude Code
Im Terminal:
Danach claude mcp login wama ausführen (oder /mcp in Claude Code) und die Browser-Anmeldung abschließen.
Claude.ai
- Öffnen Sie in Claude.ai die Einstellungen für Connectors / benutzerdefiniertes MCP.
- Server-URL
https://mcp.wama.cloud/mcphinzufügen. - Bei Abfrage der Client-ID:
wama-mcp. - WAMA-Login und Zustimmung im Browser abschließen.
ChatGPT
- Aktivieren Sie den Developer mode (oder benutzerdefiniertes MCP / Connectors, je nach ChatGPT-Plan).
- Fügen Sie einen MCP-Server mit URL
https://mcp.wama.cloud/mcphinzu. - Bevorzugen Sie die Client-ID
wama-mcp(ohne Secret), wenn die Oberfläche das zulässt. - Wenn ChatGPT nur automatische Client-Registrierung anbietet und das scheitert, nutzen Sie API-Schlüssel einfügen.
Gemini
- Öffnen Sie in Gemini Settings → Connected apps.
- Wählen Sie + Custom.
- Geben Sie die MCP-Server-URL
https://mcp.wama.cloud/mcpein. - Öffnen Sie Additional settings → Show more.
- Setzen Sie Client ID auf
wama-mcpund lassen Sie Client secret leer. - Fahren Sie fort und schließen Sie WAMA-Login und Zustimmung im Browser ab.
Gemini kann melden, dass der Server keine automatische Registrierung unterstützt — das ist erwartet; verwenden Sie die statische Client-ID oben.
VS Code / GitHub Copilot
- Öffnen Sie die MCP- / Copilot-MCP-Einstellungen (JSON).
- Fügen Sie einen HTTP-Server auf
https://mcp.wama.cloud/mcpmit OAuth-Client-IDwama-mcphinzu. - Schließen Sie die Browser-Anmeldung ab, wenn Sie dazu aufgefordert werden.
Beispiel:
OpenAI Codex CLI
Fügen Sie einen HTTP-MCP-Server mit URL https://mcp.wama.cloud/mcp und OAuth-Client-ID wama-mcp hinzu. Folgen Sie der aktuellen Codex-Dokumentation für die Konfigurationsdatei. Browser-Anmeldung bei Bedarf abschließen.
Windsurf
Fügen Sie ein Remote-MCP https://mcp.wama.cloud/mcp mit Client-ID wama-mcp hinzu und schließen Sie die Browser-Anmeldung ab.
Andere KI-Tools
Wenn Ihr Tool Remote-MCP über HTTPS unterstützt:
- URL
https://mcp.wama.cloud/mcpverwenden. - Client-ID
wama-mcp(ohne Secret) für die Anmeldung. - Oder API-Schlüssel als
Authorization: Bearer wama_…einfügen.
Desktop-Apps, die eine lokale Callback-URL öffnen (http://localhost… oder http://127.0.0.1…), werden automatisch unterstützt.
Was Sie fragen können
Mit verbundenem Assistenten (Beispiele):
- „Suche Produkte, die … enthalten“
- „Liste Kategorien“ / „Suche Kategorien nach …“ / „Hole Kategorie …“
- „Erstelle ein Produkt namens …“ / „Aktualisiere den Preis für Produkt …“
- „Erstelle eine Kategorie …“ / „Benenne Kategorie um …“
- „Wie ist der Bestand für Produkt …?“
- „Liste die Lagerplätze in diesem Lager“
- „Liste Lieferanten“ / „Aktualisiere die Adresse von Lieferant …“
- „Erstelle einen Bestellentwurf für …“
- „Kurze Verkaufszusammenfassung für diese Woche“
Schreibaktionen (Bestand anpassen, Produkt oder Kategorie anlegen oder aktualisieren, Verkauf anlegen oder abschließen, Bestellentwurf erstellen, Lieferanten aktualisieren) brauchen den Umfang read & write. Bleiben Sie bei read, bis Sie das brauchen.
Sicherheitstipps
- Eine Verbindung = eine Verkaufsstelle. Legen Sie einen weiteren Schlüssel an oder verbinden Sie sich neu für ein anderes Lager/Geschäft.
- Behandeln Sie API-Schlüssel wie Passwörter. Teilen Sie sie nicht in Chat, E-Mail oder öffentlichen Tickets.
- Widerrufen Sie ungenutzte Schlüssel unter Einstellungen → Integrationen.
- Für Entwickler an der REST-API (nicht MCP) siehe den API-Leitfaden.