# notebook-mcp : Passerelle MCP pour Open Notebook cloisonnée par sphère Passerelle MCP imposant le cloisonnement strict par sphère (`tt`, `nyora`, `perso`, `infra`, `test-a`, `test-b`) devant l'instance Open Notebook locale sur le VPS (Ticket infra-2026-10-042). ## Objectifs & Sécurité - **Cloisonnement strict par sphère** : Aucun carnet ni document d'une sphère ne peut être vu, interrogé ou recherché depuis une autre sphère. - **Double vérification** : Vérification des autorisations en amont (registre SQLite interne `./state/registry.db`) et filtrage strict a posteriori des sources citées dans les réponses ou résultats. - **Invisibilité des carnets hors registre** : Les carnets créés en direct dans Open Notebook sans passer par la passerelle sont strictement invisibles et inaccessibles aux assistants. - **Erreurs uniformes** : Un identifiant de carnet inconnu et un identifiant de carnet d'une autre sphère renvoient exactement le même message d'erreur au caractère près (`Carnet introuvable : `), empêchant toute déduction d'existence. - **Transport** : Streamable HTTP sur `/mcp/` et endpoint `/health` pour le monitoring. - **Authentification** : Jeton Bearer par assistant, vérifié par empreinte sha256 dans `tokens/tokens.json`. - **Limitation de débit** : 60 requêtes par minute par identité au total, dont 10 pour `notebook_ask`. Les appels refusés comptent dans la limite. - **Journalisation sans secret** : Chaque appel est tracé dans `/app/logs/access.log` (date, identité, outil, id de carnet, statut, durée). Aucun mot de passe, jeton, texte de question ou de réponse n'est journalisé. - **Conteneur durci** : Utilisateur non-root (`appuser`), limite mémoire de 256 Mo, ports 3104 liés uniquement à `127.0.0.1` et `100.94.90.119`. ## Outils MCP exposés (6 outils) 1. `notebook_list()` : Liste les carnets visibles par l'appelant selon ses sphères autorisées. 2. `notebook_create(sphere, name, description="")` : Crée le carnet dans Open Notebook et l'inscrit dans le registre de la passerelle. 3. `source_add_text(notebook_id, title, content)` : Ajoute une source textuelle dans un carnet existant (vectorisation automatique, limité à 200 000 caractères). 4. `source_list(notebook_id)` : Liste les sources du carnet (`id`, `title`, `embedded`). 5. `notebook_ask(notebook_id, question)` : Réponse sourcée par Open Notebook, filtrée et vérifiée. 6. `notebook_search(query, notebook_id="", max_results=8)` : Recherche compacte cloisonnée aux carnets autorisés. ## Gestion des jetons Le script `mint-token.sh ` permet de générer un jeton de 48 caractères hexadécimaux et d'inscrire son empreinte sha256 dans `tokens/tokens.json`. Le jeton est écrit avec permissions 0600 et n'est jamais affiché dans les terminaux ou journaux.