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ón | Propósito | Parámetros requeridos |
|---|---|---|
list | Listar todas las páginas wiki de un proyecto | companyslug, projectslug |
get | Obtener el contenido completo de una página wiki específica | uuid, companyslug, projectslug |
create | Crear una nueva página wiki | companyslug, projectslug, title, content |
update | Modificar el título o contenido de una página wiki existente | uuid, companyslug, projectslug |
search | Buscar contenido wiki por palabra clave | companyslug, 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ámetro | Tipo | Descripción |
|---|---|---|
company_slug | string | Identificador del workspace (de la herramienta workspace) |
project_slug | string | Identificador 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 disponiblesObtener 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ámetro | Tipo | Descripción |
|---|---|---|
uuid | string | UUID de la página wiki (de la respuesta de list o search) |
company_slug | string | Identificador del workspace |
project_slug | string | Identificador 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 contenidoCrear 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ámetro | Tipo | Descripción |
|---|---|---|
company_slug | string | Identificador del workspace |
project_slug | string | Identificador del proyecto |
title | string | Título de la página — descriptivo y escaneable |
content | string | Cuerpo de la página en formato Markdown |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
parent_uuid | string | UUID 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 MarkdownEstructuras 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 ArquitecturaActualizar 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ámetro | Tipo | Descripción |
|---|---|---|
uuid | string | UUID de la página wiki |
company_slug | string | Identificador del workspace |
project_slug | string | Identificador del proyecto |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
title | string | Título actualizado de la página |
content | string | Cuerpo 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=updateBuscar 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ámetro | Tipo | Descripción |
|---|---|---|
company_slug | string | Identificador del workspace |
project_slug | string | Identificador del proyecto |
q | string | Consulta de búsqueda (mínimo 2 caracteres) |
Parámetros opcionales
| Parámetro | Tipo | Descripción |
|---|---|---|
limit | number | Má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=5Patrones 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 TasaConstruir 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 inicialMantener 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 referenciasWiki vs Discusiones vs NoteVault
Elige la herramienta adecuada para el tipo de contenido:
| Aspecto | Wiki (esta herramienta) | Discusiones | NoteVault |
|---|---|---|---|
| Alcance | Documentación a nivel de proyecto | Conversaciones a nivel de proyecto | Notas personales/compartidas |
| Estructura | Páginas jerárquicas | Comentarios con hilos | Notas organizadas en carpetas |
| Ciclo de vida | Larga duración, evoluciona con el tiempo | Abiertas → cerradas cuando se resuelven | Espacio de trabajo personal |
| Ideal para | Guías de onboarding, runbooks, referencias | Decisiones, propuestas, debates | Notas 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.