GitScrum / Docs

Wiki

Gestión de wiki a través de MCP. Crea, organiza y busca páginas wiki de proyecto para documentación de equipo y bases de conocimiento.

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.

La herramienta wiki proporciona 5 acciones para crear, organizar y buscar páginas wiki de proyecto. Las wikis son la documentación viva de tu equipo — guías de onboarding, decisiones de arquitectura, referencias de API, runbooks y documentación de procesos que permanece dentro del contexto del proyecto y evoluciona con el código.

Las páginas wiki soportan contenido completo en Markdown y organización jerárquica a través de relaciones padre-hijo. Tu asistente de IA puede crear estructuras completas de documentación, actualizar páginas existentes y buscar dentro del contenido wiki — todo a través de conversación en lenguaje natural.


Resumen de acciones

AcciónPropósitoParámetros requeridos
listListar todas las páginas wiki de un proyectocompanyslug, projectslug
getObtener el contenido completo de una página wiki específicauuid, companyslug, projectslug
createCrear una nueva página wikicompanyslug, projectslug, title, content
updateModificar el título o contenido de una página wiki existenteuuid, companyslug, projectslug
searchBuscar contenido wiki por palabra clavecompanyslug, projectslug, q

Listar páginas wiki

La acción list devuelve todas las páginas wiki dentro de un proyecto. Cada página en la respuesta incluye su uuid, título, autor, fecha de creación y referencia a la página padre — dándote la estructura completa del árbol de páginas.

Parámetros requeridos

ParámetroTipoDescripción
company_slugstringIdentificador del workspace (de la herramienta workspace)
project_slugstringIdentificador del proyecto (de la herramienta project)
You:  "Lista todas las páginas wiki del proyecto Backend"
AI:   Llama a wiki action=list → devuelve el árbol de páginas con títulos y jerarquía

You:  "Muéstrame la estructura de documentación del proyecto Mobile App"
AI:   Llama a wiki action=list → muestra las páginas organizadas por relaciones padre-hijo

You:  "¿Qué documentación existe en este proyecto?"
AI:   Llama a wiki action=list → resume las páginas wiki disponibles

Obtener contenido de una página wiki

La acción get devuelve la página wiki completa — título, contenido en Markdown, autor, marcas de tiempo y referencia a la página padre. Así es como lees una página de documentación específica.

Parámetros requeridos

ParámetroTipoDescripción
uuidstringUUID de la página wiki (de la respuesta de list o search)
company_slugstringIdentificador del workspace
project_slugstringIdentificador del proyecto
You:  "Muéstrame la página wiki de la guía de onboarding"
AI:   Encuentra la página del listado → llama a wiki action=get → devuelve contenido completo en Markdown

You:  "Lee la documentación de referencia de API"
AI:   Llama a wiki action=get → devuelve el contenido completo de la página

You:  "¿Qué dice el runbook de despliegue?"
AI:   Encuentra la página → llama a wiki action=get → resume o muestra el contenido

Crear páginas wiki

La acción create construye una nueva página wiki con un título y contenido en Markdown. Las páginas pueden crearse como documentación de nivel superior o anidadas bajo una página padre para construir estructuras jerárquicas.

Parámetros requeridos

ParámetroTipoDescripción
company_slugstringIdentificador del workspace
project_slugstringIdentificador del proyecto
titlestringTítulo de la página — descriptivo y escaneable
contentstringCuerpo de la página en formato Markdown

Parámetros opcionales

ParámetroTipoDescripción
parent_uuidstringUUID de la página wiki padre para anidar esta página debajo. Omitir para una página de nivel superior.

Ejemplos de prompts

You:  "Crea una página wiki 'Guía de Onboarding' en el proyecto Backend con
       instrucciones de configuración para nuevos desarrolladores"
AI:   Llama a wiki action=create con título y contenido completo en Markdown

You:  "Crea una página wiki 'Referencia de API REST' documentando nuestros endpoints"
AI:   Llama a wiki action=create con título y documentación estructurada de API

You:  "Agrega una página hija 'Flujo de Autenticación' bajo la sección de Arquitectura"
AI:   Encuentra el UUID de la página Arquitectura → llama a wiki action=create con parent_uuid

You:  "Crea un runbook de despliegue cubriendo los procedimientos de staging y producción"
AI:   Llama a wiki action=create con contenido detallado paso a paso en Markdown

Estructuras de páginas anidadas

Usa parent_uuid para construir jerarquías de documentación. El asistente de IA puede crear estructuras completas en una sola conversación:

You:  "Crea una sección wiki de Arquitectura con páginas hijas para
       Diseño de Base de Datos, Capa de API y Autenticación"
AI:   1. Crea "Arquitectura" como página de nivel superior
      2. Crea "Diseño de Base de Datos" con parent_uuid de Arquitectura
      3. Crea "Capa de API" con parent_uuid de Arquitectura
      4. Crea "Autenticación" con parent_uuid de Arquitectura

Actualizar páginas wiki

La acción update modifica una página wiki existente. Solo los campos que especifiques se modifican — si actualizas solo el contenido, el título permanece intacto, y viceversa.

Parámetros requeridos

ParámetroTipoDescripción
uuidstringUUID de la página wiki
company_slugstringIdentificador del workspace
project_slugstringIdentificador del proyecto

Parámetros opcionales

ParámetroTipoDescripción
titlestringTítulo actualizado de la página
contentstringCuerpo actualizado de la página en formato Markdown
You:  "Actualiza la guía de onboarding con las nuevas instrucciones del pipeline CI/CD"
AI:   Encuentra la página → llama a wiki action=update con contenido revisado en Markdown

You:  "Renombra la página de documentación de API a 'Referencia REST API v3'"
AI:   Llama a wiki action=update con title="REST API v3 Reference"

You:  "Agrega una sección sobre manejo de errores a la página wiki de referencia de API"
AI:   Obtiene el contenido actual → agrega la nueva sección → llama a wiki action=update

Buscar contenido wiki

La acción search realiza búsqueda por palabras clave en todas las páginas wiki de un proyecto. Los resultados incluyen las páginas que coinciden con sus UUIDs y títulos, permitiéndote navegar directamente a la documentación relevante.

Parámetros requeridos

ParámetroTipoDescripción
company_slugstringIdentificador del workspace
project_slugstringIdentificador del proyecto
qstringConsulta de búsqueda (mínimo 2 caracteres)

Parámetros opcionales

ParámetroTipoDescripción
limitnumberMáximo de resultados a devolver (1-50)
You:  "Busca en la wiki 'migración de base de datos'"
AI:   Llama a wiki action=search con q="database migration" → devuelve páginas coincidentes

You:  "Encuentra páginas wiki sobre autenticación"
AI:   Llama a wiki action=search con q="authentication" → lista documentación relevante

You:  "¿Hay documentación sobre el proceso de despliegue?"
AI:   Llama a wiki action=search con q="deployment" → devuelve páginas coincidentes o vacío

You:  "Busca 'API' en la documentación del proyecto, muestra los 5 primeros resultados"
AI:   Llama a wiki action=search con q="API", limit=5

Patrones de base de conocimiento

Las wikis son más efectivas cuando se organizan alrededor de patrones predecibles. Aquí hay estructuras recomendadas para proyectos técnicos:

Estructura de documentación de proyecto

📄 Descripción General
  📄 Arquitectura
    📄 Diseño de Base de Datos
    📄 Capa de API
    📄 Autenticación
  📄 Primeros Pasos
    📄 Configuración Local
    📄 Variables de Entorno
    📄 Ejecutar Pruebas
  📄 Despliegue
    📄 Runbook de Staging
    📄 Runbook de Producción
    📄 Procedimientos de Rollback
  📄 Referencia de API
    📄 Endpoints
    📄 Códigos de Error
    📄 Límites de Tasa

Construir la estructura

Tu asistente de IA puede crear una estructura completa de documentación en una sola conversación:

You:  "Crea una wiki de documentación completa para el proyecto Backend. Incluye
       secciones para Arquitectura, Primeros Pasos, Despliegue y Referencia de API.
       Cada sección debe tener páginas hijas relevantes."
AI:   Crea 10-15 páginas wiki con relaciones jerárquicas parent_uuid,
      llenando cada una con contenido inicial

Mantener la documentación actualizada

Actualiza las páginas a medida que evoluciona el código. La acción de búsqueda ayuda a encontrar páginas que necesitan revisión:

You:  "Busca en la wiki referencias al antiguo endpoint de autenticación"
AI:   Llama a wiki action=search con q="auth" → identifica las páginas a actualizar

You:  "Actualiza todas las páginas wiki que referencian la API v2 para apuntar a v3"
AI:   Busca → lee cada página → actualiza las referencias

Wiki vs Discusiones vs NoteVault

Elige la herramienta adecuada para el tipo de contenido:

AspectoWiki (esta herramienta)DiscusionesNoteVault
AlcanceDocumentación a nivel de proyectoConversaciones a nivel de proyectoNotas personales/compartidas
EstructuraPáginas jerárquicasComentarios con hilosNotas organizadas en carpetas
Ciclo de vidaLarga duración, evoluciona con el tiempoAbiertas → cerradas cuando se resuelvenEspacio de trabajo personal
Ideal paraGuías de onboarding, runbooks, referenciasDecisiones, propuestas, debatesNotas de reuniones, borradores, notas rápidas

Resolución automática de contexto

La herramienta wiki soporta resolución automática de contexto. Si tu asistente de IA ya conoce el workspace y proyecto de una llamada anterior en la conversación, puedes decir "crea una página wiki" sin especificar el proyecto — el contexto se mantiene.


Próximos pasos

  • NoteVault: Gestiona notas personales y compartidas con organización por carpetas.
  • Discusiones: Crea canales de discusión con hilos para decisiones del equipo.
  • Búsqueda: Busca en todas las entidades de GitScrum incluyendo páginas wiki.
  • Inicio Rápido: Configura el servidor MCP si aún no lo has hecho.