diff --git a/README-EN.md b/README-EN.md
index 2ce6168..c82da86 100644
--- a/README-EN.md
+++ b/README-EN.md
@@ -206,10 +206,17 @@ scp -r /home/rpi5/voice-assistant/agent/ user@desktop-pc:~/voice-agent-install/
 cd ~/voice-agent-install
 sudo make install
 
-# 3. Configure
+# 3. Create the MQTT account on the server (if the broker is secured, step 15)
+#    (run on the Raspberry Pi, not on the target machine)
+make mqtt-user NAME=pc-bureau      # note the password
+make mosquitto-docker              # or mosquitto-config — reloads the broker
+
+# 4. Configure the agent on the target machine
 sudo nano /etc/voice-assistant/agent.yaml
 #   id: pc-bureau                    ← name used in MQTT topics
 #   mqtt.host: 192.168.1.104         ← broker IP address
+#   mqtt.username: pc-bureau         ← same value as id (empty if anonymous broker)
+#   mqtt.password: <password>        ← generated in step 3 (empty if anonymous broker)
 #   dry_run: false                   ← true to test without executing anything
 
 # 4. Enable and start
diff --git a/README.md b/README.md
index f217bd0..8bb4ab5 100644
--- a/README.md
+++ b/README.md
@@ -207,10 +207,17 @@ scp -r /home/rpi5/voice-assistant/agent/ user@pc-bureau:~/voice-agent/
 cd ~/voice-agent
 sudo make install
 
-# 3. Configurer
+# 3. Créer le compte MQTT sur le serveur (si le broker est sécurisé, étape 15)
+#    (à exécuter sur le Raspberry Pi, pas sur la machine cible)
+make mqtt-user NAME=pc-bureau      # noter le mot de passe
+make mosquitto-docker              # ou mosquitto-config — recharge le broker
+
+# 4. Configurer l'agent sur la machine cible
 sudo nano /etc/voice-assistant/agent.yaml
 #   id: pc-bureau                    ← nom dans les topics MQTT
 #   mqtt.host: 192.168.1.104         ← adresse IP du broker
+#   mqtt.username: pc-bureau         ← même valeur que id (vide si broker anonyme)
+#   mqtt.password: <mot-de-passe>    ← généré à l'étape 3 (vide si broker anonyme)
 #   dry_run: false                   ← true pour tester sans rien exécuter
 
 # 4. Activer et démarrer