# Unterweisungsmappe

> Arbeitsschutz für kleine Betriebe: Gefährdungsbeurteilung aus Branchenvorlagen der Unfallversicherungsträger, Unterweisung je Beschäftigtem mit Verständnisfragen am Handy, Nachgespräch, Fristen und Nachweis-PDF. Bedienung über einen MCP-Connector (Claude und andere Agenten).

## MCP server

- Endpoint: `https://unterweisungsmappe.de/mcp`, Streamable HTTP, stateless. Sign-in with OAuth 2.1: authorization code with PKCE, Client ID Metadata Documents or dynamic client registration, refresh tokens. Discovery: `/.well-known/oauth-protected-resource/mcp` and `/.well-known/oauth-authorization-server`.
- Claude: Settings > Connectors > Add custom connector, URL `https://unterweisungsmappe.de/mcp`. Claude Code: `claude mcp add --transport http unterweisung https://unterweisungsmappe.de/mcp`.
- On connecting, the user signs in (or creates an account) and picks the business. Free test: business, employees, risk assessment with PDF, briefings for up to two people, without proof. One-time purchase per business (149 € plus VAT, no subscription): all employees, deadlines, proof PDF.

### Tools

- `unterweisung_start` (read): Get started
- `unterweisung_betrieb_speichern` (write): Save business
- `unterweisung_beschaeftigte_speichern` (write): Save employees
- `unterweisung_gbu_erstellen` (write): Create risk assessment
- `unterweisung_gbu_anzeigen` (read): Show risk assessment
- `unterweisung_unterweisen` (write): Send briefings
- `unterweisung_neuer_link` (write): New briefing link
- `unterweisung_nachgespraech` (write): Record follow-up talk
- `unterweisung_fristen` (read): Deadlines and proof

## Legal frame

- A purely digital self-study is not a complete safety briefing (DGUV Regel 100-001, 2.3.1). The briefing counts as done only after the employee confirmed and the responsible person recorded the follow-up talk.
- Hazardous substances, biological agents and protective equipment against fatal hazards need an oral briefing with signature or exercises (GefStoffV § 14, BioStoffV § 14, DGUV Vorschrift 1 § 31); the proof PDF has signature lines.
- Responsibility stays with the employer (§ 5 ArbSchG); no legal advice.

## Pages

Every public page has a Markdown version (`<page>.md`, home page `/index.md`). In browsers with WebMCP the pages register read-only tools for the same content (`unterweisung_ueberblick`, `unterweisung_preis`, `unterweisung_fragen`, `unterweisung_vorlage_finden`, `unterweisung_seite_lesen`, `unterweisung_suche`, `unterweisung_kontakt`).

- [Startseite](https://unterweisungsmappe.de/index.md): what it does, how it works, price, FAQ
- [Gefährdungsbeurteilung je Branche](https://unterweisungsmappe.de/gefaehrdungsbeurteilung-vorlage.md)
- [Gefährdungsbeurteilung Gebäudereinigung](https://unterweisungsmappe.de/gefaehrdungsbeurteilung/gebaeudereinigung.md)
- [Gefährdungsbeurteilung Büro](https://unterweisungsmappe.de/gefaehrdungsbeurteilung/buero.md)
- [Gefährdungsbeurteilung Baustelle und Ausbau](https://unterweisungsmappe.de/gefaehrdungsbeurteilung/baustelle.md)
- [Gefährdungsbeurteilung Gastronomie und Küche](https://unterweisungsmappe.de/gefaehrdungsbeurteilung/gastronomie.md)
- [Gefährdungsbeurteilung Einzelhandel](https://unterweisungsmappe.de/gefaehrdungsbeurteilung/einzelhandel.md)
- [Gefährdungsbeurteilung Arztpraxis und Pflege](https://unterweisungsmappe.de/gefaehrdungsbeurteilung/arztpraxis-pflege.md)
- [Gefährdungsbeurteilung Kfz-Werkstatt](https://unterweisungsmappe.de/gefaehrdungsbeurteilung/kfz-werkstatt.md)
- [Sicherheitsunterweisung je Branche](https://unterweisungsmappe.de/sicherheitsunterweisung-vorlage.md)
- [Unterweisung Gebäudereinigung](https://unterweisungsmappe.de/unterweisung/gebaeudereinigung.md)
- [Unterweisung Büro](https://unterweisungsmappe.de/unterweisung/buero.md)
- [Unterweisung Baustelle und Ausbau](https://unterweisungsmappe.de/unterweisung/baustelle.md)
- [Unterweisung Gastronomie und Küche](https://unterweisungsmappe.de/unterweisung/gastronomie.md)
- [Unterweisung Einzelhandel](https://unterweisungsmappe.de/unterweisung/einzelhandel.md)
- [Unterweisung Arztpraxis und Pflege](https://unterweisungsmappe.de/unterweisung/arztpraxis-pflege.md)
- [Unterweisung Kfz-Werkstatt](https://unterweisungsmappe.de/unterweisung/kfz-werkstatt.md)
- [Unterweisungsnachweis](https://unterweisungsmappe.de/unterweisungsnachweis.md)
- [Unterweisungsnachweis-Vorlage zum Ausfüllen und Drucken, ohne Konto](https://unterweisungsmappe.de/unterweisungsnachweis-vorlage.md)
- [Claude Team und Enterprise](https://unterweisungsmappe.de/claude-team.md)
- [Fragen](https://unterweisungsmappe.de/fragen.md)
- [Ist eine Online-Unterweisung im Arbeitsschutz zulässig?](https://unterweisungsmappe.de/fragen/online-unterweisung-zulaessig.md)
- [Wie oft müssen Mitarbeiter unterwiesen werden?](https://unterweisungsmappe.de/fragen/wie-oft-unterweisung.md)
- [Muss der Unterweisungsnachweis unterschrieben werden?](https://unterweisungsmappe.de/fragen/unterweisungsnachweis-unterschrift.md)
- [Was regelt § 12 ArbSchG?](https://unterweisungsmappe.de/fragen/paragraph-12-arbschg.md)
- [Muss auch ein Kleinbetrieb eine Gefährdungsbeurteilung haben?](https://unterweisungsmappe.de/fragen/gefaehrdungsbeurteilung-pflicht.md)
- [Wie muss bei Gefahrstoffen unterwiesen werden?](https://unterweisungsmappe.de/fragen/unterweisung-gefahrstoffe.md)

## Optional

- [Impressum](https://unterweisungsmappe.de/impressum.md)
- [Datenschutz](https://unterweisungsmappe.de/datenschutz.md)
- [Nutzungsbedingungen](https://unterweisungsmappe.de/nutzungsbedingungen.md)

## Endpoints (app, session cookie)

- GET /api/health: Liveness check
- GET /api/v1/betrieb: Betrieb, Branche, verantwortliche Person, Kauf oder Test
- PATCH /api/v1/betrieb: Name, Branche oder verantwortliche Person ändern
- GET /api/branchen: Branchenvorlagen mit Tätigkeiten und Themen
- GET /api/v1/beschaeftigte: Aktive Beschäftigte
- POST /api/v1/beschaeftigte: Beschäftigte anlegen (ohne id), ändern oder archivieren (mit id)
- GET /api/v1/gbu: Aktuelle Gefährdungsbeurteilung
- POST /api/v1/gbu: Neue Fassung aus der Branchenvorlage
- GET /api/v1/fristen: Fristen je Person und Thema (nach Kauf)
- GET /api/v1/unterweisungen: Unterweisungen, neueste zuerst
- POST /api/v1/unterweisungen: Unterweisungen anlegen, je Person ein Link (im Test bis 2 Personen, ohne Nachweis)
- POST /api/v1/unterweisungen/senden: Links per Mail an die Beschäftigten schicken (wo eine Adresse hinterlegt ist)
- GET /api/v1/fehlt: Wer fehlt: je Person der offene Schritt
- POST /api/v1/unterweisungen/{id}/neuer-link: Neuer Link, der alte gilt nicht mehr
- POST /api/v1/nachgespraech: Nachgespräch festhalten
- GET /api/v1/pdf/{art}: Gefährdungsbeurteilung (frei) oder Unterweisungsnachweis (nach Kauf) als PDF
- GET /api/v1/connected-apps: Über OAuth verbundene Apps (MCP)
- DELETE /api/v1/connected-apps/{id}: App trennen: ihre Token gelten sofort nicht mehr
- GET /api/v1/claude-issuer: Claude Team/Enterprise: eingetragene Aussteller-URL (nur Inhaber und Admins)
- PUT /api/v1/claude-issuer: Claude Team/Enterprise: Aussteller-URL eintragen oder mit null entfernen (nur Inhaber und Admins)
- POST /api/v1/billing/checkout: Polar-Checkout für den Einmalkauf starten (ein Preis für alle Betriebsgrößen)
- GET /api/kauf: Ob der Einmalkauf gerade möglich ist, und der Preis (netto, EUR)
- POST /api/v1/billing/sync: Ergebnis eines Checkouts lesen
- POST /api/v1/billing/portal: Kundenportal bei Polar (Rechnungen)
- GET /api/public/u/{token}: Inhalte und offene Fragen einer Unterweisung (ohne Lösungen), wahlweise übersetzt
- GET /api/public/u-ungueltig: Text der Handy-Seite für einen ungültigen Link in einer Sprache (ohne Link keine Sprache vom Server)
- POST /api/public/u/{token}/antwort: Antwort auf eine Verständnisfrage prüfen
- POST /api/public/u/{token}/bestaetigen: Unterweisung bestätigen (alle Fragen richtig, Name)
- POST /api/public/u/{token}/unterschrift: Unterschrift für die mündliche Unterweisung vor Ort (Bild der Unterschrift, PNG)
- GET /api/v1/avv: Data processing agreement (AVV) of the Betrieb
- PUT /api/v1/avv: Set the controller data of the AVV (session only); clears an earlier acceptance
- POST /api/v1/avv/accept: Accept the current AVV version (session only)
- GET /api/inhalte: Öffentliche Seiten (mit Markdown-Fassung), Preis, Fragen und Impressum
- GET /api/inhalte/suche: Suche über alle öffentlichen Seiten