KANTWERKby LuminaX Digital
AnmeldenBuchen

Kantwerk · MCP

Shop-Konfigurator per KI einrichten

Kantwerk spricht das Model Context Protocol (MCP). Ihr KI-Assistent – Claude, Codex, Cursor oder Copilot – richtet den Blech-Konfigurator mit Preisen in Ihrem Shop ein. Sie beantworten nur seine Fragen.

  1. Schritt 1Kantwerk hinzufügenIn Claude, ChatGPT oder Claude Code die Server-Adresse eintragen und im Browser mit dem Kantwerk-Konto anmelden (Admin, Kantwerk Pro).
  2. Schritt 2Oder per SchlüsselFür Codex, Cursor, VS Code, Windsurf, Gemini: Schlüssel in Kantwerk unter Einstellungen → Shop-Einbindung → KI-Assistent erzeugen.
  3. Schritt 3Sagen, was Sie wollen„Richte meinen Shop mit Kantwerk ein (Kantwerk-MCP).“ – der Assistent fragt nach E-Mail, Preisen und Shop und erledigt den Rest.

Server-Adresse: https://kantwerk.luminaxdigital.com/api/mcp · Transport: Streamable HTTP · Anmeldung: OAuth 2.1 (Browser) oder Authorization: Bearer kwm_…

Anleitung je KI-Werkzeug

Mit „Login“ markiert: Anmeldung im Browser, kein Schlüssel nötig. Sonst „IHR_MCP_SCHLÜSSEL“ ersetzen – in der App steht er direkt im Code.

Claude (Web, Desktop, Handy)Loginanzeigen

claude.ai → Einstellungen → Konnektoren → „Benutzerdefinierten Konnektor hinzufügen“ (gilt auch in den Claude-Apps)

https://kantwerk.luminaxdigital.com/api/mcp
  1. Name „Kantwerk“, Adresse oben einfügen → Hinzufügen.
  2. „Verbinden“ → mit Ihrem Kantwerk-Konto anmelden → „Erlauben“.
  3. Im Chat das Werkzeug-Symbol öffnen, Kantwerk aktivieren und schreiben: „Richte meinen Shop mit Kantwerk ein (Kantwerk-MCP).“
ChatGPTLoginanzeigen

Einstellungen → Apps & Konnektoren → Erweitert → Entwicklermodus einschalten → „Erstellen“ (Plus, Pro, Business)

https://kantwerk.luminaxdigital.com/api/mcp
  1. Name „Kantwerk“, MCP-Server-Adresse oben, Authentifizierung „OAuth“ → Erstellen.
  2. Mit Ihrem Kantwerk-Konto anmelden → „Erlauben“.
  3. Im Chat über „+“ → Entwicklermodus Kantwerk auswählen und schreiben: „Richte meinen Shop mit Kantwerk ein (Kantwerk-MCP).“
Claude CodeLoginanzeigen

Terminal, einmalig (gilt für alle Projekte). Ohne Browser: zusätzlich --header "Authorization: Bearer kwm_…"

claude mcp add --transport http --scope user kantwerk https://kantwerk.luminaxdigital.com/api/mcp
  1. Befehl im Terminal ausführen und Claude Code starten.
  2. /mcp → kantwerk → „Authenticate“ → im Browser bei Kantwerk anmelden → „Erlauben“.
  3. Schreiben: „Richte meinen Shop mit Kantwerk ein (Kantwerk-MCP).“ – oder /mcp__kantwerk__shop_einrichten
Codex (CLI, App, IDE)anzeigen

~/.codex/config.toml – Schlüssel als Umgebungsvariable (z. B. in ~/.zshrc)

# ~/.codex/config.toml
[mcp_servers.kantwerk]
url = "https://kantwerk.luminaxdigital.com/api/mcp"
bearer_token_env_var = "KANTWERK_MCP_TOKEN"

# ~/.zshrc bzw. ~/.bashrc
# export KANTWERK_MCP_TOKEN="IHR_MCP_SCHLÜSSEL"
  1. Eintrag in ~/.codex/config.toml ergänzen.
  2. Umgebungsvariable KANTWERK_MCP_TOKEN setzen und Terminal neu öffnen.
  3. Codex starten, /mcp prüfen, dann: „Richte meinen Shop mit Kantwerk ein (Kantwerk-MCP).“
Cursoranzeigen

~/.cursor/mcp.json (oder Einstellungen → MCP → Add new MCP server)

{
  "mcpServers": {
    "kantwerk": {
      "url": "https://kantwerk.luminaxdigital.com/api/mcp",
      "headers": { "Authorization": "Bearer IHR_MCP_SCHLÜSSEL" }
    }
  }
}
  1. Eintrag in ~/.cursor/mcp.json einfügen.
  2. In den Cursor-Einstellungen unter MCP prüfen, dass „kantwerk“ grün ist.
  3. Im Agent-Chat: „Richte meinen Shop mit Kantwerk ein (Kantwerk-MCP).“
VS Code (GitHub Copilot)anzeigen

Befehl „MCP: Open User Configuration“ (mcp.json)

{
  "servers": {
    "kantwerk": {
      "type": "http",
      "url": "https://kantwerk.luminaxdigital.com/api/mcp",
      "headers": { "Authorization": "Bearer IHR_MCP_SCHLÜSSEL" }
    }
  }
}
  1. Eintrag in die mcp.json einfügen und speichern, Server starten.
  2. Copilot-Chat auf „Agent“ stellen.
  3. Schreiben: „Richte meinen Shop mit Kantwerk ein (Kantwerk-MCP).“
Windsurfanzeigen

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "kantwerk": {
      "serverUrl": "https://kantwerk.luminaxdigital.com/api/mcp",
      "headers": { "Authorization": "Bearer IHR_MCP_SCHLÜSSEL" }
    }
  }
}
  1. Eintrag einfügen, in Cascade unter MCP-Servern aktualisieren.
  2. In Cascade: „Richte meinen Shop mit Kantwerk ein (Kantwerk-MCP).“
Gemini CLIanzeigen

~/.gemini/settings.json

{
  "mcpServers": {
    "kantwerk": {
      "httpUrl": "https://kantwerk.luminaxdigital.com/api/mcp",
      "headers": { "Authorization": "Bearer IHR_MCP_SCHLÜSSEL" }
    }
  }
}
  1. Eintrag in ~/.gemini/settings.json einfügen.
  2. gemini starten, mit /mcp prüfen.
  3. Schreiben: „Richte meinen Shop mit Kantwerk ein (Kantwerk-MCP).“

Was der Assistent kann

  • kantwerk_statusZeigt den kompletten Stand: Checkliste (was fehlt), Konfigurator-Einstellungen, Verkaufsart, Preisliste, Shop-Verbindung, wählbare Materialien/Stärken, Einbett-Code. Immer zuerst aufrufen.
  • configure_configuratorKonfigurator ein-/ausschalten und anpassen: Empfänger-E-Mail, Datenschutz-Link, Texte, Markenfarbe, wählbare Blechstärken, Ausschnitte. Nur übergebene Felder werden geändert.
  • set_sales_and_pricesAnfrage per E-Mail oder Warenkorb mit Preis; Preisliste (netto € je m² Zuschnitt je Material + Stärke) und Zuschläge. Preisformel: Stück = max(Mindestpreis, m² × €/m² + Kantungen × perBend + Ausschnitte + verschweißte Ecken), Position = Stück × Menge + Rüstkosten.
  • connect_shopLegt fest, in welchen Shop die Platte mit Preis gelegt wird (nur Warenkorb-Modus): woocommerce/gambio (shopUrl), shopify (shopifyDomain), custom (cartUrlTemplate mit {id}). Danach get_install_instructions.
  • create_plugin_api_keyErzeugt einen neuen API-Schlüssel (kw_…) für das WooCommerce-Plugin, das Gambio-Modul oder eine eigene Anbindung. Ein vorhandener Schlüssel wird dabei ungültig. Der Schlüssel wird nur jetzt angezeigt – dem Nutzer zum Eintragen im Shop geben.
  • connect_shopifySpeichert Client-ID + Client-Secret der Shopify-App (Dev Dashboard, Rechte write_draft_orders + read_orders), prüft die Verbindung und richtet den Webhook „Bestellung bezahlt“ ein. Vorher connect_shop mit platform=shopify.
  • get_install_instructionsSchritt-für-Schritt-Anleitung für das Shopsystem inkl. Download-Links, Einbett-Code und wo er eingefügt wird.
  • calculate_priceRechnet eine Beispiel-Platte mit den Regeln und der Preisliste der Firma durch (Prüfung + Preis), ohne etwas zu speichern. Gut zum Prüfen der Preisliste.
  • list_shop_ordersLetzte Konfigurationen aus dem Warenkorb-Modus mit Status (open, in_cart, paid), Preis und Bestellnummer – zum Prüfen, ob die Anbindung funktioniert.

Sicherheit

  • Jeder Schlüssel gilt nur für Ihre Firma und nur für die Shop-Einbindung – keine Benutzer, kein Abo, keine Aufträge.
  • Anmeldung im Browser nur mit Kantwerk-Login und ausdrücklicher Zustimmung eines Admins (OAuth 2.1 mit PKCE).
  • Jede Verbindung und jeden Schlüssel mit „zuletzt genutzt“ sehen und jederzeit einzeln widerrufen.
  • Gespeichert wird nur ein Hash – den Schlüssel selbst sehen Sie genau einmal.
  • Preise kommen immer aus Kantwerk, nie aus dem Browser des Kunden. DXF + PDF gibt es erst nach bezahlter Bestellung.

Noch kein Kantwerk? Kantwerk Pro buchen – der Shop-Konfigurator und der MCP-Zugang sind inklusive.