API & MCP — Geschäftssysteme und KI-Assistenten anbinden
Der Bereich API & MCP öffnet jeCheck-Daten für andere Systeme und KI-Assistenten: ein ERP kann Audits abrufen und Aufgaben anlegen, BI baut Berichte, und Claude oder ChatGPT beantworten Fragen zu Ihrem Netz und bereiten Auswertungen vor. Es gelten dieselben Rechte wie im Web: Ein Schlüssel oder Assistent sieht nur, was er sehen darf.
Sie öffnen ihn über Verwaltung → API & MCP oder über das Profilmenü (Klick auf Ihren Namen unten im Seitenmenü). API und MCP sind im Enterprise-Tarif verfügbar.
Die technische Dokumentation für Entwickler – alle Endpunkte, Beispiele für Anfragen und Antworten, Fehler – finden Sie auf jecheck.io/developers (Englisch).
Was Sie anbinden können
- Buchhaltungs- und Personalsysteme – Audits, Stundenzettel und Gehälter exportieren, Mitarbeiter und Standorte synchronisieren, Aufgaben anlegen.
- BI (Power BI, Looker, Metabase) – Audits, Verstöße, Routine-Erfüllung und HACCP-Daten für eigene Berichte.
- Bots und Portale – Anleitungen anzeigen, Anfragen annehmen, an Aufgaben erinnern.
- KI-Assistenten (Claude, ChatGPT, Cursor u. a.) – über MCP findet der Assistent die Daten selbst und kann in Ihrem Namen Aufgaben anlegen.
Unternehmensschlüssel
Ein Unternehmensschlüssel ist für Integrationen gedacht, die ohne eine bestimmte Person laufen. Ihn stellt ein Mitarbeiter mit dem Recht API-Schlüssel des Unternehmens aus (Administratoren haben es).
- Öffnen Sie API & MCP → Unternehmensschlüssel und klicken Sie auf Neuer Schlüssel.
- Benennen Sie den Schlüssel nach dem System, das ihn nutzt, z. B. „ERP“ oder „Power BI“.
- Wählen Sie den Zugriff: Nur lesen oder Lesen & Schreiben.
- Markieren Sie die Rollen des Schlüssels – der Schlüssel erhält genau deren Rechte. Sie können nur Rollen vergeben, deren Rechte Sie selbst haben.
- Wählen Sie die Standorte – der Schlüssel sieht nur deren Daten (oder alle, auch neue).
- Legen Sie bei Bedarf ein Ablaufdatum fest und klicken Sie auf Erstellen.
- Kopieren Sie das Token – es wird nur einmal angezeigt. Geben Sie es dem Entwickler der Integration auf sicherem Weg.
Der Schlüssel handelt als Dienstbenutzer „API: Name“. Er kann sich weder im Web noch in der App anmelden; alles, was die Integration anlegt oder ändert, erscheint im Verlauf unter diesem Namen.
Vollzugriff (wie ein Administrator) kann nur ein Administrator vergeben. Nutzen Sie ihn nur, wenn die Integration wirklich alle Bereiche braucht.
Einen Schlüssel können Sie Bearbeiten – Name, Rollen, Standorte und Zugriff ändern, ohne das Token zu ersetzen – oder Widerrufen: Die Integration hört sofort auf zu funktionieren.
Persönliche Tokens
Ein persönliches Token arbeitet mit Ihren Rechten und eignet sich für Skripte, API-Tests und KI-Werkzeuge für Entwickler (Cursor, Claude Code, VS Code). Sie erstellen es im Tab Meine Tokens, wenn Sie das Recht Persönliche API-Tokens und KI-Apps haben. Geben Sie ein persönliches Token nicht weiter.
KI-Assistenten verbinden (MCP)
MCP ist ein offenes Protokoll, über das sich KI-Assistenten mit Diensten verbinden. Der Tab KI-Apps (MCP) zeigt die Server-URL und eine Schritt-für-Schritt-Anleitung.
Claude und ChatGPT verbinden sich ohne Token:
- Kopieren Sie die Server-URL.
- In Claude: Einstellungen → Konnektoren → Eigenen Konnektor hinzufügen. In ChatGPT: Einstellungen → Apps & Konnektoren → Erstellen.
- Fügen Sie die URL ein, klicken Sie auf Verbinden, melden Sie sich bei jeCheck an und erlauben Sie den Zugriff. Ohne Häkchen bei Änderungen erlauben darf der Assistent nur lesen.
Cursor, VS Code, Claude Code verbinden sich mit einem persönlichen Token – fertige Einstellungen zum Kopieren finden Sie im selben Tab.
Beispielfragen an den Assistenten:
- „Welche fünf Standorte haben im Küchen-Audit diesen Monat am schlechtesten abgeschnitten, und welche Verstöße wiederholen sich?“
- „Welche Aufgaben sind am Standort Dostyk überfällig? Gruppiere nach Verantwortlichen.“
- „Fehlen heute Einträge in den HACCP-Temperaturprotokollen?“
- „Wer ist gerade in der Zentralküche im Dienst?“
Verbundene Apps stehen unter Verbundene Apps; Trennen beendet ihren Zugriff sofort.
Aufrufprotokoll
Der Tab Aufrufprotokoll zeigt die letzten 100 Anfragen an API und MCP: Zeit, Schlüssel, Vorgang, Antwortcode und IP. Administratoren und Inhaber des Rechts „API-Schlüssel des Unternehmens“ sehen Aufrufe der Unternehmensschlüssel, jeder Mitarbeiter die seiner eigenen Tokens und Apps. Das Protokoll wird 30 Tage aufbewahrt. Ausstellen und Widerrufen von Schlüsseln wird im Zugriffsprotokoll unter „Rechte und Rollen“ festgehalten.
Sicherheit
- Legen Sie für jedes System einen eigenen Schlüssel mit minimalen Rollen und Standorten an – er lässt sich leichter einschränken und widerrufen.
- Wenn eine Integration nur liest, vergeben Sie Nur lesen.
- Legen Sie für vorübergehende Verbindungen ein Ablaufdatum fest.
- Widerrufen Sie ungenutzte Schlüssel. Wenn ein Token in falsche Hände geraten sein könnte, widerrufen Sie es sofort und erstellen ein neues.
Häufige Fragen
Warum liefern Anfragen den Fehler plan_required?
API und MCP gehören zum Enterprise-Tarif. Schlüssel können Sie vorab anlegen, Anfragen werden aber abgelehnt, bis das Unternehmen zu Enterprise wechselt.
Der Schlüssel sieht einen Teil der Daten nicht
Ein Schlüssel sieht nur die Daten seiner Rollen und Standorte – wie ein Mitarbeiter mit diesen Rechten im Web. Prüfen Sie Rollen und Standorte des Schlüssels oder die Rechte der Rollen unter „Rechte und Rollen“.
Funktioniert der alte Schlüssel des Anleitungs-Bots weiter?
Ja. Früher für den Wissensdatenbank-Bot ausgestellte Schlüssel funktionieren weiter mit den Anleitungen. Für andere Bereiche erstellen Sie einen neuen Schlüssel.
Vielen Dank! Das hilft uns, das Hilfe-Center zu verbessern.