# 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: `http://localhost:3000/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 `http://localhost:3000/mcp`. Claude Code: `claude mcp add --transport http unterweisung http://localhost:3000/mcp`.
- On connecting, the user signs in (or creates an account) and picks the business. Free: business, employees, risk assessment with PDF, deadlines. With the subscription (7 days free): briefing links, follow-up talk, 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.

## Endpoints (app, session cookie)

- GET /api/health: Liveness check
- GET /api/v1/betrieb: Betrieb, Branche, verantwortliche Person, Abo
- 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
- GET /api/v1/unterweisungen: Unterweisungen, neueste zuerst
- POST /api/v1/unterweisungen: Unterweisungen anlegen (Abo), je Person ein Link
- POST /api/v1/unterweisungen/{id}/neuer-link: Neuer Link, der alte gilt nicht mehr
- POST /api/v1/nachgespraech: Nachgespräch festhalten (Abo)
- GET /api/v1/pdf/{art}: Gefährdungsbeurteilung (frei) oder Unterweisungsnachweis (Abo) 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
- POST /api/v1/billing/checkout: Polar-Checkout starten (Karte, 7 Tage kostenlos)
- POST /api/v1/billing/sync: Ergebnis eines Checkouts lesen
- POST /api/v1/billing/portal: Kundenportal bei Polar (Karte, Rechnungen, Kündigung)
- GET /api/public/u/{token}: Inhalte und Fragen einer Unterweisung (ohne Lösungen)
- 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)
- 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)