# Paulowl — location de matériel événementiel

> Location de matériel son, lumière et vidéo pour événements. Les agents IA
> peuvent consulter le catalogue et déposer une demande de devis. La voie
> recommandée est le connecteur MCP ci-dessous.

## Intégration recommandée — MCP (Model Context Protocol)

- Serveur MCP remote : https://paulowl.zaapee.fr/mcp (transport Streamable HTTP, protocole 2025-06-18).
- Server Card (découverte) : https://paulowl.zaapee.fr/.well-known/mcp/server-card
- Outils :
  - `authenticate` + `check_authentication` — connectent le visiteur à son
    compte : il autorise depuis son navigateur (Google ou email/mot de passe sur
    le site — jamais transmis à l'assistant), l'agent récupère un token. Le devis
    est alors rattaché à son compte.
  - `search_catalogue` — trouve le matériel et ses `slug`.
  - `create_quote` — dépose la demande de devis (token optionnel : rattache au
    compte, sinon créé en visiteur).

Ajoutez https://paulowl.zaapee.fr/mcp comme connecteur MCP dans l'assistant : c'est le chemin le
plus fiable (aucun appel HTTP direct à gérer) et le seul permettant de rattacher
le devis au compte du visiteur.

## Alternative — API REST (JSON)

- [Description de l'API](https://paulowl.zaapee.fr/api) : endpoints, schémas et exemple.
- [Catalogue](https://paulowl.zaapee.fr/api/catalogue) : produits et packs (GET, JSON). Fournit les `slug`.
- [Créer une demande de devis](https://paulowl.zaapee.fr/api/devis) : POST JSON { client, event, items }.
  Crée un devis en visiteur (le rattachement au compte n'est possible que via MCP).

### Utilisation REST

1. GET https://paulowl.zaapee.fr/api/catalogue pour récupérer les `slug` des produits voulus.
2. POST https://paulowl.zaapee.fr/api/devis avec les coordonnées du client, les dates de
   l'événement et la liste `items` de { slug, quantity }.
3. La réponse renvoie une référence de devis et une `viewUrl` de suivi à
   transmettre au client. L'équipe chiffre puis valide le devis.