> ## Documentation Index
> Fetch the complete documentation index at: https://docs.colismove.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Historique des versions et mises à jour du serveur ColisMove MCP.

## v2.2.0 — 28 avril 2026

### Nouveautés

* **Filtrage par audience** — Nouvel outil backend `list_endpoints_by_audience` qui regroupe les endpoints API par surface cible :
  * `particuliers` — application mobile/web grand public (auth, annonces, bookings, payments, KYC, messaging, tracking, etc.)
  * `web-agency` — back-office agence (agencies, branches, employees, agency finances, agency KYC)
  * `web-superadmin` — console interne Bomunto (superadmin/\*, liste utilisateurs, CRUD catégories, gestion cache)
  * `public` — endpoints anonymes (webhooks/*, delivery/*)
  * Passez un argument `audience` pour filtrer, ou appelez sans argument pour obtenir la cartographie complète
* **Mise à jour des outils Design System** — Alignée sur le repo Next.js 16 `colismove-design-system` en production :
  * Nouvel outil `get_design_system_info` — lit `package.json` et `components.json` pour exposer la version live, les dépendances et la configuration ShadCN
  * Nouvel outil `list_components(detailed?)` — scanne `components/ui/` et `hooks/` pour fournir la liste des composants en production (avec métadonnées de fichiers en option)
  * Les outils existants `get_design_tokens`, `get_color_palette`, `get_visual_style`, `get_component_catalog`, `get_brand_guidelines` sont conservés pour l'accès au catalogue statique
  * Localisation du repo configurable via la variable d'environnement `DESIGN_SYSTEM_PATH`

***

## v2.1.0 — Avril 2026

### Nouveautés

* **Portail self-service de tokens** — Gérez vos tokens API personnels sur [mcp-portal.colismove.com](https://mcp-portal.colismove.com)
  * Génération, nommage et révocation des tokens depuis le tableau de bord
  * Jusqu'à 3 tokens actifs par utilisateur (un par machine / outil IA recommandé)
  * Tokens affichés une seule fois à la création, hachés côté serveur
  * Format du token : `cmcp_<64 hex chars>`
* **Tokens par utilisateur** — Chaque développeur dispose désormais de ses propres tokens, à la place d'une clé partagée
* **Révocation à chaud** — Les tokens révoqués cessent de fonctionner sous 60 secondes (TTL du cache côté serveur)
* **Onboarding** — Demandez l'accès par email à votre tech lead, vous recevez une invitation pour configurer votre compte

### Migration depuis la v2.0

Les anciennes clés API partagées sont obsolètes. Générez un token personnel depuis le portail et remplacez `YOUR_API_KEY` par votre nouveau token `cmcp_...` dans la configuration de votre client MCP.

***

## v2.0.0 — Avril 2026

<Note>
  Version actuellement déployée à `https://colismove-mcp.onrender.com`
</Note>

### Nouveautés

* **Accès distant** — Le serveur MCP tourne désormais comme un service hébergé, accessible depuis n'importe où
* **Authentification par clé API** — Accès sécurisé avec authentification Bearer token
* **Transport Streamable HTTP** — Protocole MCP moderne (remplace SSE déprécié)
* **4 catégories d'outils** — Contexte projet, docs API, accès backend, architecture frontend

### Outils disponibles

| Outil                 | Catégorie | Description                                              |
| --------------------- | --------- | -------------------------------------------------------- |
| `get_project_context` | Projet    | Architecture, flux, conventions, stack technique         |
| `get_api_docs`        | Docs      | Documentation d'un endpoint précis                       |
| `search_api_docs`     | Docs      | Recherche d'endpoints par mot-clé                        |
| `get_openapi_spec`    | Docs      | Spécification OpenAPI (complète ou filtrée)              |
| `query_database`      | Backend   | Requêtes SQL (lecture seule, nécessite une connexion DB) |
| `api_request`         | Backend   | Requêtes HTTP vers l'API                                 |
| `docker_status`       | Backend   | Statut des services Docker                               |
| `read_logs`           | Backend   | Logs Spring Boot                                         |
| `stripe_test`         | Backend   | Vérifications en mode test Stripe                        |

<Info>
  Les outils backend (`query_database`, `api_request`, etc.) nécessitent que le serveur MCP dispose d'une connexion à la base de données et à l'API. La version hébergée fournit par défaut les outils de contexte projet et de documentation API.
</Info>

***

## v1.0.0 — Mars 2026

* Première version, en serveur MCP local uniquement
* Embarqué dans `colismove-backend-kube/mcp/`
* Transport stdio (local uniquement)
* 6 outils : query\_database, api\_request, docker\_status, flyway\_info, read\_logs, stripe\_test