NoteVault

Código Abierto — GitScrum MCP Server es código abierto bajo la licencia MIT. Disponible en npm y en GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor y cualquier cliente compatible con MCP tienen acceso operacional completo a tu stack de gestión de proyectos.

NoteVault es tu espacio de trabajo personal y de equipo para notas — resúmenes de reuniones, retrospectivas de sprint, registros de investigación, borradores de arquitectura y todo lo que aún no pertenece a la documentación a nivel de proyecto. Dos herramientas trabajan juntas para gestionar NoteVault: la herramienta note para crear y compartir notas, y la herramienta note_folder para organizar notas en carpetas.

A diferencia de las páginas Wiki, que son documentación con alcance de proyecto, las notas de NoteVault te pertenecen. Viven en tu workspace, pueden organizarse en carpetas personales y compartirse con miembros específicos del equipo cuando estén listas. El seguimiento de revisiones te permite revisar versiones anteriores de cualquier nota.

Herramienta Note — Resumen de acciones

La herramienta note proporciona 6 acciones para el ciclo de vida completo de las notas:

Herramienta Note Folder — Resumen de acciones

La herramienta note_folder proporciona 4 acciones para gestión de carpetas:

Listar notas

La acción list devuelve todas las notas en tu workspace. Cada nota en la respuesta incluye su uuid, título, asignación de carpeta, fecha de creación y estado de compartido.

Parámetros requeridos

You:  "Muestra todas mis notas"
AI:   Llama a note action=list → devuelve tu inventario completo de notas

You:  "Lista mis notas en el workspace Acme"
AI:   Llama a note action=list con company_slug → devuelve las notas del workspace

You:  "¿Qué notas tengo?"
AI:   Llama a note action=list → resume tus notas por carpeta y fecha

Crear notas

La acción create construye una nueva nota con un título y contenido en Markdown. Las notas se crean en tu workspace personal — son privadas hasta que se compartan explícitamente.

Parámetros requeridos

Ejemplos de prompts

You:  "Crea una nota 'Retrospectiva Sprint 14' con notas de la reunión de hoy"
AI:   Llama a note action=create con título y contenido en Markdown

You:  "Crea una nota sobre la investigación de migración de base de datos que he estado haciendo"
AI:   Llama a note action=create con notas de investigación formateadas en Markdown

You:  "Toma nota: 'Reunión con Cliente — acordamos el roadmap de Q2,
       la prioridad es el lanzamiento de la app móvil para marzo'"
AI:   Llama a note action=create con notas de la reunión

You:  "Crea una nota resumiendo las opciones de arquitectura que discutimos"
AI:   Llama a note action=create con comparación estructurada en Markdown

Actualizar notas

La acción update modifica el título o contenido de una nota. Solo los campos que especifiques se modifican.

Parámetros requeridos

Parámetros opcionales

You:  "Actualiza mi nota de retrospectiva con los elementos de acción que acordamos"
AI:   Encuentra la nota → llama a note action=update con contenido revisado

You:  "Agrega una sección de seguimiento a mis notas de la reunión con el cliente"
AI:   Obtiene el contenido actual → agrega el seguimiento → llama a note action=update

You:  "Renombra mi nota de investigación a 'Migración de Base de Datos — Recomendación Final'"
AI:   Llama a note action=update con el título

Compartir notas

La acción share hace visible una nota para miembros específicos del equipo por nombre de usuario. Las notas compartidas aparecen en la lista de notas del destinatario, permitiendo revisión colaborativa.

Parámetros requeridos

Parámetros

You:  "Comparte mi nota de retrospectiva con @sarah y @john"
AI:   Llama a note action=share con usernames=["sarah", "john"]

You:  "Comparte la nota de investigación de arquitectura con el equipo de backend"
AI:   Resuelve los miembros del equipo → llama a note action=share con sus nombres de usuario

You:  "Comparte mis notas de la reunión con el project manager"
AI:   Identifica al PM → llama a note action=share con su nombre de usuario

Historial de revisiones

La acción revisions devuelve el historial de versiones de una nota — cada vez que se actualizó el contenido, se registra una revisión. Esto te permite rastrear cómo evolucionó una nota a lo largo del tiempo y hacer referencia a versiones anteriores.

Parámetros requeridos

You:  "Muestra el historial de revisiones de mi nota de arquitectura"
AI:   Llama a note action=revisions → devuelve lista de revisiones con marcas de tiempo

You:  "¿Cuántas veces se ha actualizado la nota de onboarding?"
AI:   Llama a note action=revisions → cuenta las revisiones

You:  "¿Cómo se veían las notas de la reunión antes de la última edición?"
AI:   Llama a note action=revisions → devuelve el contenido de la versión anterior

Gestionar carpetas

Las carpetas de notas organizan tus notas en grupos lógicos. La herramienta note_folder maneja la creación, renombrado y movimiento de notas entre carpetas.

Listar carpetas

Devuelve todas las carpetas en tu workspace, cada una con su uuid y name.

You:  "Muestra mis carpetas de notas"
AI:   Llama a note_folder action=list → devuelve la lista de carpetas con UUIDs

You:  "¿Cómo están organizadas mis notas?"
AI:   Llama a note_folder action=list + note action=list → muestra la estructura de carpetas

Crear carpetas

Crea una nueva carpeta para organizar notas.

You:  "Crea una carpeta llamada 'Notas de Reuniones'"
AI:   Llama a note_folder action=create con name="Notas de Reuniones"

You:  "Crea carpetas para 'Retros de Sprint', 'Investigación' y 'Reuniones con Clientes'"
AI:   Llama a note_folder action=create tres veces con cada nombre

Renombrar carpetas

Actualiza el nombre de una carpeta existente.

You:  "Renombra la carpeta 'Notas de Reuniones' a 'Reuniones de Equipo'"
AI:   Encuentra la carpeta → llama a note_folder action=update con name="Reuniones de Equipo"

Mover notas

Mueve una nota a una carpeta, o la saca de una carpeta (desarchivándola). Omite folder_uuid para remover una nota de su carpeta actual.

You:  "Mueve mi nota de retrospectiva a la carpeta Retros de Sprint"
AI:   Encuentra nota + carpeta → llama a note_folder action=move con ambos UUIDs

You:  "Desarchiva la nota de arquitectura — quítala de su carpeta"
AI:   Llama a note_folder action=move con note_uuid solamente (sin folder_uuid)

You:  "Mueve todas las notas de reuniones a la carpeta Reuniones de Equipo"
AI:   Lista las notas → identifica las de reuniones → llama a move para cada una

Flujo de organización de carpetas

Construye un espacio de trabajo personal estructurado para gestión eficiente de notas:

1. Configurar la estructura de carpetas

Crea carpetas que coincidan con tus patrones de trabajo.

You:  "Crea carpetas de notas: 'Retros de Sprint', 'Reuniones con Clientes',
       'Investigación', 'Decisiones de Arquitectura'"
AI:   Crea cuatro carpetas en secuencia

2. Crear y organizar notas

Crea notas y archívalas inmediatamente, u organiza notas existentes.

You:  "Crea una nota 'Retro Sprint 14' con el feedback de la retrospectiva de hoy
       y ponla en la carpeta Retros de Sprint"
AI:   Crea la nota → la mueve a la carpeta Retros de Sprint

You:  "Mueve todas mis notas sin archivar de esta semana a las carpetas correspondientes"
AI:   Lista las notas → las categoriza por contenido → mueve cada una a la carpeta adecuada

3. Compartir cuando esté lista

Comparte notas pulidas con miembros del equipo para revisión o referencia.

You:  "Comparte la nota de Retro Sprint 14 con todo el equipo de backend"
AI:   Resuelve los miembros del equipo → comparte la nota con todos los nombres de usuario

4. Rastrear la evolución

Usa el historial de revisiones para ver cómo evolucionaron las notas a lo largo de las iteraciones.

You:  "Muestra cómo cambió mi nota de decisión de arquitectura a lo largo del tiempo"
AI:   Llama a note action=revisions → muestra la línea de tiempo de revisiones

NoteVault vs Wiki vs Discusiones

Elige la herramienta de colaboración adecuada:

Flujo típico: Comienza con una nota de NoteVault para borradores e ideas de reuniones. Cuando el contenido madura, muévelo a una página Wiki para el equipo. Si un tema necesita discusión, crea un hilo de Discusión.

Resolución automática de contexto

Las herramientas note y note_folder soportan resolución automática de contexto. Si tu asistente de IA conoce el workspace de una llamada anterior, puedes decir "crea una nota" sin especificar el workspace cada vez.

Próximos pasos

• Wiki: Crea documentación a nivel de proyecto a partir de tus notas pulidas.
• Discusiones: Inicia hilos de discusión a nivel de proyecto.
• Búsqueda: Encuentra contenido en todas las entidades de GitScrum.
• Inicio Rápido: Configura el servidor MCP si aún no lo has hecho.