SimpliServDocs

API-Zugriff & externe Apps

Mitarbeiter API-Zugriff einrichten: API-Schlüssel ausstellen und KI-Clients per MCP-Connector über OAuth anbinden

→ API-Zugriff in SimpliServ öffnen

Wenn du SimpliServ mit eigenen Skripten, externen Diensten oder einem KI-Client wie Claude verbinden willst, brauchst du Zugangsdaten, die unabhängig von deinem persönlichen Login funktionieren. SimpliServ kennt dafür zwei Wege: API-Schlüssel (Bearer-Token für die REST-API) und den MCP Connector (OAuth-Verbindung für KI-Clients). Beide findest du unter Administration → Daten & Geräte → Integrationen als Kacheln auf der Seite Konnektoren. Für die Seite brauchst du Administration → Einstellungen → Ansehen.

API-Zugriff steuert Maschinen-Zugriff. Wen du als Person einlädst und welche Rollen es gibt, regelst du unter Benutzer & Rollen. API-Schlüssel und MCP-Verbindungen greifen auf genau dieselben Rollen zurück.

Wo du den Zugriff findest

Die Seite Konnektoren zeigt Kacheln für alle verfügbaren Verbindungen, getrennt nach Aktiv und Verfügbar. Über die Kategorie Entwickler oder die Suche findest du die zwei relevanten Kacheln:

  • API Keys — stellt Bearer-Token für die REST-API aus, z. B. für eigene Tools, Webhooks oder Server-zu-Server-Integrationen.
  • MCP Connector — verbindet MCP-kompatible KI-Clients (Claude Desktop, Claude (Web), ChatGPT, Cursor u. a.) per OAuth mit deinem Arbeitsbereich.

Klick auf eine Kachel, um sie zu öffnen. Jede Kachel hat die Tabs Installation, Konfiguration und Berechtigungen; ist die Verbindung bereits aktiv, kommt der Tab Übersicht hinzu. Angelegt und verwaltet wird jeweils im Tab Konfiguration.

API-Schlüssel erstellen

Ein API-Schlüssel ist ein Token, das im Hintergrund mit einem eigenen Service-Konto verknüpft wird. Dieses Konto bekommt die Rollen, die du auswählst — der Schlüssel kann also genau das, was diese Rollen erlauben, und nicht mehr.

Konfiguration öffnen

Öffne die Kachel API Keys und wechsle in den Tab Konfiguration. Du siehst die Tabelle bestehender Schlüssel mit den Spalten Name, Rollen, Zuletzt verwendet, Läuft ab und Erstellt. Klick auf Neue Integrierung.

Schlüssel benennen und Rollen zuweisen

Fülle das Formular aus:

  • Name (Pflicht) — z. B. der Name deines Tools oder der externen App.
  • Beschreibung — optionaler Freitext, wofür der Schlüssel gedacht ist.
  • Rollen (Pflicht, mehrere möglich) — bestimmt die Berechtigungen des Schlüssels.
  • Läuft ab am — optionales Ablaufdatum; leer lassen für keine Ablaufzeit.
  • Deaktiviert — schaltet den Schlüssel ab, ohne ihn zu entfernen.

Du kannst einem Schlüssel nur Rollen geben, deren Berechtigungen du selbst besitzt. Wählst du eine Rolle mit weitergehenden Rechten, lehnt SimpliServ das Speichern ab.

Token kopieren

Nach dem Speichern zeigt SimpliServ das Token genau einmal an. Kopiere es sofort über die Schaltfläche Token kopieren und hinterlege es sicher in deiner Anwendung — danach lässt es sich nicht mehr einsehen. Geht es verloren, deaktiviere den alten Schlüssel und lege einen neuen an.

Bestehende Schlüssel kannst du jederzeit per Klick auf die Tabellenzeile bearbeiten: Rollen ändern, Ablaufdatum anpassen oder über den Schalter Deaktiviert abschalten. Ein deaktivierter Schlüssel wird in der Tabelle neben dem Namen mit dem roten Badge Deaktiviert markiert.

Mit dem Token gegen die API arbeiten

Sende das Token als Bearer-Token im Authorization-Header jeder Anfrage:

Authorization: Bearer <dein-token>

Welche Endpunkte verfügbar sind, welche Felder sie erwarten und welche Filter sie unterstützen, steht in der API-Referenz.

API-Referenz

Vollständige Endpunkt-Dokumentation der REST-API.

WordPress-Plugin

Fertige Integration, die einen API-Schlüssel nutzt.

KI-Clients per MCP verbinden

Der MCP Connector stellt deinen Arbeitsbereich als MCP-Server unter /api/v1/mcp bereit. KI-Clients verbinden sich darüber per OAuth 2.1 mit PKCE — du brauchst dafür kein manuell ausgestelltes Token. Eine ausführliche Anleitung für die einzelnen Clients findest du unter MCP.

Server im Client hinterlegen

Füge im MCP-Client einen neuen Server mit der URL https://<deine-domain>/api/v1/mcp hinzu und wähle OAuth als Authentifizierungsmethode. Der Tab Installation der MCP-Kachel zeigt fertige Anleitungen für Claude Desktop, Claude (Web), ChatGPT, Cursor und weitere Clients.

Zustimmung erteilen

Beim ersten Verbinden leitet der Client auf den Consent-Screen (/oauth/consent) weiter. Bist du dort noch nicht angemeldet, meldest du dich zuerst mit deinem Workspace-Benutzer an. Der Bildschirm zeigt den anfragenden Client, dessen Client-ID, die Weiterleitung und die Berechtigungen, die er erhält. Bestätige mit Erlauben oder lehne mit Ablehnen ab.

Clients verwalten

Im Tab Konfiguration der MCP-Kachel listet Autorisierte OAuth-Clients jeden verbundenen Client mit den Spalten Client, Erstmalig autorisiert, Zuletzt verwendet und Läuft ab. Über Widerrufen trennst du einen Client sofort und entwertest alle ausgegebenen Access-Tokens.

Eine MCP-Verbindung erbt die Arbeitsbereichsrollen, die bei der Anmeldung gelten. Jeden Schreibvorgang bestätigt der Client vor der Ausführung, und du kannst die Verbindung jederzeit aus der Liste widerrufen.

Sicherheit

  • Tokens sind so mächtig wie ihre Rollen. Vergib pro Integration eine eigene, möglichst eng zugeschnittene Rolle statt eines Allzweck-Schlüssels.
  • Setze ein Ablaufdatum, wenn ein Zugriff nur befristet gebraucht wird.
  • Sperre sofort, wenn ein Token oder Client kompromittiert sein könnte — deaktiviere den API-Schlüssel bzw. widerrufe den OAuth-Client.
  • Bewahre Tokens nie im Klartext in Repositories oder geteilten Dokumenten auf.

Weitere organisationsweite Schutzmaßnahmen findest du unter Sicherheitseinstellungen.

Verwandte Themen

How is this guide?

On this page

Wo du den Zugriff findestAPI-Schlüssel erstellenKonfiguration öffnenSchlüssel benennen und Rollen zuweisenToken kopierenMit dem Token gegen die API arbeitenKI-Clients per MCP verbindenServer im Client hinterlegenZustimmung erteilenClients verwaltenSicherheitVerwandte Themen