Accès MCP optionnel (docs-mcp) pour les assistants IA #2

Merged

cedric merged 1 commit from feat/mcp into v6

2026-10-11 11:46:22 +00:00

cedric commented

2026-10-11 11:17:40 +00:00

Owner

Ajoute un accès MCP optionnel (panneau de configuration → Accès MCP) : les assistants IA (Claude, VS Code, Hermes…) peuvent chercher, lire et créer des documents avec les droits de l'utilisateur qui les connecte. Service : docs-mcp v0.1.0.

Option désactivée (défaut)

.env : resource server à False (bloc présent mais inactif), manage.py check après chaque génération de la configuration (évite un Docs qui ne démarre plus).
Rien d'autre ne change.

Option activée (`setup_mcp`)

Client Dex <app>-mcp (redirect https://<domaine>/mcp/auth/callback, secret en setting).
Source docs-mcp (tag épinglé, sha256), venv via le uv du paquet (Python 3.14).
Service <app>-mcp (port réservé), .env_mcp en 400, données dans $data_dir/mcp (sauvegardées avec l'app).
nginx : fichier séparé <app>-mcp.conf (4 locations : /mcp, /mcp/, et les deux métadonnées OAuth à la racine).
Docs : resource server activé avec dex_resource_server.DexResourceServerBackend (introspection Dex sans scope, refresh tokens refusés), audience limitée au client MCP, EXTERNAL_API : documents list, retrieve, create, children, formatted_content uniquement.
Désactiver retire service, nginx et client Dex ; les données sont gardées.
Cycle de vie : install / upgrade / config / change_url / restore appellent setup_mcp ; remove nettoie tout.

Doc

doc/ADMIN.md / doc/ADMIN_fr.md : activer, adresse à donner, connexion de chaque client, outils, confidentialité, révocation.

Vérifications

bash -n sur les scripts, TOML valides, docs-mcp démarre en Python 3.14.
À faire : upgrade réel sur docs.nimesys.fr (option désactivée puis activée), connexion d'un client MCP et appel de bout en bout.

Version : 6.0.0~ynh4.

Ajoute un **accès MCP optionnel** (panneau de configuration → *Accès MCP*) : les assistants IA (Claude, VS Code, Hermes…) peuvent chercher, lire et créer des documents avec les droits de l'utilisateur qui les connecte. Service : [docs-mcp](https://git.nimesys.fr/cedric/docs-mcp) v0.1.0. ## Option désactivée (défaut) - `.env` : resource server à `False` (bloc présent mais inactif), `manage.py check` après chaque génération de la configuration (évite un Docs qui ne démarre plus). - Rien d'autre ne change. ## Option activée (`setup_mcp`) - Client Dex `<app>-mcp` (redirect `https://<domaine>/mcp/auth/callback`, secret en setting). - Source docs-mcp (tag épinglé, sha256), venv via le `uv` du paquet (Python 3.14). - Service `<app>-mcp` (port réservé), `.env_mcp` en 400, données dans `$data_dir/mcp` (sauvegardées avec l'app). - nginx : fichier séparé `<app>-mcp.conf` (4 locations : `/mcp`, `/mcp/`, et les deux métadonnées OAuth à la racine). - Docs : resource server activé avec `dex_resource_server.DexResourceServerBackend` (introspection Dex sans `scope`, refresh tokens refusés), audience limitée au client MCP, `EXTERNAL_API` : documents `list, retrieve, create, children, formatted_content` uniquement. - Désactiver retire service, nginx et client Dex ; les données sont gardées. - Cycle de vie : install / upgrade / config / change_url / restore appellent `setup_mcp` ; remove nettoie tout. ## Doc `doc/ADMIN.md` / `doc/ADMIN_fr.md` : activer, adresse à donner, connexion de chaque client, outils, confidentialité, révocation. ## Vérifications - `bash -n` sur les scripts, TOML valides, docs-mcp démarre en Python 3.14. - À faire : upgrade réel sur docs.nimesys.fr (option désactivée puis activée), connexion d'un client MCP et appel de bout en bout. Version : `6.0.0~ynh4`.

cedric added 1 commit

2026-10-11 11:17:40 +00:00