# Authentication – Museumstapeten

Alle Schnittstellen von museumstapeten.de sind öffentlich und rein lesend. Es gibt keine Anmeldung, kein OAuth und keine API-Keys.

## Discover

- REST-API: https://museumstapeten.de/api/v1
- OpenAPI 3.1: https://museumstapeten.de/openapi.json
- MCP-Server (Streamable HTTP): https://museumstapeten.de/mcp
- MCP Server-Card: https://museumstapeten.de/.well-known/mcp/server-card.json
- API-Katalog (RFC 9727): https://museumstapeten.de/.well-known/api-catalog
- Protected Resource Metadata (RFC 9728): https://museumstapeten.de/.well-known/oauth-protected-resource
- WebMCP: jede Seite registriert die Tools über `document.modelContext.registerTool()`
- Doku: https://museumstapeten.de/developers/
- Texte für KI: https://museumstapeten.de/llms.txt · https://museumstapeten.de/llms-full.txt

## Pick a method

| Methode | Wofür |
| --- | --- |
| REST `GET /api/v1/...` | Produktdaten, Referenzprojekte, Ablauf, Anfrage-Entwurf, Suche |
| MCP `POST /mcp` | dieselben Funktionen als Tools für KI-Agenten |
| E-Mail / Kontaktformular | Anfrage und Bestellung (nur durch die Person selbst) |

Empfohlener Ablauf für Agenten:

1. Fakten über `get_product_specs`, `list_reference_projects`, `how_to_order` holen
2. Wandmaße (Breite × Höhe in cm) und Bildmaterial erfragen (JPEG/TIFF, CMYK, FOGRA27, 190 dpi im Maßstab 1:1)
3. Mit `prepare_inquiry` einen E-Mail-Entwurf erzeugen
4. Die Person sendet den Entwurf selbst an info@museumstapeten.de – Agenten senden nichts

## Register

Nicht nötig. Keine Registrierung, kein API-Key, kein `register_uri`, kein `claim_uri`.

## Claim

Nicht anwendbar.

## Use the credential

Kein Credential. Anfragen einfach ohne `Authorization`-Header senden. Optional für `POST /mcp`: Header `Idempotency-Key` (1–255 sichtbare ASCII-Zeichen) – gleiche Anfrage mit gleichem Schlüssel innerhalb von 24 Stunden liefert dieselbe Antwort (`Idempotent-Replayed: true`).

## Errors

Fehler kommen immer als JSON mit passendem HTTP-Status:

```json
{"error":{"code":"not_found","message":"Endpunkt nicht gefunden","status":404,"documentation":"https://museumstapeten.de/developers/"}}
```

| Status | code | Bedeutung |
| --- | --- | --- |
| 400 | `invalid_parameter` | Parameter fehlt oder ist ungültig |
| 404 | `not_found`, `project_not_found` | Endpunkt oder Projekt unbekannt |
| 405 | `method_not_allowed` | API ist nur lesend (GET); MCP nur per POST |
| 413 | `payload_too_large` | Anfrage größer als 64 KB |
| 422 | – (JSON-RPC-Fehler) | Idempotency-Key schon für andere Anfrage benutzt |
| 429 | `rate_limited` | mehr als 120 Anfragen pro Minute – `Retry-After` beachten |

## Revocation

Nicht anwendbar (keine Schlüssel, keine Sessions).

## Kontakt

```
E-Mail:  info@museumstapeten.de
Telefon: +49 2104 6419
Adresse: Caspar GmbH, Hochstraße 10, 42781 Haan-Gruiten
```

---

> agent_auth: none
> api: https://museumstapeten.de/api/v1
> mcp: https://museumstapeten.de/mcp
> identity_types_supported: none
> note: Öffentliche read-only-Schnittstellen. Bestellungen ausschließlich persönlich per E-Mail oder Kontaktformular.
