desk4 API und MCP-Server: Ihre Warenwirtschaft für KI und eigene Anwendungen öffnen
Mit der offenen desk4 API verbinden Sie Ihre Cloud-Warenwirtschaft mit eigenen Programmen, Dashboards und Automatisierungen. Neu ist der MCP-Server: Damit greifen KI-Assistenten wie Claude, ChatGPT oder Microsoft Copilot direkt auf Ihre desk4 Daten zu – sie beantworten Fragen, legen Angebote an und liefern Auswertungen.
- REST-API mit JSON und OpenAPI-Dokumentation
- MCP-Server für KI-Assistenten und Agenten
- Sichere Anmeldung per OAuth 2.0
- Im desk4 Paket enthalten
Lieber direkt sprechen? 02773 92090
Technik auf einen Blick
- Schnittstelle
- REST mit JSON, Version V1
- KI-Anbindung
- MCP-Server (Model Context Protocol)
- Anmeldung
- OAuth 2.0 (Client Credentials) oder WebToken
- Dokumentation
- Swagger / OpenAPI, Hilfe-Center
- Rechte
- Fein steuerbar je API-Benutzer
- Rechenzentren
- In Deutschland
- Kosten
- Im desk4 Paket enthalten
Was die desk4 API kann
Die desk4 API ist die offene Programmierschnittstelle der Cloud-Warenwirtschaft desk4 der Dupp GmbH. Über eine REST-Schnittstelle mit JSON lesen, anlegen und ändern Sie Daten wie Kunden, Artikel und Belege – aus eigenen Anwendungen, Automatisierungs-Tools wie n8n oder Business-Intelligence-Werkzeugen.
Der desk4 MCP-Server ist Bestandteil der neuen API. Er stellt desk4 über das Model Context Protocol (MCP) für KI-Anwendungen bereit. Jede KI, die einen MCP-Server ansprechen kann, arbeitet damit direkt mit Ihren desk4 Daten – im Rahmen der Rechte, die Sie dem API-Benutzer geben.
- Format
- REST, JSON
- KI
- MCP-Server, live
- Anmeldung
- OAuth 2.0, WebToken
- Doku
- Swagger / OpenAPI
- Demo
- demo.desk4.net
- Kosten
- Im Paket enthalten
- Rechenzentren
- In Deutschland
- Anbieter
- Dupp GmbH, Haiger
Der desk4 MCP-Server: Ihre Warenwirtschaft spricht mit KI
Das Model Context Protocol (MCP) ist ein offener Standard, über den KI-Assistenten auf Programme und Daten zugreifen. Der desk4 MCP-Server macht Ihre Warenwirtschaft für diese Assistenten verfügbar – ohne eigene Programmierung.
Daten abfragen
Die KI liest Kunden, Artikel, Belege und Lagerbestände und beantwortet Fragen in normaler Sprache – statt Listen und Filter zu bedienen.
Daten anlegen und ändern
Kunden anlegen, Angebote und Aufträge erstellen, Stammdaten pflegen: Die KI erledigt Routinearbeit direkt in desk4.
Auswertungen erstellen
Umsätze, offene Posten und Kennzahlen fasst die KI zusammen, vergleicht Zeiträume und bereitet sie verständlich auf.
Mit diesen KI-Anwendungen nutzbar
- Claude
- ChatGPT
- Microsoft Copilot
- n8n
- eigene KI-Agenten
- jede Anwendung, die einen MCP-Server ansprechen kann
So arbeiten Sie mit desk4 und KI
Welche Rechnungen sind seit mehr als 30 Tagen überfällig?
Die KI fragt die offenen Posten ab und listet Kunden, Beträge und Fälligkeiten.
Erstelle für die Muster GmbH ein Angebot über 20 Stück Artikel 1004.
Die KI sucht Kunde und Artikel und legt das Angebot in desk4 an.
Wie hoch war unser Umsatz im Oktober im Vergleich zum Vorjahr?
Die KI wertet die Belege aus und fasst das Ergebnis zusammen.
Welche Artikel liegen unter dem Mindestbestand?
Die KI prüft die Lagerbestände und nennt, was nachbestellt werden sollte.
Sicher durch Rechte des API-Benutzers
Die KI sieht und darf nur, was Sie dem API-Benutzer erlauben. Unser Rat: Legen Sie für KI-Anwendungen einen eigenen API-Benutzer an und geben Sie ihm nur die Rechte, die er braucht – etwa nur Lesen für Auswertungen. Die Verbindung läuft verschlüsselt, die Daten bleiben in Rechenzentren in Deutschland.
KI in desk4 – und desk4 in der KI
desk4 bringt eigene KI-Funktionen über die ChatGPT-Schnittstelle mit, etwa für Kundenanlage, Belegimport und Texte. Der MCP-Server geht den umgekehrten Weg: Er macht desk4 für Ihren KI-Assistenten nutzbar – dort, wo Sie ohnehin arbeiten.
desk4 mit Ihrer KI verbinden?Wir zeigen Ihnen den MCP-Server und helfen beim Einrichten.
Typische Anwendungen der desk4 API
Die API öffnet desk4 für Ihre Systemlandschaft – für Entwickler, IT-Abteilungen und Systemintegratoren.
Branchenlösungen
Eigene Anwendungen, die mit desk4 sprechen – etwa eine Handwerker-App, die Aufträge in desk4 anlegt, oder eine Vermietungssoftware, die Rechnungen erzeugt.
Dashboards und BI
Eigene Auswertungen und Kennzahlen in Ihrem Business-Intelligence-Werkzeug, gespeist direkt aus desk4.
Systemintegration
CRM, Produktionsplanung, Telefonanlage oder eigene Mobile App: Daten fließen in beide Richtungen.
Automatisierung
Eigene Abläufe mit Werkzeugen wie n8n: Ereignisse in desk4 lösen Aktionen in anderen Systemen aus – oder umgekehrt.
Drittsysteme
Programme anbinden, für die es noch keine fertige Schnittstelle gibt – jede Software mit eigener API ist anschließbar.
KI-Agenten
Über den MCP-Server arbeiten KI-Assistenten und eigene Agenten direkt mit Ihren Warenwirtschaftsdaten.
In vier Schritten zur Verbindung
API-Benutzer anlegen
Markieren Sie in desk4 einen Benutzer als API-Benutzer. Er sollte keiner Berechtigungsgruppe angehören.
Rechte festlegen
In der REST-Schnittstelle bestimmen Sie, welche Daten der API-Benutzer lesen und ändern darf.
Anmelden
Per OAuth 2.0 mit Benutzername und Passwort des API-Benutzers als Client ID und Secret – oder per WebToken.
Loslegen
Endpunkte in der Swagger-Dokumentation ansehen und anbinden – oder den MCP-Server in Ihrer KI-Anwendung eintragen.
Token per OAuth 2.0 abrufen
POST https://meine-firma.desk4.cloud/rest/v1/session/token grant_type=client_credentials client_id=<API-Benutzer> client_secret=<Passwort>
Kunden abfragen
GET https://meine-firma.desk4.cloud/rest/v1/customer Authorization: Bearer <AccessToken> → JSON-Liste Ihrer Kunden
Das sollten Entwickler wissen
| Basis-URL | https://<ihre-instanz>/rest/v1, Demo: https://demo.desk4.net/rest/v1 |
|---|---|
| Format | REST mit JSON; aktuell Version V1, Version V2 ist in Entwicklung |
| OAuth 2.0 | Client Credentials über /session/token, Client ID und Secret im Request-Body |
| WebToken | POST auf /session/webtoken mit userName, password, branchID; das Token gilt 30 Minuten |
| Header | Authorization: Bearer <Token> |
| Änderungen | Optimistic Locking über das Feld version; in V1 wird immer das vollständige Objekt gesendet |
| Dokumentation | Swagger / OpenAPI, Hilfe-Center: API-Zugang, llms.txt |
| Nutzung | Faires Rate Limiting zum Schutz der Systeme, verschlüsselt über HTTPS |
| KI-Anbindung | MCP-Server als Bestandteil der API, Zugriff im Rahmen der Rechte des API-Benutzers |
desk4 mit n8n verbinden
Zugang einrichten
- In n8n unter Credentials „OAuth2 API“ anlegen
- Grant Type „Client Credentials“ wählen
- Access Token URL:
https://meine-firma.desk4.cloud/rest/v1/session/token - Client ID und Secret des API-Benutzers eintragen, Authentication „Body“
Daten abrufen
- HTTP-Request-Node mit den Credentials anlegen
- Methode GET, URL
…/rest/v1/customer - Ergebnis: JSON-Liste der Kunden zur Weiterverarbeitung
- Mit dem MCP-Server lassen sich auch KI-Agenten in n8n an desk4 anbinden
Weitere fertige Anbindungen finden Sie in der Schnittstellen-Übersicht: Onlineshops wie Shopware und Shopify, über 70 Marktplätze über die Marktplatzanbindung, DATEV und mehr.
Wir helfen bei Ihrer Integration
Sie möchten desk4 an Ihre Systeme oder Ihren KI-Assistenten anbinden? Wir besprechen Ihr Vorhaben, zeigen Ihnen API und MCP-Server und helfen beim Einrichten des API-Benutzers.
Sie planen eine Integration?Telefonisch unter 02773 92090 oder im Termin.
desk4 mit API und KI ausprobieren
Kostenlos, ohne Vertrag und ohne Zeitlimit – mit Musterkunden, Musterartikeln und Musteraufträgen.
Noch Fragen zur API?Ein kurzes Gespräch klärt mehr als jede Dokumentation.
Häufige Fragen zur desk4 API und zum MCP-Server
Was ist die desk4 API?
Die desk4 API ist die offene REST-Schnittstelle der Cloud-Warenwirtschaft desk4. Entwickler und Unternehmen lesen, anlegen und ändern darüber Daten wie Kunden, Artikel und Belege im JSON-Format und verbinden desk4 mit eigenen Anwendungen, Automatisierungen und Auswertungen.
Was ist der desk4 MCP-Server?
Der desk4 MCP-Server ist Bestandteil der neuen desk4 API. Er stellt desk4 über das Model Context Protocol (MCP) für KI-Anwendungen bereit. KI-Assistenten können damit desk4 Daten abfragen, Daten anlegen und ändern sowie Auswertungen erstellen – im Rahmen der Rechte des API-Benutzers.
Welche KI-Anwendungen kann ich mit desk4 verbinden?
Über den MCP-Server lassen sich unter anderem Claude, ChatGPT, Microsoft Copilot, n8n und eigene KI-Agenten anbinden – grundsätzlich jede Anwendung, die einen MCP-Server ansprechen kann.
Was kann eine KI über den MCP-Server in desk4 tun?
Eine KI kann Kunden, Artikel, Belege und Lagerbestände abfragen, Datensätze wie Kunden, Angebote und Aufträge anlegen oder ändern und Auswertungen etwa zu Umsätzen und offenen Posten erstellen. Was erlaubt ist, legen Sie über die Rechte des API-Benutzers fest.
Wie sicher ist die Anbindung von KI an desk4?
Die KI arbeitet nur mit den Rechten des API-Benutzers, die Verbindung läuft verschlüsselt über HTTPS und die Daten liegen in Rechenzentren in Deutschland. Empfohlen ist ein eigener API-Benutzer für KI-Anwendungen mit nur den nötigen Rechten.
Wie melde ich mich an der desk4 API an?
Entweder per OAuth 2.0 mit dem Grant Type Client Credentials über /rest/v1/session/token – Benutzername und Passwort des API-Benutzers dienen als Client ID und Secret – oder per WebToken über /rest/v1/session/webtoken. Ein WebToken gilt 30 Minuten. Das Token wird als Bearer-Token im Authorization-Header übergeben.
Wie bekomme ich Zugang zur API?
Sie markieren in desk4 einen Benutzer als API-Benutzer und legen in der REST-Schnittstelle seine Rechte fest. Der API-Benutzer sollte keiner Berechtigungsgruppe angehören. Danach melden Sie sich per OAuth 2.0 oder WebToken an.
Wo finde ich die API-Dokumentation?
Alle Endpunkte stehen in der Swagger- bzw. OpenAPI-Dokumentation unter demo.desk4.net/q/swagger. Eine Anleitung zum API-Zugang gibt es im desk4 Hilfe-Center unter docs.desk4.de.
Kostet die API extra?
Nein. Die Nutzung der API ist im desk4 Paket enthalten, solange sie im Rahmen der fairen Nutzung bleibt. Individuelle Entwicklungsunterstützung kann kostenpflichtig sein.
Kann ich die API vorher testen?
Ja. Die Demo-Umgebung unter demo.desk4.net mit Swagger-Dokumentation eignet sich zum Ausprobieren, ohne Ihre Produktivdaten zu berühren. desk4 selbst testen Sie kostenlos, ohne Vertrag und ohne Zeitlimit.