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):

https://mcp.wama.cloud/mcp
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

MethodeWann
Mit WAMA anmelden (empfohlen)Das KI-Tool öffnet den Browser und bittet um Anmeldung
API-Schlüssel einfügenDas Tool fragt nur nach einem Schlüssel, oder Anmeldung ist nicht verfügbar

Mit WAMA anmelden

  1. Fügen Sie die Server-Adresse oben in Ihrem KI-Tool hinzu.
  2. Wenn nach einer Client-ID gefragt wird, geben Sie ein: wama-mcp
  3. Schließen Sie die Anmeldung im Browser ab, wählen Sie eine Verkaufsstelle und den Umfang read oder read & write.
  4. 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

  1. In der WAMA-Web-App: Einstellungen → Integrationen → API-Schlüssel erstellen.
  2. Verkaufsstelle und Umfang wählen, dann den Schlüssel kopieren (wird nur einmal angezeigt).
  3. Im KI-Tool dieselbe Server-Adresse hinterlegen und den Schlüssel im Authorization-Header so setzen:
Bearer wama_…ihr_schlüssel…

Mehr dazu: Integrationen und API-Leitfaden.


Cursor

  1. Öffnen Sie Cursor Settings → MCP (oder die MCP-Konfigurationsdatei).
  2. Fügen Sie einen Server wama mit URL https://mcp.wama.cloud/mcp hinzu.
  3. Bevorzugen Sie Anmeldung: Client-ID wama-mcp und Scope read (oder read_write bei Bedarf).
  4. Genehmigen Sie die Browser-Anmeldung und stellen Sie eine einfache Frage wie „Liste ein paar Produkte“.

Beispielkonfiguration (Anmeldung):

{
  "mcpServers": {
    "wama": {
      "url": "https://mcp.wama.cloud/mcp",
      "auth": {
        "CLIENT_ID": "wama-mcp",
        "scopes": ["read"]
      }
    }
  }
}

Alternative mit Schlüssel: dieselbe URL und Authorization-Header mit Bearer wama_….

Claude Code

Im Terminal:

claude mcp add --transport http --client-id wama-mcp wama https://mcp.wama.cloud/mcp

Danach claude mcp login wama ausführen (oder /mcp in Claude Code) und die Browser-Anmeldung abschließen.

Claude.ai

  1. Öffnen Sie in Claude.ai die Einstellungen für Connectors / benutzerdefiniertes MCP.
  2. Server-URL https://mcp.wama.cloud/mcp hinzufügen.
  3. Bei Abfrage der Client-ID: wama-mcp.
  4. WAMA-Login und Zustimmung im Browser abschließen.

ChatGPT

  1. Aktivieren Sie den Developer mode (oder benutzerdefiniertes MCP / Connectors, je nach ChatGPT-Plan).
  2. Fügen Sie einen MCP-Server mit URL https://mcp.wama.cloud/mcp hinzu.
  3. Bevorzugen Sie die Client-ID wama-mcp (ohne Secret), wenn die Oberfläche das zulässt.
  4. Wenn ChatGPT nur automatische Client-Registrierung anbietet und das scheitert, nutzen Sie API-Schlüssel einfügen.

Gemini

  1. Öffnen Sie in Gemini Settings → Connected apps.
  2. Wählen Sie + Custom.
  3. Geben Sie die MCP-Server-URL https://mcp.wama.cloud/mcp ein.
  4. Öffnen Sie Additional settings → Show more.
  5. Setzen Sie Client ID auf wama-mcp und lassen Sie Client secret leer.
  6. 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

  1. Öffnen Sie die MCP- / Copilot-MCP-Einstellungen (JSON).
  2. Fügen Sie einen HTTP-Server auf https://mcp.wama.cloud/mcp mit OAuth-Client-ID wama-mcp hinzu.
  3. Schließen Sie die Browser-Anmeldung ab, wenn Sie dazu aufgefordert werden.

Beispiel:

{
  "servers": {
    "wama": {
      "type": "http",
      "url": "https://mcp.wama.cloud/mcp",
      "oauth": {
        "clientId": "wama-mcp"
      }
    }
  }
}

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:

  1. URL https://mcp.wama.cloud/mcp verwenden.
  2. Client-ID wama-mcp (ohne Secret) für die Anmeldung.
  3. 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.