MCP-Connector für Claude & ChatGPT

Verbinde Plantime mit Claude oder ChatGPT, um Dienstpläne zu lesen, Schichten zu planen und Stundenzettel im Gespräch zu verwalten.

Was der Plantime-MCP-Connector kann

Der Plantime-MCP-Server (Model Context Protocol) ermöglicht es KI-Assistenten wie Claude und ChatGPT, in deinem Auftrag mit deinem Plantime-Workspace zu arbeiten. Nach der Verbindung kannst du den Assistenten bitten:

  • Deinen Workspace lesen — Organisationen, Teams, Dienstpläne, Schichtstatistiken und Stundenzettel
  • Schichten planen — einzelne Schichten anlegen, Vorlagen über Zeiträume wiederholen, Wochen kopieren oder einen Zeitraum auf Basis des bisherigen Planungsrhythmus deines Teams füllen
  • Schichten besetzen — Teammitglieder zuweisen oder entfernen, vorgeschlagene Zuweisungen übernehmen oder verwerfen, oder den Auto-Planer offene Schichten anhand von Verfügbarkeit, Kompetenzen und Auslastung besetzen lassen
  • Stundenzettel verwalten — Stundenzettel auflisten, prüfen, genehmigen, ablehnen oder neu berechnen

Alles läuft über dein eigenes Plantime-Konto. Der Connector sieht und ändert nur, was du auch selbst kannst: Die meisten Planungswerkzeuge erfordern eine Manager-, Admin- oder Inhaberrolle im Team, und die Stundenzettel-Werkzeuge erlauben es Mitarbeitenden zusätzlich, ihre eigenen Stundenzettel einzusehen und zu genehmigen.

Einrichtung

Der Connector ist ein Remote-MCP-Server mit OAuth-Anmeldung — es muss nichts installiert werden.

Server-URL: https://www.plantime.io/api/mcp/v1

Claude (claude.ai und Claude Desktop)

  1. Öffne Einstellungen → Connectors (in einem bezahlten Claude-Plan)
  2. Wähle Benutzerdefinierten Connector hinzufügen
  3. Gib die obige Server-URL ein und bestätige
  4. Claude leitet dich zu Plantime weiter, wo du dich anmeldest und den Zugriff autorisierst
  5. Die Plantime-Werkzeuge stehen anschließend in deinen Unterhaltungen zur Verfügung

Claude Code

claude mcp add --transport http plantime https://www.plantime.io/api/mcp/v1

Führe danach /mcp in Claude Code aus, um die OAuth-Anmeldung abzuschließen.

ChatGPT

  1. Öffne Einstellungen → Apps & Connectors
  2. Wähle Erstellen (Entwicklermodus) oder füge die Plantime-App aus dem Verzeichnis hinzu, sobald sie veröffentlicht ist
  3. Gib die obige Server-URL ein, wähle OAuth als Authentifizierung und speichere
  4. Melde dich bei Plantime an, wenn du zur Autorisierung aufgefordert wirst

Beispiel-Prompts

  • „Welche Teams verwalte ich in Plantime?"
  • „Zeig mir den Dienstplan des Küchenteams für nächste Woche, inklusive Besetzung."
  • „Lege für nächsten Dienstag eine Barschicht von 16:00 bis 23:00 Uhr für zwei Personen an."
  • „Kopiere die Schichten dieser Woche in die nächsten zwei Wochen."
  • „Besetze automatisch alle offenen Schichten in der ersten Juliwoche."
  • „Zeig mir offene Stundenzettel und genehmige den von Maria, wenn die Stunden plausibel sind."

Datenzugriff und Sicherheit

  • Die Autorisierung läuft über OAuth: Du meldest dich direkt bei Plantime an, und der Assistent erhält ein begrenztes Zugriffstoken. Dein Plantime-Passwort wird nie an den Assistenten weitergegeben.
  • Alle Aktionen werden serverseitig gegen die Rollen deines Kontos geprüft — genau wie in der Plantime-Web-App.
  • Destruktive Aktionen sind konservativ ausgelegt: Das Löschen von Schichten ist ein Soft-Delete mit einem einstündigen Undo-Fenster (undo_delete_shifts), und genehmigte Stundenzettel können nicht neu berechnet werden.
  • Du kannst den Zugriff jederzeit widerrufen, indem du den Connector in Claude oder ChatGPT entfernst.

Fehlerbehebung

„Unauthenticated" oder 401-Fehler — deine Sitzung ist abgelaufen. Entferne den Connector und füge ihn neu hinzu, oder nutze die Neuverbinden-Option des Assistenten, um dich erneut anzumelden.

Der Assistent sieht ein Team oder eine Organisation nicht — der Connector zeigt nur Workspaces, denen dein Plantime-Konto angehört. Planungswerkzeuge erfordern zusätzlich eine Manager-, Admin- oder Inhaberrolle im jeweiligen Team.

Datumsbereiche verhalten sich unerwartet — bei den meisten Werkzeugen ist das Bereichsende exklusiv: Um den 15. Juni vollständig einzuschließen, gib den 16. Juni um 00:00 Uhr als Ende an. Datumsangaben werden als ISO-8601-Zeitstempel interpretiert.

Eine Löschung soll rückgängig gemacht werden — bitte den Assistenten, sie rückgängig zu machen. Löschungen liefern eine Undo-Referenz, die eine Stunde lang gültig ist. Danach lassen sich Schichten nur durch Neuanlegen wiederherstellen.

Werkzeuge werden angezeigt, aber Aufrufe schlagen fehl — prüfe zuerst, ob dein Plantime-Konto in der Web-App unter plantime.io funktioniert; der Connector hat exakt dieselben Berechtigungen.

Support

Wenn du nicht weiterkommst, schreib uns an support@plantime.io oder besuche die Support-Seite. Schick am besten den verwendeten Prompt und die Fehlermeldung des Assistenten mit — das reicht uns meist, um das Problem einzugrenzen.