# KI-Assistenten bei WORK5.DE: Registrierung und Zugang

> Stand: laufzeitabhängig. Dieses Dokument beschreibt die vorhandenen Registrierungswege; es legt keine Konten an.

## Konto & Registrierung

- Registrieren (Browser): https://work5.de/registration
- Anmelden: https://work5.de/login
- Ein WORK5-Nutzerkonto (Auftraggeber oder Dienstleister) ist etwas anderes als ein OAuth-Client oder der administrative Agentenzugang (siehe unten).

### Auftraggeber (`job`)

- Verfügbarkeit über MCP: **nicht verfügbar** – Die MCP-Registrierung dieser Kontoart ist derzeit nicht verfügbar; bitte nutzen Sie die Registrierung im Browser.
- Browserweg: https://work5.de/registration?type=private
- Konto: Privates Kundenkonto für eigene Aufträge; bestehende private oder geschäftliche Konten werden nicht umgewandelt.
- Scopes nach Freigabe: `mcp:access discovery:read jobs:read jobs:write jobs:media`
- Schritt 1 (agent, Authentifizierung: none): `start_job_registration` mit `email`, `client_name` – Der Agent startet die Registrierung und zeigt dem Menschen den Code; die Antwort ist für neue, bestehende und nicht berechtigte Adressen gleich.
- Schritt 2 (human, Authentifizierung: mailbox): Nur der Postfachinhaber öffnet den Link aus der E-Mail, vergleicht den Code, akzeptiert die aktuellen Nutzungsbedingungen und gibt die aufgelisteten Rechte frei.
- Schritt 3 (agent, Authentifizierung: none): `claim_job_registration` mit `registration_uuid`, `claim_token` – Der Agent fragt höchstens alle fünf Sekunden ab und erhält den Zugang nach der persönlichen Freigabe genau einmal.
- Zustände: `pending` – Start angenommen; die persönliche Freigabe per E-Mail steht aus.; `authorization_pending` – Abruf vor der Freigabe; frühestens nach fünf Sekunden erneut abrufen.; `slow_down` – Zu schnell abgefragt; Intervall erhöhen.; `expired_token` – Vorgang nach 15 Minuten abgelaufen; neue Registrierung starten.; `invalid_grant` – Vorgang ungültig, widerrufen oder bereits abgeschlossen; es gibt keine zweite Ausgabe.; `token_limit` – Das Konto hat bereits fünf aktive API-Keys.; `feature_unavailable` – Der MCP-Registrierungsweg dieser Kontoart ist derzeit abgeschaltet.; `rate_limited` – Zu viele Anfragen von dieser Adresse.; `invalid_request` – Eingaben entsprechen nicht dem Schema.
- Beispiel (Testdaten): `{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"start_job_registration","arguments":{"email":"test-job@example.com","client_name":"Beispiel-Assistent (Test)"}}}`

### Dienstleister (`business`)

- Verfügbarkeit über MCP: **nicht verfügbar** – Die MCP-Registrierung dieser Kontoart ist derzeit nicht verfügbar; bitte nutzen Sie die Registrierung im Browser.
- Browserweg: https://work5.de/registration?type=business
- Konto: Geschäftskonto für einen eigenen Dienstleistereintrag; bestehende inaktive oder administrative Konten bleiben ausgeschlossen.
- Scopes nach Freigabe: `mcp:access discovery:read businesses:read businesses:write businesses:media`
- Schritt 1 (agent, Authentifizierung: none): `start_business_registration` mit `email`, `client_name` – Der Agent startet die Registrierung und zeigt dem Menschen den Code; die Antwort ist für neue, bestehende und nicht berechtigte Adressen gleich.
- Schritt 2 (human, Authentifizierung: mailbox): Nur der Postfachinhaber öffnet den Link aus der E-Mail, vergleicht den Code, akzeptiert die aktuellen Nutzungsbedingungen und gibt die aufgelisteten Rechte frei.
- Schritt 3 (agent, Authentifizierung: none): `claim_business_registration` mit `registration_uuid`, `claim_token` – Der Agent fragt höchstens alle fünf Sekunden ab und erhält den Zugang nach der persönlichen Freigabe genau einmal.
- Zustände: `pending` – Start angenommen; die persönliche Freigabe per E-Mail steht aus.; `authorization_pending` – Abruf vor der Freigabe; frühestens nach fünf Sekunden erneut abrufen.; `slow_down` – Zu schnell abgefragt; Intervall erhöhen.; `expired_token` – Vorgang nach 15 Minuten abgelaufen; neue Registrierung starten.; `invalid_grant` – Vorgang ungültig, widerrufen oder bereits abgeschlossen; es gibt keine zweite Ausgabe.; `token_limit` – Das Konto hat bereits fünf aktive API-Keys.; `feature_unavailable` – Der MCP-Registrierungsweg dieser Kontoart ist derzeit abgeschaltet.; `rate_limited` – Zu viele Anfragen von dieser Adresse.; `invalid_request` – Eingaben entsprechen nicht dem Schema.
- Beispiel (Testdaten): `{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"start_business_registration","arguments":{"email":"test-business@example.com","client_name":"Beispiel-Assistent (Test)"}}}`

## MCP

- Endpunkt: https://work5.de/mcp/work5 (Transport: streamable-http, Protokoll: 2025-06-18)
- Ohne Zugangsdaten: `initialize`, `ping`, `tools/list`
- Alle übrigen tools/call benötigen ein Bearer-Token; ohne Token antwortet der Server mit HTTP 401 und WWW-Authenticate inklusive resource_metadata.
- Discovery-Tools benötigen `mcp:access discovery:read`; Ressourcen-Metadaten: https://work5.de/.well-known/oauth-protected-resource/mcp/work5; Autorisierungsserver: https://work5.de/.well-known/oauth-authorization-server
- Server Card: https://work5.de/.well-known/mcp/server-card.json

## REST-API

- OpenAPI: https://work5.de/openapi.json – Dokumentation: https://work5.de/api/docs
- Öffentlich ohne Token: https://work5.de/api/businesses, https://work5.de/api/jobs, https://work5.de/api/trades

## OAuth-Client und administrativer Agentenzugang

- OAuth-Client (PKCE): Registrierung https://work5.de/oauth/register, Autorisierung https://work5.de/authorize, Token https://work5.de/token. Ein OAuth-Client ist kein WORK5-Nutzerkonto. Er erhält Zugriff erst, nachdem ein angemeldeter Mensch die Freigabe unter /authorize erteilt hat.
- Administratorbestätigter Zugang: https://work5.de/auth.md. Der administratorbestätigte Agentenzugang aus auth.md ist kein Weg für neue Auftraggeber oder Dienstleister.

## Betreiber & Rechtliches

- Publisher: Metinet – Impressum: https://work5.de/hilfe/impressum
- Datenschutz: https://work5.de/hilfe/datenschutzerklaerung – Nutzungsbedingungen: https://work5.de/hilfe/nutzungsbedingungen
- Kontakt: https://work5.de/hilfe/support

## Regeln

- Der Agent fordert den persönlichen Bestätigungslink niemals an, öffnet ihn nicht und stimmt Nutzungsbedingungen nicht stellvertretend zu.
- Ohne persönliche Freigabe wird kein Zugang ausgegeben; abgelaufene, falsche oder wiederverwendete Nachweise werden abgelehnt.
- Der Abruf des Zugangs erfolgt genau einmal; Abrufschlüssel und Zugangstoken bleiben geheim.
- Antworten verraten nicht, ob zu einer E-Mail-Adresse bereits ein Konto besteht.

Maschinenlesbar: https://work5.de/ki-assistenten/registrierung.json – Agenten-Dokumente: https://work5.de/llms.txt, https://work5.de/llms-full.txt, https://work5.de/skill.md