Model Context Protocol (MCP)

Connectez vos assistants IA externes—notamment Claude Desktop, Cursor, Antigravity, Windsurf et VS Code—directement à vos espaces de travail Noust locaux en temps réel.

Le serveur officiel @noust-app/mcp offre une communication bidirectionnelle sécurisée et 100% locale entre les modèles d'IA et vos notes, vos documents Nexus Pages et la topologie du canevas.

Que peut faire l'IA dans votre espace de travail ?

Au lieu de copier et coller manuellement des notes dans un chatbot, le protocole MCP accorde à votre IA un accès contextuel et autonome pour interagir avec votre canevas :

🔍 Recherche et consultation intelligente : Demandez à l'assistant d'explorer vos notes, vos pages Nexus ou vos objectifs. Le modèle extrait l'intégralité du contenu sans troncature et sans balises HTML.
"Recherche dans mon espace Noust la liste de contrôle de déploiement et résume les tâches restantes."
✍️ Création, édition et suppression sur le canevas en direct : L'IA peut créer de nouvelles cartes de notes, mettre à jour du texte existant ou supprimer les notes obsolètes en temps réel sur votre écran.
"Crée une nouvelle note sur mon canevas avec les 3 points clés de notre discussion."
🎯 Gestion des objectifs et jalons : Suivez vos objectifs de projet de manière autonome. Les modèles d'IA peuvent créer de nouveaux objectifs, mettre à jour les échéances, les priorités, marquer des tâches comme terminées, ajouter des notes de progression ou supprimer des éléments.
"Ajoute un objectif prioritaire pour déployer le staging avant vendredi et marque l'étape de migration comme terminée."
📄 Contrôle complet des documents Nexus : Structurez facilement vos bases de connaissances. Votre assistant peut créer de nouveaux documents Nexus globaux, ajouter des sections au format Markdown, réécrire des contenus ou supprimer des documents.
"Crée un nouveau document Nexus intitulé 'Architecture API' détaillant les endpoints convenus."
🏷️ Drapeaux Réutilisables & Harmonie des Couleurs : Consultez et créez des drapeaux personnalisés dans vos domaines. L'assistant peut vérifier les couleurs existantes (list_flags), composer des nuances distinctes à la demande (comme une teinte d'orange unique) ou générer automatiquement des contrastes équilibrés.
"Liste les drapeaux de ce domaine et crée un nouveau drapeau 'Revue' avec une nuance d'orange différente des existants."
🧭 Navigation visuelle interactive : Demandez à l'IA de localiser un élément ou d'ouvrir des documents. Noust déplace automatiquement la caméra, adapte le zoom et met en valeur la note avec un effet lumineux, ou ouvre et focalise directement les documents Nexus.
"Montre-moi sur l'écran où se trouvent les objectifs du sprint marketing."
🖼️ Vision multimodale pour les images intégrées : Les modèles dotés de capacités visuelles (Claude 3.5 Sonnet, GPT-4o, Gemini) peuvent analyser les images, croquis et diagrammes intégrés à vos notes.
📦 Contexte Direct via les Ressources MCP : Au lieu d'exécuter des appels d'outils, les modèles et clients d'IA peuvent directement intégrer les données de l'espace de travail actif, le contenu des notes ou les documents Nexus dans leur fenêtre de contexte via les URI de ressources standards MCP (noust://).
"Inspecte noust://workspace/active pour comprendre l'organisation des domaines avant de formuler des recommandations."
🗂️ Routage Multi-Workspace et Inter-Onglets : Travaillez simultanément sur plusieurs workspaces ouverts. L'assistant IA peut inspecter les onglets actifs, cibler un workspace spécifique par son nom via le paramètre workspace, ou interagir en toute transparence avec le dossier local ancré.
"Liste mes workspaces actifs et ajoute une note de version dans le workspace 'Mobile App'."

Architecture Dual-Mode (En ligne & Hors ligne)

@noust-app/mcp est conçu pour fonctionner de manière résiliente, que Noust soit ouvert ou fermé :

Mode Hors ligne (Fichier local) : Lorsque Noust est fermé, le serveur MCP lit directement le fichier .noust sur votre disque. L'IA peut effectuer des recherches, récupérer des notes et analyser des images complètement hors ligne.
Mode En direct (Pont WebSocket Zero-Trust) : Lorsque Noust est ouvert dans un navigateur Chromium avec la synchronisation locale et MCP activés (panneau Agent dans le Menu Shell), un pont WebSocket local éphémère (127.0.0.1:8421) s'active automatiquement pour autoriser les modifications en direct.

Espaces de travail chiffrés

Si le fichier .noust est chiffré avec le mot de passe de l'utilisateur, le serveur MCP ne fonctionnera que lorsque Noust est ouvert et actif dans le navigateur. De cette manière, les agents d'IA ne peuvent pas lire le contenu du fichier .noust directement depuis le disque et sont strictement contraints d'utiliser les outils officiels via le serveur MCP.

Routage Multi-Workspace et Inter-Onglets

Noust permet d'ouvrir différents workspaces simultanément dans plusieurs onglets de navigateur, chacun lié à son propre dossier local. @noust-app/mcp gère les environnements multi-workspaces de manière propre et prévisible :

Ancrage de Workspace Local : Lorsque le serveur MCP est démarré avec --workspace <dossier>, il détecte le fichier .noust local dans ce répertoire. Si un onglet de navigateur synchronise ce workspace, toutes les opérations ciblent automatiquement cet onglet par défaut.
Onglet Actif Unique : Si un seul onglet de workspace est actif dans votre navigateur, les opérations sont automatiquement dirigées vers lui sans nécessiter de paramètre de workspace explicite.
Désambiguïsation Inter-Onglets : Lorsque plusieurs workspaces sont actifs dans différents onglets du navigateur et que le client s'exécute en dehors du répertoire d'un workspace spécifique (ou cible un autre onglet), tous les outils acceptent un paramètre optionnel workspace. En cas d'ambiguïté, le serveur liste les noms des workspaces actifs et invite l'assistant à spécifier quel workspace doit être inspecté ou modifié.
Inspection du Statut des Workspaces : L'outil get_workspace_status indique toutes les sessions de navigateur actives, les workspaces connectés et la cible par défaut actuelle.

Ressources Standards MCP (Resources)

En plus des outils exécutables (tools), @noust-app/mcp implémente la spécification officielle des Ressources du Model Context Protocol (resources/list et resources/read). Cela permet aux clients d'IA compatibles—comme Claude Desktop, Cursor et Antigravity—d'inspecter l'état du workspace ou d'attacher directement des notes et des documents au contexte du prompt sans le coût d'appels d'outils :

URI de la Ressource	Type	Format	Description
`noust://workspace/active`	Statique	JSON (`application/json`)	Vue d'ensemble complète du workspace actif : ID, nom, domaines, nombre de notes, documents Nexus et statut du pont en direct.
`noust://notes/{noteId}`	Modèle Dynamique	Markdown (`text/markdown`)	Contenu complet d'une note du canevas au format Markdown propre (avec titre, domaine, référence canevas `1A1` et corps). Listé automatiquement via `resources/list`.
`noust://documents/{docId}`	Modèle Dynamique	Markdown (`text/markdown`)	Contenu complet d'un document markdown Nexus Pages (avec titre et corps). Listé automatiquement via `resources/list`.
`noust://objectives/active`	Statique	JSON (`application/json`)	Liste en temps réel de tous les objectifs, jalons, catégories et drapeaux actifs dans le workspace.

Découverte Automatique des Ressources & Dual-Mode

Saisie semi-automatique du contexte dans les IDE : Les clients compatibles avec resources/list affichent automatiquement toutes les notes et documents Nexus dans leurs sélecteurs de ressources (comme les mentions @ dans Cursor ou l'explorateur de ressources de Claude Desktop).
Continuité Dual-Mode : Si Noust est ouvert dans votre navigateur avec le pont activé, les ressources reflètent l'état dynamique en mémoire. Lorsque Noust est fermé, les ressources sont directement lues depuis le fichier local .noust sur votre disque.

Configuration rapide dans vos clients IA

Aucune installation globale n'est nécessaire. Les clients MCP exécutent le serveur à la demande via npx.

Prérequis

Node.js >= 18.0.0 installé sur votre machine.
Un espace de travail Noust lié à un dossier local via la Synchronisation locale automatique.
Activer le Pont MCP dans Noust dans le panneau Agent du Menu Shell.

1. Claude Desktop

Ajoutez noust au fichier de configuration de Claude Desktop :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%\Claude\claude_desktop_config.json
Linux : ~/.config/Claude/claude_desktop_config.json

json

{
  "mcpServers": {
    "noust": {
      "command": "npx",
      "args": [
        "-y",
        "@noust-app/mcp",
        "--workspace",
        "/chemin/absolu/vers/votre/dossier-noust"
      ]
    }
  }
}

Formatage des chemins sous Windows

Dans les fichiers de configuration JSON sous Windows, les chemins doivent utiliser des barres obliques inverses doubles (ex. : "C:\\Users\\VotreNom\\Documents\\Noust") ou des barres obliques simples (ex. : "C:/Users/VotreNom/Documents/Noust").

2. Cursor IDE

Ajoutez noust dans .cursor/mcp.json ou dans Settings > Features > MCP Servers :

json

{
  "mcpServers": {
    "noust": {
      "command": "npx",
      "args": [
        "-y",
        "@noust-app/mcp",
        "--workspace",
        "/chemin/absolu/vers/votre/dossier-noust"
      ]
    }
  }
}

Sécurité et Confidentialité (Zero-Knowledge)

Modèles d'IA dans le cloud et confidentialité des données

Bien que Noust et @noust-app/mcp fonctionnent à 100% localement sur votre machine (127.0.0.1) et ne transmettent jamais vos notes ou données aux serveurs de Noust, toute information lue ou extraite par les outils MCP (search_workspace, get_note, get_document, get_objective, etc.) devient le contexte de requête de votre assistant d'IA.

Si votre assistant est connecté à des modèles de cloud tiers (comme Claude/Anthropic, ChatGPT/OpenAI ou Gemini/Google), les contenus de votre espace de travail consultés sont transmis via Internet aux serveurs de ces fournisseurs selon leurs politiques de confidentialité et leurs conditions de conservation.

Pour les environnements soumis à une souveraineté stricte des données ou traitant des informations confidentielles, configurez votre client MCP pour utiliser des LLM locaux et auto-hébergés (par exemple via Ollama, LM Studio ou des modèles open-source locaux).

@noust-app/mcp respecte des principes rigoureux de sécurité locale :

100% Bouclage local : Tout le trafic reste strictement confiné à 127.0.0.1. Aucune donnée n'est transmise à l'extérieur.
Jeton éphémère à secret partagé : Chaque session génère un jeton aléatoire de 256 bits (.noust-bridge.token) protégé par les permissions 0600.
Assainissement des entrées : Tous les contenus générés par l'IA sont automatiquement traités par DOMPurify afin d'éviter toute injection de script (XSS).
Espaces de travail chiffrés : Si le fichier .noust est chiffré avec le mot de passe de l'utilisateur, le serveur MCP ne fonctionnera que lorsque Noust est ouvert et actif dans le navigateur. De cette manière, les agents d'IA ne peuvent pas lire le contenu du fichier .noust directement depuis le disque et sont strictement contraints d'utiliser les outils officiels via le serveur MCP.

Documentation technique et code source

Pour les développeurs, les options CLI (-d / -r) et la spécification des outils, consultez le dépôt officiel :

🔗 GitHub: noust-app/mcp

Model Context Protocol (MCP) ​

Que peut faire l'IA dans votre espace de travail ? ​

Architecture Dual-Mode (En ligne & Hors ligne) ​

Routage Multi-Workspace et Inter-Onglets ​

Ressources Standards MCP (Resources) ​

Découverte Automatique des Ressources & Dual-Mode ​

Configuration rapide dans vos clients IA ​

Prérequis ​

1. Claude Desktop ​

2. Cursor IDE ​

Sécurité et Confidentialité (Zero-Knowledge) ​

Documentation technique et code source ​