Model Context Protocol (MCP)

Conecte asistentes de IA externos—incluyendo Claude Desktop, Cursor, Antigravity, Windsurf y VS Code—directamente a sus espacios de trabajo locales de Noust en tiempo real.

El servidor oficial @noust-app/mcp proporciona comunicación bidireccional segura y 100% local entre modelos de IA y sus notas, documentos markdown de Nexus Pages y la topología del lienzo.

---

¿Qué Puede Hacer la IA en su Espacio de Trabajo?

En lugar de copiar y pegar notas en un chat, MCP le otorga a su asistente de IA acceso autónomo y contextual para interactuar con su lienzo:

• 🔍 Búsqueda y Consulta Inteligente: Pida al asistente que busque notas, páginas de Nexus u objetivos. El modelo recupera el contenido completo sin recortes, ignorando etiquetas de formato HTML/CSS.

  "Busca en mi espacio de trabajo de Noust la lista de verificación de despliegue y resume las tareas pendientes."

• ✍️ Creación, Edición y Eliminación en el Lienzo en Tiempo Real: La IA puede crear nuevas tarjetas de notas, actualizar texto existente o eliminar notas obsoletas en vivo en su pantalla mientras usted observa.

  "Crea una nueva nota en mi lienzo con los 3 puntos principales que acordamos en esta conversación."

• 🎯 Gestión de Objetivos y Metas: Supervise el progreso de sus proyectos de forma autónoma. Los modelos de IA pueden crear nuevos objetivos, actualizar plazos, prioridades, marcar tareas como completadas, añadir avances o eliminar elementos.

  "Añade un objetivo de alta prioridad para desplegar staging antes del viernes y marca la meta anterior de migración como completada."

• 📄 Control Total de Documentos Nexus: Estructure bases de conocimiento ricas sin esfuerzo. Su asistente puede crear nuevos documentos globales de Nexus, añadir secciones en Markdown, modificar contenidos o eliminar documentos.

  "Crea un nuevo documento en Nexus titulado 'Arquitectura de API' detallando los endpoints acordados."

• 🏷️ Etiquetas Reutilizables y Armonía de Color: Consulte y cree flags personalizadas para sus dominios. El asistente puede examinar los colores existentes (list_flags), elegir tonalidades distintivas a petición (por ejemplo, un tono de naranja único) o generar paletas contrastantes automáticamente.

  "Lista las flags de este dominio y crea una nueva flag 'Revisión' con un tono de naranja diferente a los existentes."

• 🧭 Navegación Visual Interactiva: Pida a la IA que localice cualquier elemento o abra documentos. Noust desplaza la vista, ajusta el zoom y resalta notas con brillo en su pantalla, o abre y enfoca documentos de Nexus directamente.

  "Muéstrame en la pantalla dónde están los objetivos del sprint de marketing."

• 🖼️ Visión Multimodal para Imágenes Adjuntas: Los modelos con capacidad de visión (Claude 3.5 Sonnet, GPT-4o, Gemini) pueden analizar imágenes, diagramas y capturas adjuntas a sus notas.
• 📦 Contexto Directo mediante Recursos MCP: En lugar de ejecutar llamadas a herramientas, los modelos y clientes de IA pueden adjuntar datos del espacio de trabajo activo, contenidos de notas o documentos Nexus directamente a la ventana de contexto mediante URIs estándar de recursos MCP (noust://).

  "Inspecciona noust://workspace/active para comprender la estructura de dominios antes de proponer cambios."

• 🗂️ Enrutamiento Multi-Workspace y Entre Pestañas: Trabaje en múltiples workspaces abiertos simultáneamente. El asistente de IA puede inspeccionar pestañas activas, dirigir acciones a un workspace específico por nombre mediante el parámetro workspace, o interactuar directamente con la carpeta local anclada.

  "Lista mis workspaces activos y añade una nota de versión en el workspace 'Mobile App'."

---

Arquitectura Dual-Mode (Online y Offline)

@noust-app/mcp está diseñado para ser resiliente tanto si Noust está abierto como cerrado:

1. Modo Offline (Directo de Disco): Quando Noust está cerrado, el servidor MCP lee directamente el archivo .noust guardado en su carpeta local. La IA puede realizar búsquedas de texto profundas, recuperar notas por ID o referencia amigable (ej.: 1A1) e inspeccionar imágenes completamente fuera de línea.
2. Modo En Vivo (WebSocket Bridge Zero-Trust): Cuando Noust está abierto en un navegador Chromium con sincronización local y MCP activados (panel Agent en el Menu Shell), se activa automáticamente un puente WebSocket local efímero (127.0.0.1:8421). La IA puede crear notas, editarlas y navegar por el lienzo al instante.

Espacios de Trabajo Cifrados

Si el archivo .noust está cifrado con la contraseña del usuario, el servidor MCP solo funcionará con Noust abierto y activo en el navegador. De esta manera, los agentes de IA no pueden leer el contenido de .noust directamente desde el disco y se ven estrictamente forzados a utilizar las herramientas oficiales a través de MCP Server.

Enrutamiento Multi-Workspace y Entre Pestañas

Noust permite abrir diferentes workspaces simultáneamente en varias pestañas del navegador, cada una vinculada a su propia carpeta local. @noust-app/mcp gestiona entornos multi-workspace de forma limpia y predecible:

• Ancla de Workspace Local: Cuando el servidor MCP se inicia con --workspace <carpeta>, detecta el archivo .noust local en dicho directorio. Si una pestaña del navegador está sincronizando ese workspace, todas las operaciones se dirigen automáticamente a esa pestaña por defecto.
• Pestaña Única Activa: Si solo hay una pestaña de workspace activa en su navegador, las operaciones se dirigen a ella automáticamente sin requerir un parámetro de workspace explícito.
• Desambiguación Entre Pestañas: Cuando hay múltiples workspaces activos en diferentes pestañas del navegador y el cliente se ejecuta fuera del directorio de un workspace específico (o apunta a otra pestaña), todas las herramientas aceptan un parámetro opcional workspace. En caso de ambigüedad, el servidor lista los nombres de los workspaces activos y orienta al asistente para que especifique cuál workspace debe inspeccionarse o modificarse.
• Inspección de Estado de Workspaces: La herramienta get_workspace_status informa sobre todas las sesiones activas del navegador, los workspaces conectados y el objetivo predeterminado actual.

---

Recursos Estándar de MCP (Resources)

Más allá de herramientas ejecutables (tools), @noust-app/mcp implementa la especificación oficial de Recursos del Model Context Protocol (resources/list e resources/read). Esto permite que clientes de IA compatibles—como Claude Desktop, Cursor y Antigravity—inspeccionen el estado del espacio de trabajo o adjunten notas y documentos directamente al contexto del prompt sin la sobrecarga de invocar herramientas:

URI del Recurso	Tipo	Formato	Descripción
noust://workspace/active	Estático	JSON (application/json)	Resumen completo del espacio de trabajo activo: ID, nombre, dominios, recuento de notas, documentos de Nexus y estado de conexión en vivo.
noust://notes/{noteId}	Plantilla Dinámica	Markdown (text/markdown)	Contenido completo de una nota del lienzo formateado en Markdown limpio (con título, dominio, referencia en el lienzo 1A1 y cuerpo). Listado automáticamente mediante resources/list.
noust://documents/{docId}	Plantilla Dinámica	Markdown (text/markdown)	Contenido completo de un documento markdown de Nexus Pages (con título y cuerpo). Listado automáticamente mediante resources/list.
noust://objectives/active	Estático	JSON (application/json)	Lista en tiempo real de todos los objetivos, metas, categorías y flags asignadas en el espacio de trabajo.

Descubrimiento Automático de Recursos y Dual-Mode

• Autocompletado de Contexto en IDEs: Los clientes compatibles con resources/list muestran automáticamente todas las notas y documentos de Nexus en sus selectores de recursos (como las menciones @ en Cursor o el explorador de recursos de Claude Desktop).
• Continuidad Dual-Mode: Si Noust está abierto en el navegador con el bridge activado, los recursos reflejan el estado dinámico en memoria. Si Noust está cerrado, los recursos se cargan directamente desde el archivo .noust local en disco.

---

Configuración Rápida en Asistentes

No necesita instalar nada globalmente. Los clientes MCP ejecutan el servidor bajo demanda a través de npx.

Requisitos Previos

1. Node.js >= 18.0.0 instalado en el equipo.
2. Un espacio de trabajo de Noust vinculado a una carpeta local mediante Sincronización Local Automática.
3. Activar el Puente MCP en Noust en el panel Agent del Menu Shell.

1. Claude Desktop

Añada noust al archivo de configuración 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

{
  "mcpServers": {
    "noust": {
      "command": "npx",
      "args": [
        "-y",
        "@noust-app/mcp",
        "--workspace",
        "/ruta/absoluta/a/su/carpeta-de-noust"
      ]
    }
  }
}

Formato de Rutas en Windows

En archivos de configuración JSON en Windows, las rutas deben usar barras invertidas dobles (ej.: "C:\\Users\\SuNombre\\Documents\\Noust") o barras inclinadas normales (ej.: "C:/Users/SuNombre/Documents/Noust") para evitar errores de sintaxis JSON.

2. Cursor IDE

Añada noust a .cursor/mcp.json o en Settings > Features > MCP Servers:

{
  "mcpServers": {
    "noust": {
      "command": "npx",
      "args": [
        "-y",
        "@noust-app/mcp",
        "--workspace",
        "/ruta/absoluta/a/su/carpeta-de-noust"
      ]
    }
  }
}

---

Seguridad y Privacidad (Zero-Knowledge)

Modelos de IA en la Nube y Privacidad de Datos

Aunque Noust y @noust-app/mcp operan 100% localmente en su máquina (127.0.0.1) e nunca transmiten sus notas o datos a los servidores de Noust, cualquier información consultada por las herramientas de MCP (search_workspace, get_note, get_document, get_objective, etc.) se convierte en contexto en el prompt de su asistente de IA.

Si su asistente está configurado para usar modelos en la nube de terceros (como Claude/Anthropic, ChatGPT/OpenAI o Gemini/Google), el contenido recuperado de su espacio de trabajo se enviará a través de Internet a los servidores de dicho proveedor según sus términos y políticas de privacidad.

Para entornos con requisitos estrictos de soberanía de datos o información altamente confidencial, configure su cliente MCP para utilizar modelos de IA locales y autohospedados (por ejemplo, mediante Ollama, LM Studio o modelos locales de código abierto).

@noust-app/mcp sigue estrictos principios de seguridad local-first:

• 100% Loopback Local: Todo el tráfico se limita a 127.0.0.1. Ninguna nota, token o metadato se transmite a servidores externos.
• Token Efímero de Secreto Compartido: Cada sesión genera un token aleatorio de 256 bits (.noust-bridge.token) protegido con permisos de archivo 0600.
• Confinamiento Canónico de Rutas: El servidor valida rutas reales (realpath) y se niega categóricamente a acceder a archivos fuera del directorio autorizado o sin la extensión .noust.
• Sanitización de Entradas: Todo el contenido generado por IA pasa automáticamente por DOMPurify antes de renderizarse para evitar inyecciones maliciosas de scripts (XSS).
• Espacios de Trabajo Cifrados: Si el archivo .noust está cifrado con la contraseña del usuario, el servidor MCP solo funcionará con Noust abierto y activo en el navegador. De esta manera, los agentes de IA no pueden leer el contenido de .noust directamente desde el disco y se ven estrictamente forzados a utilizar las herramientas oficiales a través de MCP Server.

---

Documentación Técnica y Código Fuente

Para desarrolladores, opciones de línea de comandos (-d / -r) y esquemas de herramientas, visite el repositorio oficial:

🔗 GitHub: noust-app/mcp