31 lines
1.9 KiB
Markdown
31 lines
1.9 KiB
Markdown
# taf-mcp — Serveur MCP pour l'espace Idées de TAF
|
|
|
|
Serveur MCP exposant l'espace **Idées** de TAF (Ticket `perso-2026-10-218`) pour OpenClaw-Perso (NAS) et les autres assistants.
|
|
|
|
## Architecture
|
|
|
|
- **Protocole** : MCP via FastMCP et StreamableHTTP (`/mcp` et `/`).
|
|
- **Réseau Docker** : `mcp-vps` (accès direct à l'API de TAF sur `http://taf:8000`).
|
|
- **Ports d'écoute** : Publié **strictement** sur `127.0.0.1:3105` et `100.94.90.119:3105` (aucun accès 0.0.0.0 ni ::).
|
|
- **Authentification** : Bearer token par assistant, validé en temps constant (`hmac.compare_digest`). Jeton OpenClaw-Perso transmis par la variable `TAF_MCP_TOKEN_OPENCLAW_PERSO`.
|
|
- **Intégrité & Sécurité** :
|
|
- Aucun montage de `docker.sock`.
|
|
- Conteneur exécuté en utilisateur non-root (`appuser`, uid 1026).
|
|
- Politique de redémarrage : `unless-stopped`.
|
|
- Healthcheck HTTP sur `/health`.
|
|
|
|
## Les 6 Outils MCP
|
|
|
|
1. `idee_ajouter(texte, etiquettes)` : Ajoute une idée (force `space=idees`, `source=openclaw`, `status=nouvelle`).
|
|
2. `idees_lister(statut, etiquette, depuis)` : Liste les idées actives selon les filtres.
|
|
3. `idee_rechercher(mot)` : Recherche textuelle dans le texte brut, la reformulation et les étiquettes.
|
|
4. `idee_recadrer(id, reformulation)` : Met à jour la reformulation (`reframed`). Toute tentative de modifier le texte brut original (`text` ou `texte`) est formellement rejetée (« le texte brut de Nabil est intouchable, utiliser idee_recadrer »).
|
|
5. `idee_statut(id, statut)` : Modifie le statut (`nouvelle`, `a_creuser`, `en_cours`, `abandonnee`).
|
|
6. `idee_etiqueter(id, etiquettes)` : Met à jour les étiquettes (maximum 8 étiquettes de 40 caractères).
|
|
|
|
## Règles Dures Imposées
|
|
|
|
- **Texte brut intouchable** : Aucun outil ne peut modifier le champ `text` d'une idée créée.
|
|
- **Cloisonnement strict** : Tout accès à un identifiant appartenant à l'espace `taches` est rejeté.
|
|
- **Aucune suppression** : Aucun outil de suppression n'est exposé.
|