Model Context Protocol (MCP)

Verbinden Sie externe KI-Assistenten wie Claude Desktop, Cursor, Antigravity, Windsurf und VS Code in Echtzeit direkt mit Ihren lokalen Noust-Arbeitsbereichen.

Der offizielle @noust-app/mcp-Server ermöglicht eine sichere, 100% lokale bidirektionale Kommunikation zwischen KI-Modellen und Ihren Notizen, Nexus-Markdown-Dokumenten und der Canvas-Topologie.

Was kann die KI in Ihrem Arbeitsbereich tun?

Statt Notizen manuell in Chatfenster zu kopieren, ermöglicht MCP der KI einen direkten und kontextbezogenen Zugriff auf Ihr Board:

🔍 Intelligente Suche & Abfrage: Bitten Sie den Assistenten, Notizen, Nexus-Seiten oder Ziele zu durchsuchen. Das Modell erhält vollständige Inhalte ohne Kürzung und ohne störenden HTML-Code.
"Durchsuche meinen Noust-Arbeitsbereich nach der Deployment-Checkliste und fasse die offenen Aufgaben zusammen."
✍️ Echtzeit-Erstellung, Bearbeitung & Löschung auf dem Canvas: Die KI kann neue Notizkarten anlegen, bestehende Texte live anpassen oder veraltete Notizen direkt auf Ihrem Bildschirm entfernen.
"Erstelle eine neue Notiz auf meinem Canvas mit den 3 wichtigsten Erkenntnissen aus unserem Gespräch."
🎯 Verwaltung von Zielen & Meilensteinen: Verfolgen Sie Projektziele autonom. KI-Modelle können neue Ziele anlegen, Fristen und Prioritäten aktualisieren, Aufgaben als erledigt markieren, Fortschritte ergänzen oder Einträge löschen.
"Füge ein Ziel mit hoher Priorität hinzu, das Staging vor Freitag bereitzustellen, und markiere die vorherige Migrationsaufgabe als erledigt."
📄 Vollständige Kontrolle über Nexus-Dokumente: Strukturieren Sie umfangreiches Wissen mühelos. Ihr Assistent kann neue globale Nexus-Dokumente erstellen, Markdown-Abschnitte anhängen, Inhalte überarbeiten oder Dokumente löschen.
"Erstelle ein neues Nexus-Dokument mit dem Titel 'API-Architektur' mit den besprochenen Endpunkten."
🏷️ Wiederverwendbare Flags & Farbharmonie: Flags für Domain-Boards abfragen und anlegen. Der Assistent kann vorhandene Farben prüfen (list_flags), auf Anfrage gezielt kontrastierende Nuancen wählen (z. B. einen einzigartigen Orangeton) oder automatisch harmonische Farbtöne erzeugen.
"Liste alle Flags in dieser Domain auf und erstelle ein neues Flag 'Review' mit einem unverwechselbaren Orangeton."
🧭 Interaktive visuelle Navigation: Bitten Sie die KI, Inhalte auf dem Board zu finden oder Dokumente zu öffnen. Noust bewegt die Ansicht, passt den Zoom an, hebt Notizen mit einem Leuchteffekt hervor oder öffnet Nexus-Dokumente direkt.
"Zeige mir auf dem Bildschirm, wo sich die Marketing-Sprint-Ziele befinden."
🖼️ Multimodale Bildanalyse: Modelle mit Sehfähigkeiten (Claude 3.5 Sonnet, GPT-4o, Gemini) können eingefügte Bilder, Mockups und Diagramme in Ihren Notizen direkt analysieren.
📦 Direkter Kontext über MCP-Ressourcen: Statt Tool-Aufrufe auszuführen, können KI-Modelle und Clients Daten des aktiven Arbeitsbereichs, Notizinhalte oder Nexus-Dokumente über standardmäßige MCP-Ressourcen-URIs (noust://) direkt in das Kontextfenster einbinden.
"Analysiere noust://workspace/active, um die Domänenstruktur zu verstehen, bevor du Empfehlungen aussprichst."
🗂️ Multi-Workspace & Tab-übergreifendes Routing: Arbeiten Sie parallel in mehreren geöffneten Workspaces. Der KI-Assistent kann aktive Tabs einsehen, über den Parameter workspace gezielt einen Workspace per Namen ansteuern oder nahtlos mit dem lokal verankerten Ordner interagieren.
"Liste meine aktiven Workspaces auf und erstelle eine Release-Notiz im Workspace 'Mobile App'."

Dual-Mode-Architektur (Online & Offline)

@noust-app/mcp funktioniert zuverlässig, unabhängig davon, ob Noust geöffnet oder geschlossen ist:

Offline-Modus (Dateibasiert): Wenn Noust geschlossen ist, liest der MCP-Server direkt die lokale .noust-Datei von Ihrer Festplatte. Die KI kann Notizen durchsuchen, abrufen und Bilder analysieren.
Live-Bridge-Modus (Zero-Trust): Wenn Noust in einem Chromium-Browser mit aktivierter lokaler Synchronisierung und aktiviertem MCP (Bereich Agent im Menu Shell) geöffnet ist, verbindet sich automatisch eine lokale WebSocket-Bridge (127.0.0.1:8421). Die KI kann Notizen in Echtzeit bearbeiten und auf dem Board navigieren.

Verschlüsselte Workspaces

Wenn die .noust-Datei mit einem Benutzerpasswort verschlüsselt ist, funktioniert der MCP-Server nur, wenn Noust im Browser geöffnet und aktiv ist. Auf diese Weise können KI-Agenten den Inhalt der .noust-Datei nicht direkt von der Festplatte lesen und sind strikt darauf angewiesen, die offiziellen Tools über den MCP-Server zu nutzen.

Multi-Workspace & Tab-übergreifendes Routing

Noust unterstützt das gleichzeitige Öffnen verschiedener Workspaces in mehreren Browser-Tabs, wobei jeder Tab mit seinem eigenen lokalen Ordner verknüpft ist. @noust-app/mcp verwaltet Multi-Workspace-Umgebungen sauber und vorhersehbar:

Lokaler Workspace-Anker: Wenn der MCP-Server mit --workspace <ordner> gestartet wird, erkennt er die lokale .noust-Datei in diesem Verzeichnis. Wenn ein Browser-Tab diesen Workspace synchronisiert, zielen alle Operationen standardmäßig automatisch auf diesen Tab ab.
Einzelner aktiver Tab: Wenn nur ein Workspace-Tab in Ihrem Browser aktiv ist, werden Operationen automatisch dorthin weitergeleitet, ohne dass ein expliziter Workspace-Parameter erforderlich ist.
Tab-übergreifende Eindeutigkeit (Disambiguierung): Wenn mehrere Workspaces über Browser-Tabs hinweg aktiv sind und der Client außerhalb eines bestimmten Workspace-Verzeichnisses ausgeführt wird (oder einen anderen Tab ansteuert), akzeptieren alle Tools einen optionalen workspace-Parameter. Bei Mehrdeutigkeit listet der Server die aktiven Workspace-Namen auf und leitet den Assistenten an, anzugeben, welcher Workspace geprüft oder bearbeitet werden soll.
Workspace-Statusprüfung: Das Tool get_workspace_status meldet alle aktiven Browser-Sitzungen, verbundenen Workspaces und das aktuelle Standardziel.

Standard-MCP-Ressourcen (Resources)

Neben ausführbaren Werkzeugen (Tools) implementiert @noust-app/mcp die offizielle Spezifikation für Model Context Protocol Resources (resources/list und resources/read). Dadurch können kompatible KI-Clients—wie Claude Desktop, Cursor und Antigravity—den Arbeitsbereichsstatus abfragen oder Notizen und Dokumente ohne Tool-Aufruf direkt in den Prompt-Kontext einbinden:

Ressourcen-URI	Typ	Format	Beschreibung
`noust://workspace/active`	Statisch	JSON (`application/json`)	Vollständige Übersicht des aktiven Arbeitsbereichs: ID, Name, Domänen, Notizenanzahl, Nexus-Dokumente und Verbindungsstatus der Bridge.
`noust://notes/{noteId}`	Dynamische Vorlage	Markdown (`text/markdown`)	Vollständiger Inhalt einer Canvas-Notiz als sauberes Markdown (mit Titel, Domäne, Canvas-Referenz `1A1` und Text). Automatisch über `resources/list` auffindbar.
`noust://documents/{docId}`	Dynamische Vorlage	Markdown (`text/markdown`)	Vollständiger Inhalt eines Nexus-Markdown-Dokuments (mit Titel und Fließtext). Automatisch über `resources/list` auffindbar.
`noust://objectives/active`	Statisch	JSON (`application/json`)	Echtzeit-Liste aller aktiven Ziele, Meilensteine, Kategorien und zugewiesenen Flags im Arbeitsbereich.

Automatische Ressourcenerkennung & Dual-Mode

Kontext-Autovervollständigung in IDEs: Clients mit Unterstützung für resources/list listen automatisch alle Notizen und Nexus-Dokumente in ihren Kontext-Auswahlmenüs auf (z. B. @-Kontext in Cursor oder der Ressourcen-Browser in Claude Desktop).
Dual-Mode-Kontinuität: Ist Noust im Browser mit aktiver Bridge geöffnet, spiegeln Ressourcen den Live-Zustand wider. Ist Noust geschlossen, werden Ressourcen direkt aus der lokalen .noust-Datei von der Festplatte geladen.

Schnelleinrichtung in KI-Clients

Eine globale Installation ist nicht erforderlich. MCP-Clients starten den Server bei Bedarf über npx.

Voraussetzungen

Node.js >= 18.0.0 auf Ihrem Rechner installiert.
Ein mit einem lokalen Ordner verknüpfter Noust-Arbeitsbereich über Automatische lokale Synchronisierung.
MCP-Bridge in Noust im Bereich Agent im Menu Shell aktivieren.

1. Claude Desktop

Fügen Sie noust zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

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",
        "/absoluter/pfad/zu/ihrem/noust-ordner"
      ]
    }
  }
}

Pfadformatierung unter Windows

In JSON-Konfigurationsdateien unter Windows müssen Pfade mit doppelten Backslashes (z. B. "C:\\Users\\IhrName\\Documents\\Noust") oder normalen Schrägstrichen (z. B. "C:/Users/IhrName/Documents/Noust") angegeben werden.

2. Cursor IDE

Fügen Sie noust in .cursor/mcp.json oder unter Settings > Features > MCP Servers hinzu:

json

{
  "mcpServers": {
    "noust": {
      "command": "npx",
      "args": [
        "-y",
        "@noust-app/mcp",
        "--workspace",
        "/absoluter/pfad/zu/ihrem/noust-ordner"
      ]
    }
  }
}

Sicherheit & Datenschutz (Zero-Knowledge)

Cloud-KI-Modelle & Datenschutz

Obwohl Noust und @noust-app/mcp zu 100% lokal auf Ihrem Rechner (127.0.0.1) laufen und niemals Notizen oder Daten an Noust-Server übertragen, werden alle durch MCP-Tools abgefragten Informationen (search_workspace, get_note, get_document, get_objective usw.) Teil des Kontextes für Ihren KI-Assistenten.

Wenn Ihr Assistent mit Cloud-Modellen von Drittanbietern verbunden ist (wie Claude/Anthropic, ChatGPT/OpenAI oder Gemini/Google), werden die abgefragten Workspace-Inhalte über das Internet an die Server des jeweiligen Anbieters übertragen – gemäß dessen Datenschutzbestimmungen und Nutzungsbedingungen.

Für Umgebungen mit strengen Anforderungen an die Datensouveränität oder vertrauliche Inhalte konfigurieren Sie Ihren MCP-Client bitte so, dass lokale, selbst gehostete LLMs (z. B. über Ollama, LM Studio oder lokale Open-Source-Modelle) verwendet werden.

@noust-app/mcp folgt strengen Prinzipien für lokale Sicherheit:

100% lokales Loopback: Der gesamte Datenverkehr verbleibt auf 127.0.0.1. Es werden keine Daten an externe Server übertragen.
Flüchtiges Secret-Token: Jede Sitzung generiert ein zufälliges 256-Bit-Token (.noust-bridge.token) mit Berechtigung 0600.
Eingabebereinigung: Von externen KIs erstellte Inhalte werden automatisch über DOMPurify bereinigt, um Skriptinjektionen (XSS) auszuschließen.
Verschlüsselte Workspaces: Wenn die .noust-Datei mit einem Benutzerpasswort verschlüsselt ist, funktioniert der MCP-Server nur, wenn Noust im Browser geöffnet und aktiv ist. Auf diese Weise können KI-Agenten den Inhalt der .noust-Datei nicht direkt von der Festplatte lesen und sind strikt darauf angewiesen, die offiziellen Tools über den MCP-Server zu nutzen.

Technische Dokumentation & Quellcode

Für Entwickler, CLI-Optionen (-d / -r) und vollständige Tool-Schemas besuchen Sie das offizielle Repository:

🔗 GitHub: noust-app/mcp

Model Context Protocol (MCP) ​

Was kann die KI in Ihrem Arbeitsbereich tun? ​

Dual-Mode-Architektur (Online & Offline) ​

Multi-Workspace & Tab-übergreifendes Routing ​

Standard-MCP-Ressourcen (Resources) ​

Automatische Ressourcenerkennung & Dual-Mode ​

Schnelleinrichtung in KI-Clients ​

Voraussetzungen ​

1. Claude Desktop ​

2. Cursor IDE ​

Sicherheit & Datenschutz (Zero-Knowledge) ​

Technische Dokumentation & Quellcode ​