Dokumentation

Stunden-MCP-Connector

Diese Seite beschreibt den Connector zwischen Stunden und Claude: was er kann, wie Sie ihn verbinden, welche Daten er verarbeitet und wie Sie den Zugriff beenden.

Was der Connector kann

Der Connector gibt Claude über das Model Context Protocol (MCP) Zugriff auf einen Stunden-Betrieb. Er stellt 104 Tools bereit. Je nach erteilten Berechtigungen kann Claude Daten lesen und Datensätze anlegen oder ändern, zum Beispiel eine Rechnung erstellen oder Stunden erfassen. Änderungen über ein Tool wirken in Stunden sofort.

Server-URL	`https://mcp.stunden.ch/mcp`
Transport	Streamable HTTP
Authentifizierung	OAuth 2.0 Authorization Code Flow mit PKCE (S256), Scope mcp:tools
Zugriffsbereich	Ein Stunden-Betrieb pro Verbindung
Voraussetzungen	Ein Stunden-Konto, das Mitglied des Betriebs ist, und ein Claude-Client, der einen Remote-MCP-Connector hinzufügen kann

In Claude verbinden

Öffnen Sie in Claude die Connector-Einstellungen und fügen Sie einen benutzerdefinierten Connector mit der URL https://mcp.stunden.ch/mcp hinzu.
Claude leitet Sie zu Stunden weiter. Melden Sie sich mit Ihrem Stunden-Konto an.
Wenn Sie zu mehreren Betrieben gehören, wählen Sie den Betrieb, für den dieser Zugriff gilt.
Wählen Sie die Berechtigungen aus und bestätigen Sie. Stunden bietet nur Berechtigungen an, die Ihre Rolle in diesem Betrieb erlaubt.
Stunden leitet Sie zurück zu Claude, und die Tools stehen bereit.

Jede Person hat pro Betrieb ein Connector-Token. Eine erneute Verbindung für denselben Betrieb ersetzt dessen Secret und Berechtigungen, das bisherige Token funktioniert danach nicht mehr.

Berechtigungen

Sie wählen die Berechtigungen auf der Zustimmungsseite von Stunden. Ein Tool funktioniert nur, wenn das Token die zugehörige Berechtigung hat. Ein Tool ohne Berechtigung bleibt in Claude sichtbar und antwortet mit einem Fehler.

Stunden prüft Ihre Mitgliedschaft im Betrieb bei jeder API-Anfrage und die Berechtigungen bei jeder Token-Erneuerung gegen Ihre aktuelle Rolle. Berechtigungen, die Ihre Rolle nicht mehr erlaubt, werden vom Token entfernt. Bleibt keine übrig, wird das Token gelöscht.

Module mit Lizenz brauchen zusätzlich eine aktive Lizenz im Betrieb. Erteilen Sie nur, was Claude nutzen soll: Für Auswertungen genügen Leseberechtigungen.

Rechnungsstellung (Lizenz: Rechnungsstellung)

Berechtigung	Zugriff
Kunden und Adressen lesen, Schweizer Handelsregister durchsuchen	Lesen
Kunden anlegen und ändern	Schreiben
Rechnungen, Status und PDFs lesen	Lesen
Rechnungen anlegen, ändern und versenden	Schreiben
Gutschriften und PDFs lesen	Lesen
Mahnungen und PDFs lesen	Lesen
Offerten und PDFs lesen	Lesen
Offerten anlegen, ändern und versenden	Schreiben
Produkte und Kategorien lesen	Lesen
Produkte anlegen und ändern	Schreiben
Inventarbewertung lesen	Lesen
MWST-Einträge lesen	Lesen
Nicht verrechnete Stunden und Spesen lesen	Lesen

Wiederkehrende Rechnungen (Lizenz: Abo-Rechnungen)

Berechtigung	Zugriff
Wiederkehrende Rechnungen lesen	Lesen
Wiederkehrende Rechnungen anlegen, ändern, pausieren und fortsetzen	Schreiben

Spesenverwaltung (Lizenz: Spesenverwaltung)

Berechtigung	Zugriff
Ausgaben, Belege und Kategorien lesen	Lesen
Ausgaben anlegen	Schreiben
Kreditoren lesen	Lesen

Projekte (Lizenz: Projekte)

Berechtigung	Zugriff
Projekte lesen	Lesen
Projekte anlegen und ändern	Schreiben
Aufgaben lesen	Lesen
Aufgaben anlegen und ändern	Schreiben

Zeiterfassung (Lizenz: Zeiterfassung)

Berechtigung	Zugriff
Zeiteinträge lesen	Lesen
Zeiteinträge anlegen	Schreiben

Schichtplanung (Lizenz: Schichtplanung)

Berechtigung	Zugriff
Schichten lesen	Lesen
Schichten anlegen	Schreiben

Urlaub & Abwesenheit (Lizenz: Urlaub & Abwesenheit)

Berechtigung	Zugriff
Urlaubsanträge und Ferienguthaben lesen	Lesen
Urlaubsanträge anlegen, genehmigen, ablehnen, zurückziehen und stornieren	Schreiben
Krankmeldungen lesen	Lesen
Krankmeldungen anlegen und abschliessen	Schreiben

Inventar (Lizenz: Inventar)

Berechtigung	Zugriff
Inventar und Zuweisungen lesen	Lesen
Inventar anlegen, ändern, zuweisen und löschen	Schreiben

Plattform (keine Lizenz nötig)

Berechtigung	Zugriff
Mitarbeiterdaten lesen, einschliesslich AHV-Nummer, Geburtsdatum und Adresse	Lesen
Mitarbeitende anlegen und ändern (IBAN, AHV-Nummer und Passwort lassen sich nicht setzen)	Schreiben
Geschäftsauswertungen und Berichte lesen	Lesen
Wiki-Seiten lesen	Lesen
Wiki-Seiten anlegen, ändern und löschen	Schreiben
Webhook-Abonnements lesen (von keinem Connector-Tool verwendet)	Lesen
Webhook-Abonnements anlegen und löschen (von keinem Connector-Tool verwendet)	Schreiben
Help-Center-Artikel lesen	Lesen

Lohnabrechnung (Lizenz: Lohnabrechnung)

Berechtigung	Zugriff
Abgeschlossene Lohnläufe und Lohnabrechnungen lesen	Lesen
Lohn berechnen (von keinem Connector-Tool verwendet)	Schreiben

Kasse (Lizenz: Kasse)

Berechtigung	Zugriff
Kassentransaktionen, Tagesabschlüsse, Belege und Kassen lesen	Lesen

Tools

Jedes Tool trägt MCP-Annotationen, die es als lesend, schreibend oder destruktiv kennzeichnen. Wie ein Client sie nutzt, zum Beispiel für eine Rückfrage vor der Ausführung, entscheidet der Client.

Bereich	Tools
Konto und Help Center (4)	`whoami, list_kb_categories, search_kb_articles, get_kb_article`
Kunden (5)	`list_clients, get_client, create_client, update_client, search_company`
Rechnungen und nicht verrechnete Leistungen (9)	`list_invoices, list_open_invoices, get_invoice, get_invoice_pdf, create_invoice, update_invoice, send_invoice, get_unbilled_overview, get_unbilled_by_client`
Wiederkehrende Rechnungen (6)	`list_recurring_invoices, get_recurring_invoice, create_recurring_invoice, update_recurring_invoice, pause_recurring_invoice, resume_recurring_invoice`
Offerten (6)	`list_offers, get_offer, get_offer_pdf, create_offer, update_offer, send_offer`
Gutschriften und Mahnungen (5)	`list_credit_notes, get_credit_note, get_credit_note_pdf, list_dunning, get_dunning_pdf`
Produkte (5)	`list_products, get_product, list_product_categories, create_product, update_product`
Ausgaben und Kreditoren (6)	`list_expenses, get_expense, get_expense_receipt, list_expense_categories, create_expense, list_payables`
MWST (1)	`list_vat_entries`
Mitarbeitende (4)	`list_employees, get_employee, create_employee, update_employee`
Projekte und Aufgaben (9)	`list_projects, get_project, create_project, update_project, add_project_member, remove_project_member, list_tasks, create_task, update_task`
Zeiterfassung (5)	`list_time_entries, create_time_entry, create_time_entries, update_time_entry, get_missing_time`
Urlaub und Krankheit (11)	`list_leave_requests, list_absence_types, get_vacation_balance, get_vacation_history, create_leave_request, approve_leave_request, withdraw_leave_request, request_leave_cancellation, list_sick_leaves, create_sick_leave, close_sick_leave`
Schichten (2)	`list_shifts, create_shift`
Lohn (2)	`list_completed_payrolls, get_payslips`
Kasse (3)	`list_pos_transactions, list_pos_checks, list_cash_registers`
Inventar (9)	`list_assets, get_asset, create_asset, update_asset, delete_asset, assign_asset, unassign_asset, change_asset_status, get_inventory_valuation`
Wiki (5)	`list_wiki_pages, get_wiki_page, create_wiki_page, update_wiki_page, delete_wiki_page`
Auswertungen (7)	`get_business_health, get_employee_productivity, get_revenue_summary, get_project_profitability, get_utilization_report, get_overdue_overview, get_time_report`

Diese Tools haben eine Wirkung, die sich nicht rückgängig machen lässt: Daten werden gelöscht, eine E-Mail verlässt das System, oder eine externe Integration muss nachträglich angepasst werden.

send_invoice, send_offer, delete_asset, delete_wiki_page, remove_project_member

Beispiel-Prompts

Gib mir einen Überblick über mein Unternehmen.
Zeig mir alle unbezahlten Rechnungen.
Erstelle eine Rechnung für Müller AG: 10 Stunden Beratung zu CHF 180.
Welche Projekte sind dieses Jahr profitabel?
Wie ist die Auslastung meines Teams in diesem Monat?
Erstelle eine Aufgabe für Tom: Logo-Redesign bis Freitag fertigstellen.
Erfasse heute 3 Stunden auf Projekt Alpha.
Ist Sarah nächste Woche in den Ferien?

Datenfluss und Protokollierung

Ihr Claude-Client sendet den Tool-Aufruf mit Ihrem Token an den Bridge-Server unter mcp.stunden.ch.
Die Bridge prüft das Token bei Stunden und ruft die Stunden-API mit demselben Token auf.
Stunden prüft Token, Ihre Mitgliedschaft im Betrieb und die Berechtigung und antwortet.
Die Bridge entfernt einige interne Felder und gibt das Ergebnis an Ihren Claude-Client zurück.

Tool-Ergebnisse verlassen Stunden. Sie gehen an den Claude-Client der Person, die verbunden hat, und damit an Anthropic in den USA, das sie unter dem Claude-Konto und den Bedingungen dieser Person verarbeitet. Stunden hat auf diese Verarbeitung keinen Einfluss. Gehen Sie nicht davon aus, dass sie in der Schweiz stattfindet.

Ergebnisse können Personendaten enthalten. get_employee liefert den vollständigen Datensatz einer Person, einschliesslich AHV-Nummer, Geburtsdatum und Adresse sowie Lohn- und Steuerdaten, soweit Ihre Rolle sie sehen darf. list_employees liefert einen reduzierten Datensatz. IBANs sind nicht Teil der Mitarbeiter-API. Erteilen Sie Mitarbeiter- und Lohnberechtigungen nur, wenn diese Daten an Claude gehen dürfen.

Die Bridge hat keine Datenbank. Sie speichert weder Tokens noch Tool-Ergebnisse und bearbeitet jede Anfrage mit einer neuen Server-Instanz.

Was die Bridge protokolliert

Die Bridge schreibt diese Einträge in ihr Dienstprotokoll:

Ereignis	Protokolliert
Erfolgreicher Tool-Aufruf	Kein Eintrag.
Fehlgeschlagener Tool-Aufruf	Tool-Name und Fehlertext. Tool-Argumente werden nicht als solche protokolliert, der Fehlertext kann aber Validierungsdetails wiederholen.
Abgelehnter oder fehlgeschlagener Stunden-API-Aufruf	Zusätzlich die Anfrage-URL, der HTTP-Status und die ersten 1000 Zeichen der Antwort. Die URL enthält Pfad und Query-String, IDs und Filterwerte eines fehlgeschlagenen Lesezugriffs erscheinen also im Protokoll, und die Antwort kann Geschäftsdaten enthalten.
Unerwarteter Fehler in der Bridge	Die Fehlermeldung mit technischen Details.
Anmeldung und Token-Prüfung	Die Datensatznummer des Tokens, im Fehlerfall ausserdem HTTP-Status und Antwort von Stunden. Das Token-Secret wird nie protokolliert.

Dies beschreibt die Anwendungsprotokollierung der Bridge. Zugriffsprotokolle der vorgelagerten Webserver sind hier nicht erfasst. Stunden selbst protokolliert die technischen Parameter jeder OAuth-Anfrage, etwa Client-ID und Weiterleitungs-URL, aber keine Tokens oder Autorisierungscodes.

Token-Lebensdauer

Autorisierungscode	10 Minuten gültig, einmal verwendbar.
Access-Token	Ein Jahr gültig. Jede Erneuerung stellt ein neues Token mit einem neuen Jahr aus; ein abgelaufenes Token funktioniert nicht mehr.
Refresh-Token	30 Tage gültig und bei jeder Verwendung ersetzt. Jede Erneuerung stellt auch ein neues Access-Token aus und löscht das alte.
Austritt aus einem Betrieb	Verlässt eine Person einen Betrieb oder wird sie archiviert, werden ihre Tokens für diesen Betrieb gelöscht.

Zugriff widerrufen

Eigene Verbindungen: Öffnen Sie in Stunden Ich > Meine Verbindungen und widerrufen Sie die Verbindung.
Administratoren: Organisation > Integrationen listet alle API-Tokens des Betriebs auf, und wer die Berechtigung organization.manage hat, kann sie widerrufen.
Clients: Der OAuth-Widerrufs-Endpunkt akzeptiert das Access-Token oder das Refresh-Token.

Ein Widerruf löscht das Token. Die Bridge prüft das Token bei jeder Anfrage, der nächste Tool-Aufruf schlägt also fehl, und auch das Refresh-Token wird abgelehnt. Um den Connector wieder zu nutzen, verbinden Sie ihn neu.

Den Connector in Claude zu entfernen, ändert nur Claude. Um sicherzugehen, dass der Zugriff beendet ist, widerrufen Sie die Verbindung auch in Stunden.

Fehlerbehebung

Problem	Lösung
Ein Tool schlägt mit einem Berechtigungsfehler fehl	Dem Token fehlt die Berechtigung. Verbinden Sie neu und wählen Sie sie aus. Wird sie nicht angeboten, erlaubt Ihre Rolle sie nicht, oder es ist eines der unter Tools aufgeführten Tools, deren Berechtigung die Zustimmungsseite nicht anbietet.
This endpoint requires a license for: …	Dem Betrieb oder Ihrem Benutzer fehlt die Lizenz für dieses Modul. Ein Administrator kann sie in Stunden zuweisen.
Your membership in this business has ended	Die Person, die verbunden hat, gehört nicht mehr zum Betrieb. Verbinden Sie mit einem aktiven Konto.
Claude verlangt eine neue Verbindung	Das Token wurde widerrufen, ersetzt oder entfernt, oder das Refresh-Token ist nach 30 Tagen ohne Nutzung abgelaufen. Verbinden Sie neu.
Die Zustimmungsseite zeigt nur wenige Berechtigungen	Es erscheinen nur Berechtigungen, die Ihre Rolle im gewählten Betrieb erlaubt. Bitten Sie einen Administrator, Ihre Rolle anzupassen, oder lassen Sie eine Person mit passender Rolle verbinden.
Claude arbeitet im falschen Betrieb	Eine Verbindung gilt für einen Betrieb. Verbinden Sie neu und wählen Sie den anderen Betrieb.
Die Zustimmungsseite antwortet mit invalid_client oder invalid_request	Der Client ist bei Stunden nicht registriert. Verbindungen funktionieren von Clients, deren Weiterleitungs-URL registriert ist, etwa claude.ai.

Support

Bei Fragen zum Connector erreichen Sie den Stunden-Support. Nennen Sie uns den Tool-Namen und den Zeitpunkt des Fehlers. Senden Sie nie Ihr Token.