diff --git a/README.md b/README.md
index 6a22f24..a8f98f6 100644
--- a/README.md
+++ b/README.md
@@ -163,6 +163,37 @@ curl -H "Authorization: Bearer <token>" \
   -o dataset.jsonl
 ```
 
+## Commentaires fédérés (Mastodon / bokante.o-k-i.net)
+
+Chaque parole publiée peut obtenir un statut miroir sur l'instance Mastodon de
+l'organisation, [bokante.o-k-i.net](https://bokante.o-k-i.net), et les réponses reçues
+sur ce statut sont importées comme commentaires. Voir le RFC dédié pour le détail de la
+conception (`RFC-commentaires-activitypub-2026-07-04.md`, à la racine du dossier
+`PAWOL.NU`).
+
+**Variables d'environnement :**
+
+| Variable | Obligatoire | Description |
+|---|---|---|
+| `BOKANTE_ACCESS_TOKEN` | Oui, pour activer la fonctionnalité | Jeton d'application Mastodon (scopes `write:statuses`, `read:statuses`) d'un compte bot dédié sur bokante.o-k-i.net |
+| `BOKANTE_INSTANCE_URL` | Non | Instance Mastodon cible (défaut : `https://bokante.o-k-i.net`) |
+| `BOKANTE_BACKFILL_CRON` | Non | Règle cron du backfill du catalogue existant (défaut : `0 * * * *`, une parole/heure) |
+
+Sans `BOKANTE_ACCESS_TOKEN`, toute la fonctionnalité (publication du miroir, import des
+réponses, backfill) est un no-op silencieux — comme les intégrations Telegram/Revolt.
+
+**Comment obtenir le jeton :** créer un compte bot dédié sur bokante.o-k-i.net, puis dans
+*Préférences → Développement → Nouvelle application*, cocher uniquement `write:statuses`
+et `read:statuses`. Le jeton d'accès est affiché directement sur la page de l'application
+créée.
+
+**Tâches planifiées (cron) :**
+- Publication du miroir : déclenchée à chaque publication d'une parole (pas de cron).
+- Import des réponses : toutes les 20 minutes.
+- Backfill du catalogue existant : une parole par exécution (la plus ancienne sans
+  miroir en premier), au rythme défini par `BOKANTE_BACKFILL_CRON`. S'arrête de
+  lui-même une fois le catalogue rattrapé.
+
 ## License
 
 Copyright (C) 2024 Cédric Famibelle-Pronzola & ORGANISATION KA INTERNATIONALE (OKI)