diff --git a/openremote_mqtt_agent_status.md b/openremote_mqtt_agent_status.md
new file mode 100644
index 00000000..812719f3
--- /dev/null
+++ b/openremote_mqtt_agent_status.md
@@ -0,0 +1,36 @@
+# OpenRemote MQTT Agent - Configuration Status
+
+## Date : 04 Mai 2026
+
+## ✅ État
+- **OpenRemote** : Accessible ✅ (https://openremote.digitribe.fr - v1.23.0)
+- **EMQX** : En cours d'exécution ✅ (container `emqx_emqx_1`, port 11883 mappé)
+- **MQTT Test** : Publication OK ✅ (`mosquitto_pub -h localhost -p 11883`)
+
+## ❌ Problème : API Agent Access Forbidden
+Tentatives de configuration de l'agent MQTT via l'API REST :
+1. `GET /api/master/asset/agent` → Vide
+2. `POST /api/master/asset/agent` → Vide
+3. `GET /api/master/asset/agent` → **"Access forbidden: role not allowed"**
+
+## 🔧 Solution recommandée (via Manager UI)
+1. Aller sur https://openremote.digitribe.fr/manager/
+2. Se connecter (admin/Digitribe972)
+3. **Realm** : Smart City
+4. **Assets** → **Agents** → **+ Add Agent**
+5. Configurer :
+   - **Type** : MQTT Agent
+   - **Name** : `EMQX Agent`
+   - **MQTT URI** : `tcp://localhost:11883` (ou `tcp://emqx_emqx_1:1883` pour connexion interne)
+   - **Topic** : `sensors/#`
+   - **Client ID** : `openremote-mqtt-agent`
+   - **Enabled** : ✅
+
+## 📋 Topics à écouter (simulateur)
+- `sensors/airquality/+/data`
+- `sensors/traffic/+/data`  
+- `sensors/brokers/+/data`
+
+## 🔗 Références
+- Doc OpenRemote MQTT Agent : https://docs.openremote.io
+- EMQX Dashboard : http://localhost:18081 (admin/public)