# excalidraw-mcp-gateway

Passerelle OAuth 2.1 + proxy pour le MCP Excalidraw officiel (`excalidraw/excalidraw-mcp`).

Copie-adaptation du pattern `tasks-mcp` / `calendar-mcp-gateway` : serveur
d'autorisation colocalise (SDK python `mcp` v2, PKCE/DCR, metadata RFC 8414/9728),
page `/consentement` (phrase de passe, seule l'empreinte PBKDF2 est stockee),
middleware `/mcp` avec politique d'autorisation outil par outil (fail-closed).

- Lecture (`excalidraw:lecture`) : `read_me`, `read_checkpoint`.
- Ecriture (`excalidraw:ecriture`) : `create_view`, `save_checkpoint`,
  `export_to_excalidraw` (televerse vers excalidraw.com : sortie de donnee).
- OAuth seul, pas de Bearer statique.

## Bibliotheque distante `Excalidraw` (persistance serveur)

Les dessins IA et humains sont persistés en `.excalidraw` standard sous
`/srv/excalidraw/data/bibliotheque` (racine logique `Excalidraw`, chemins
relatifs uniquement, `..`/liens symboliques/traversal refuses, ecriture
atomique). Fichiers re-ouvrables tels quels dans Excalidraw.

Outils MCP servis localement par la passerelle (jamais relayes a l'upstream) :

- Lecture : `library_list`, `library_load`.
- Ecriture : `library_mkdir`, `library_save` (`elements` JSON ou `checkpoint_id`),
  `library_move` (renommer/deplacer).
- `create_view` est systematiquement persiste : `enregistrer_sous`
  (ex. `rag/schema.excalidraw`) designe le chemin (prioritaire) ; sans lui,
  autosave automatique sous `Excalidraw/ia/` (nom horodate sans collision,
  confinement inchange). Reponse enrichie de `fichier` + `url_ouverture`
  (`.../excalidraw/editeur#/<chemin>`, editeur principal) + `persistance_ok`.
  Le rendu n'est jamais sacrifie : un echec de persistance est signale dans
  la reponse (`persistance_ok: False`), rendu preserve. Un `enregistrer_sous`
  invalide reste refuse avant tout relais (fail-closed, upstream jamais
  contacte pour une demande inexploitable).

Page web : `/editeur` (**editeur principal integre** : canvas officiel
plein ecran + feuille de style officielle, actions discretes « Ouvrir » /
« Enregistrer » / « Nouveau » via `renderTopRightUI` ouvrant la modale
file-browser, deep-link `#/<chemin>`, puce de statut ; fichiers locaux via
le menu natif Excalidraw) ; `/bibliotheque` redirige vers `/editeur` ;
API `/api/liste`, `/api/document` (GET/PUT), `/api/dossiers`,
`/api/deplacer` (Bearer `EXCALIDRAW_BIBLIO_TOKEN` exige, jamais en URL).
Editeur + API servis UNIQUEMENT sur le reseau prive (vhost NetBird,
jamais en public) : le proxy prive injecte l'`Authorization` cote serveur,
le navigateur ne voit aucun secret (ni champ, ni stockage, ni en-tete).
Seul `/excalidraw/mcp` (+ OAuth/well-known) reste public pour ChatGPT.
Deep-link `url_ouverture` parametrable via `EXCALIDRAW_URL_EDITEUR`
(editeur prive, ex. `http://10.200.114.203:8130/editeur`).

Deploiement : voir l'unite `excalidraw-gateway.service` et les vhosts
`mymcps.duckdns.org` / `excalidraw-ip` versionnes dans
`Revens2/vps-etude-infra`. Aucun secret dans ce depot (voir `.env.example`).