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 und Verkä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

Zwei Wege zur Verbindung

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.

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“
• „Wie ist der Bestand für Produkt …?“
• „Kurze Verkaufszusammenfassung für diese Woche“

Schreibaktionen (Bestand anpassen, Verkauf anlegen oder abschließen) 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.