From 17c5160f2c4420d7dccc485fa219e0f59ad6de66 Mon Sep 17 00:00:00 2001
From: matthieu <matthieu@yuno.malio.fr>
Date: Sun, 15 Mar 2026 19:49:57 +0100
Subject: [PATCH] docs : add MCP server documentation to README

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
---
 README.md | 70 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 70 insertions(+)

diff --git a/README.md b/README.md
index 02018e9..6cddce7 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,71 @@
 # Lesstime
+
+Application de gestion de projet. Symfony 8 + API Platform 4 + Nuxt 4.
+
+## MCP Server
+
+Lesstime expose un serveur MCP (Model Context Protocol) permettant aux assistants IA (Claude Code, ChatGPT, Codex) d'interagir avec les projets, tâches et le suivi du temps.
+
+### Tools disponibles (22)
+
+| Domaine | Tools |
+|---------|-------|
+| Reference | `list-users`, `list-clients` |
+| Project | `list-projects`, `get-project`, `create-project`, `update-project` |
+| Task | `list-tasks`, `get-task`, `create-task`, `update-task`, `delete-task` |
+| TaskMeta | `list-statuses`, `list-priorities`, `list-efforts`, `list-tags`, `list-groups`, `create-group`, `update-group` |
+| TimeEntry | `list-time-entries`, `create-time-entry`, `update-time-entry`, `delete-time-entry` |
+
+### Transports
+
+| Transport | Usage | Auth |
+|-----------|-------|------|
+| **STDIO** | Claude Code sur la machine locale | Aucune |
+| **HTTP** (`/_mcp`) | Clients MCP sur le réseau local | API token (`Authorization: Bearer <token>`) |
+
+### Configuration locale (STDIO)
+
+```json
+{
+  "mcpServers": {
+    "lesstime": {
+      "command": "docker",
+      "args": ["exec", "-i", "php-lesstime-fpm", "php", "bin/console", "mcp:server"]
+    }
+  }
+}
+```
+
+### Configuration réseau (HTTP)
+
+```json
+{
+  "mcpServers": {
+    "lesstime": {
+      "type": "url",
+      "url": "http://<ip-serveur>:8082/_mcp",
+      "headers": {
+        "Authorization": "Bearer <api-token>"
+      }
+    }
+  }
+}
+```
+
+### Gestion des tokens API
+
+```bash
+# Générer un token pour un utilisateur
+docker exec -u www-data php-lesstime-fpm php bin/console app:generate-api-token <username>
+```
+
+### Mise en production (réseau local)
+
+1. Déployer le code sur le serveur
+2. `composer install --no-dev --optimize-autoloader`
+3. `php bin/console doctrine:migrations:migrate --no-interaction`
+4. `php bin/console cache:clear --env=prod`
+5. `docker restart nginx-lesstime`
+6. `php bin/console app:generate-api-token admin` — noter le token
+7. Ouvrir le port 8082 sur le firewall du serveur (LAN uniquement)
+8. Configurer les clients MCP avec l'URL `http://<ip-serveur>:8082/_mcp` + le token