# API & MCP — Geschäftssysteme und KI-Assistenten anbinden

> API-Schlüssel des Unternehmens, persönliche Tokens, Claude, ChatGPT und Cursor per MCP mit jeCheck verbinden, Aufrufprotokoll und Sicherheit.

Источник: https://jecheck.io/de/docs/account/api-mcp

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](https://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).

1. Öffnen Sie **API & MCP → Unternehmensschlüssel** und klicken Sie auf **Neuer Schlüssel**.
2. Benennen Sie den Schlüssel nach dem System, das ihn nutzt, z. B. „ERP“ oder „Power BI“.
3. Wählen Sie den **Zugriff**: **Nur lesen** oder **Lesen & Schreiben**.
4. 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.
5. Wählen Sie die **Standorte** – der Schlüssel sieht nur deren Daten (oder alle, auch neue).
6. Legen Sie bei Bedarf ein Ablaufdatum fest und klicken Sie auf **Erstellen**.
7. 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:

1. Kopieren Sie die **Server-URL**.
2. In Claude: **Einstellungen → Konnektoren → Eigenen Konnektor hinzufügen**. In ChatGPT: **Einstellungen → Apps & Konnektoren → Erstellen**.
3. 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.