PULT API & MCP (Beta): PULT mit KI-Tools und eigenen Systemen verbinden

Last updated: November 20, 2026

Mit der PULT API (Beta) kannst du die PULT-Daten deiner Organisation in deinen eigenen Tools auslesen – zum Beispiel in einem BI-Dashboard, eurem HR-System oder eigenen Reports. Über den PULT MCP-Server können KI-Assistenten wie Claude direkt auf dieselben Daten zugreifen. So kannst du einfach Fragen stellen wie „Wie viele Personen waren letzte Woche im Büro?“. In diesem Artikel erfährst du als Admin, welche Daten verfügbar sind und wie du dich verbindest – per Anmeldung mit deinem PULT-Konto (OAuth) oder mit einem API-Schlüssel.


📌 Bevor du startest: Du brauchst Admin-Rechte in PULT. Die API wird von PULT pro Organisation freigeschaltet – wenn du unter Einstellungen → Sicherheit keinen Punkt API-Schlüssel siehst, melde dich bei uns unter support@pult.com und wir schalten sie für euch frei.

📘 Technische Dokumentation: Alle Endpunkte, Parameter, Details zur Authentifizierung und Limits für Entwickler:innen: docs.pult.dev


Was du mit API und MCP machen kannst

Die API ist nur lesend: Du kannst Daten abrufen, aber nichts in PULT anlegen oder ändern. Diese Daten sind verfügbar:

Daten

Was du bekommst

Voraussetzung

Nutzer

Liste und einzelne Nutzer, Filter nach Status (aktiv, archiviert), Gruppe oder E-Mail

jedes PULT-Produkt

Gruppen

Liste und einzelne Gruppen

jedes PULT-Produkt

Offices

Liste und einzelne Offices, Filter nach Status

Workplace

Buchungen

Buchungen für einen Zeitraum von bis zu 31 Tagen, Filter nach Typ, Office, Gruppe oder bis zu 50 Nutzern

Workplace

Presence-Standorte

Liste und einzelne Standorte

Presence

Presence-Tage

Pro Person, Tag und Standort: wie die Person erkannt wurde (WiFi oder Desktop-Agent) sowie erste und letzte Erkennung – für bis zu 31 Tage

Presence

Anwesenheit pro Standort

Anzahl der Personen pro Standort und Tag – für bis zu 31 Tage

Presence

Besuche

Liste und einzelne Besuche

Visitor Management

Die API folgt denselben Datenschutzregeln wie dein PULT Dashboard:

  • Jeder API-Schlüssel und jede Verbindung sieht immer nur die Daten der eigenen Organisation.

  • Schlüssel und Verbindungen lesen mit den Rechten ihres Besitzers – sie sehen, was ein Admin in den Reports im Dashboard sieht.

  • Gäste sind nicht enthalten.

  • Buchungen und Presence-Daten enthalten nur Personen mit aktivem Seat.

  • Vergangene Buchungen und Presence-Daten archivierter Nutzer bleiben verfügbar – sie erscheinen in der Nutzerliste mit dem Status archiviert.

  • Wenn eure Organisation sensible Presence-Daten ausblendet, fehlen die Zeiten der ersten und letzten Erkennung.

  • Presence-Daten folgen der Aufbewahrungsfrist eurer Organisation.


1. KI-Tool mit deinem PULT-Konto verbinden (OAuth)

Das ist der einfachste Weg: Du brauchst keinen API-Schlüssel – du meldest dich mit deinem PULT-Konto an und bestätigst die Verbindung.

  1. Füge PULT in deinem KI-Tool als eigenen Connector hinzu. In Claude gehst du dafür z. B. zu Einstellungen → Konnektoren und fügst einen benutzerdefinierten Konnektor hinzu.

  2. Name: PULT, Server-URL: https://api.pult.com/v1beta/mcp

  3. Wenn dein Tool nach der Authentifizierung fragt, wähle OAuth. Wenn es anbietet, den Resource-Parameter mitzuschicken, lass das aktiviert.

  4. Klicke auf Verbinden. PULT öffnet sich in deinem Browser – melde dich an und bestätige die Verbindung.

Nach dem Verbinden sieht dein KI-Tool alle PULT-Daten aus der Tabelle oben als Tools, die nur lesen. Probier zum Beispiel diese Fragen:

  • „Welche Offices haben wir in PULT?“

  • „Wer hat nächsten Montag einen Arbeitsplatz in unserem Hamburger Office gebucht?“

  • „Wie viele Personen waren letzte Woche pro Tag im Büro?“

  • „Wer war diesen Monat weniger als drei Tage pro Woche im Büro?“

📌 Geteilte KI-Workspaces (z. B. Claude Team oder Enterprise, ChatGPT-Workspaces): Ein Workspace-Owner fügt den PULT-Connector einmal für den ganzen Workspace hinzu. Danach verbindet ihn jede Person mit ihrem eigenen PULT-Konto. Jede Verbindung liest mit den Rechten der Person, die sie verbunden hat – niemand muss einen API-Schlüssel teilen.

📌 Welche KI-Tools funktionieren? OAuth ist mit Claude und ChatGPT getestet und sollte auch mit Claude Code, Cursor, VS Code und Langdock funktionieren. Auch Microsoft 365 Copilot verbindet sich per OAuth. Gemini Enterprise wird noch nicht unterstützt. Tools ohne OAuth (z. B. Copilot Studio, n8n oder Le Chat) verbindest du mit einem API-Schlüssel – siehe Schritt 2 bis 4. Die Liste pro Tool findest du in der MCP-Dokumentation.


2. Seite „API-Schlüssel“ öffnen

Gehe im PULT Dashboard zu Einstellungen → Sicherheit → API-Schlüssel. Falls der Bereich Verbinden eingeklappt ist, klicke auf Einblenden.

  1. API-Schlüssel erstellen: Erstellt einen neuen Schlüssel (siehe Schritt 3).

  2. REST API: Die Basis-URL für eure eigenen Integrationen: https://api.pult.com/v1beta

  3. OpenAPI-Dokument: Die technische Beschreibung aller Endpunkte. Sie ist öffentlich, ohne Schlüssel – eure Entwickler:innen können damit Client-Code generieren.

  4. MCP server: Die Adresse für KI-Tools: https://api.pult.com/v1beta/mcp

  5. Authentifizierung: So wird der Schlüssel mitgeschickt – für REST und MCP im Header Authorization: Bearer <dein API-Schlüssel>. Schlüssel in einer URL werden nie akzeptiert.


3. API-Schlüssel erstellen

Klicke auf API-Schlüssel erstellen.

  1. Name: Gib dem Schlüssel einen Namen, an dem du erkennst, wo du ihn nutzt, z. B. „Claude“ oder „Power BI“.

  2. Läuft ab nach: Wähle 30 Tage, 90 Tage, 1 Jahr oder ein eigenes Datum. Kürzere Laufzeiten begrenzen den Schaden, falls ein Schlüssel öffentlich wird.

  3. Klicke auf Schlüssel erstellen.

Dein neuer Schlüssel wird angezeigt:

  1. Kopieren kopiert nur den Schlüssel, Als Header kopieren kopiert ihn direkt im Format Authorization: Bearer ….

  2. Klicke auf Fertig.

⚠ Kopiere den Schlüssel sofort. Du kannst ihn danach nicht mehr sehen. Behandle ihn wie ein Passwort: Wer ihn hat, kann die Daten deiner Organisation mit deinen Admin-Rechten lesen – auch in geteilten KI-Workspaces und Workflow-Tools.


4. KI-Tool mit API-Schlüssel verbinden

Nutze diesen Weg, wenn dein KI-Tool kein OAuth unterstützt, oder für Automatisierungen. Füge PULT als eigenen Connector bzw. MCP-Server hinzu:

  1. Server-URL: https://api.pult.com/v1beta/mcp (Streamable HTTP)

  2. Authentifizierung: Schicke deinen API-Schlüssel im Authorization-Header als Bearer <dein API-Schlüssel>. Am einfachsten nutzt du dafür Als Header kopieren aus Schritt 3. Manche Tools ergänzen Bearer selbst – dann fügst du nur den Schlüssel ein.

⚠ Erstelle für jedes Tool einen eigenen Schlüssel, damit du einen widerrufen kannst, ohne die anderen zu betreffen. In einem geteilten KI-Workspace nutzen alle denselben Schlüssel mit deinen Admin-Rechten – nutze dort besser OAuth (Schritt 1).


5. REST API nutzen

Für eure eigenen Integrationen schickst du Anfragen an die Basis-URL mit deinem Schlüssel im Authorization-Header, zum Beispiel:

curl -H "Authorization: Bearer DEIN_API_SCHLUESSEL" https://api.pult.com/v1beta/offices
  • Dokumentation: Alle Endpunkte und Parameter findest du unter docs.pult.dev/api und im OpenAPI-Dokument (Nummer 3 in Schritt 2).

  • Seiten: Listen werden seitenweise mit einem Cursor geliefert, 1 bis 500 Einträge pro Seite (Standard 100).

  • Limit: Während der Beta bis zu 600 Anfragen pro Minute pro Schlüssel oder Verbindung und 1.200 pro Organisation (REST und MCP zusammen). Wenn du darüber liegst, bekommst du den Status 429 und einen Retry-After-Header.

  • Fehler: Jede Antwort enthält eine Request-Id. Bitte schick sie mit, wenn du dich wegen eines Fehlers beim Support meldest.


6. Schlüssel und Verbindungen verwalten

Alle Schlüssel eurer Organisation stehen unter dem Bereich Verbinden.

  1. Status: Zeigt, ob der Schlüssel aktiv oder widerrufen ist.

  2. Zuletzt verwendet: Zeigt, wann der Schlüssel zuletzt genutzt wurde – so findest du Schlüssel, die niemand mehr braucht.

  3. Widerrufen: Deaktiviert den Schlüssel.

  1. Bestätige mit Schlüssel widerrufen. Jedes Tool, das diesen Schlüssel nutzt, verliert sofort den Zugriff. Das kann nicht rückgängig gemacht werden.

Ein Schlüssel funktioniert außerdem automatisch nicht mehr, wenn er abläuft, wenn die API für eure Organisation deaktiviert wird oder wenn sein Besitzer archiviert wird oder kein Admin mehr ist.

OAuth-Verbindungen: Deine eigenen Verbindungen siehst und widerrufst du in der PULT WebApp unter Einstellungen → Verbindungen. Admins sehen alle Verbindungen der Organisation im Dashboard unter Einstellungen → Sicherheit → Verbindungen. Eine Verbindung endet automatisch nach 90 Tagen ohne Nutzung oder wenn ihr Besitzer archiviert wird, und sie pausiert, solange ihr Besitzer kein Admin ist.


Häufige Fragen

Kann ich über die API Buchungen anlegen oder ändern?

Noch nicht. Die Beta ist nur lesend – du kannst keine Buchungen, Nutzer oder andere Daten anlegen oder ändern. Aktionen wie das Buchen oder Freigeben eines Arbeitsplatzes sind für eine spätere Version geplant.

Wer kann sich verbinden und welche Daten sind sichtbar?

Nur Admins können API-Schlüssel erstellen und KI-Tools verbinden. Schlüssel und Verbindungen lesen mit den Rechten ihres Besitzers und unter Berücksichtigung der Datenschutzeinstellungen eurer Organisation. Mit OAuth nutzt jeder Admin seine eigene Verbindung – so musst du keinen Schlüssel teilen. Den Zugriff auf bestimmte Daten zu beschränken, ist noch nicht möglich.

Ich habe meinen API-Schlüssel verloren. Kann ich ihn noch einmal sehen?

Nein, ein Schlüssel wird nur einmal angezeigt. Erstelle einen neuen Schlüssel und widerrufe den alten.

Unsere Integration funktioniert nicht mehr. Was ist passiert?

Prüfe auf der Seite „API-Schlüssel“ den Status und das Ablaufdatum des Schlüssels. Schlüssel funktionieren auch nicht mehr, wenn der Besitzer archiviert wird oder kein Admin mehr ist – dann erstellt ein anderer Admin einen neuen Schlüssel. Bei OAuth-Verbindungen verbindest du PULT in deinem KI-Tool einfach neu.

Kann ich ChatGPT verbinden?

Ja. ChatGPT verbindet sich über OAuth: Füge PULT als eigenen Connector mit der Server-URL hinzu und melde dich mit deinem PULT-Konto an (Schritt 1). Ob du eigene Connectoren hinzufügen kannst, hängt von deinem ChatGPT-Tarif ab.

Wird sich die API noch ändern?

Möglicherweise. Die Beta-Version v1beta kann sich bis zur stabilen Version noch ändern. Wir ergänzen regelmäßig neue Daten und Funktionen – sag uns unter support@pult.com, was dir fehlt.


Ähnliche Artikel


Wenn du Fragen hast, melde dich gerne bei unserem Support-Team unter support@pult.com.