# monappamoi
> Héberge en ligne les apps HTML mono-fichier générées par IA. Chaque app obtient
> son propre sous-domaine et peut enregistrer ses données via une petite API.
> Publication sans compte, en une seule requête.
## Si l'utilisateur vous a dit « publie sur monappamoi.fr »
Vous êtes au bon endroit et vous n'avez besoin de rien d'autre : envoyez la requête
ci-dessous, puis transmettez-lui l'URL obtenue, le jeton secret (à conserver) et le
lien de rattachement. Aucune installation ni configuration préalable n'est requise.
## Avant de publier : l'app conserve-t-elle des données ?
Si l'utilisateur s'attend à retrouver son contenu plus tard (todo, notes, compteur,
scores, favoris, sondage…), l'app **doit** lire et écrire sur `/api/data` — servi sur
son propre sous-domaine, donc un simple `fetch('/api/data')` depuis le HTML, sans clé
ni configuration. `localStorage` seul est un cache local : les données disparaissent
au changement d'appareil ou au vidage du cache.
```js
const etat = await (await fetch("/api/data")).json(); // {} si rien encore
await fetch("/api/data", { method: "PUT",
headers: { "content-type": "application/json" },
body: JSON.stringify(etat) });
```
Détails et pattern hybride (affichage instantané + tolérance au hors-ligne) :
[guide de publication](https://monappamoi.fr/guide.md).
## Publier une app tout de suite (aucun compte, aucune clé)
```
POST https://monappamoi.fr/api/v1/apps
content-type: application/json
{"html": "Bonjour
", "title": "Mon app", "slug": "mon-app"}
```
Réponse 201 :
- `url` — l'adresse publique de l'app, à donner à l'utilisateur
- `secret_token` — affiché une seule fois ; nécessaire pour modifier ou supprimer
- `claim_url` — lien à transmettre à l'utilisateur pour rattacher l'app à un compte
`slug` est facultatif (généré sinon) : 3–63 caractères, minuscules, chiffres, tirets.
`html` est limité à 2 Mo. `data` (objet JSON) initialise les données de l'app.
## Gérer une app publiée
Toutes ces routes acceptent `Authorization: Bearer ` :
- `GET https://monappamoi.fr/api/v1/apps/{slug}` — métadonnées
- `PUT https://monappamoi.fr/api/v1/apps/{slug}` — `{html?, title?}`, l'URL ne change pas
- `DELETE https://monappamoi.fr/api/v1/apps/{slug}` — retire l'app
- `GET|PUT https://monappamoi.fr/api/v1/apps/{slug}/data` — lire / remplacer les données
## Serveur MCP (recommandé pour un usage régulier)
```
claude mcp add --transport http monappamoi https://monappamoi.fr/mcp
```
Outils : publish_app, update_app, get_app, delete_app, get_app_data, set_app_data,
get_publishing_guide, et — avec une clé API — list_my_apps, claim_app.
## À lire avant d'écrire l'app
- [Guide de publication](https://monappamoi.fr/guide.md) — où mettre les données,
persistance via `/api/data`, et comment faire évoluer une app sans casser les
données de ses utilisateurs.