Búsqueda

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 search proporciona 1 acción — una búsqueda global unificada que consulta todas las entidades de GitScrum en una sola llamada. En lugar de buscar tareas, discusiones y proyectos individualmente, la herramienta de búsqueda lanza una red amplia a lo largo de todo tu workspace y devuelve resultados coincidentes de cada tipo de entidad.

Esta es la herramienta que tu asistente de IA utiliza cuando tu solicitud es exploratoria — "encuentra todo sobre autenticación", "qué tenemos relacionado con el módulo de facturación", o "busca todo en lo que @sarah trabajó". Devuelve resultados de tareas, proyectos, discusiones, historias de usuario y más, ordenados por relevancia.

Resumen de acciones

Buscar

La acción search realiza una consulta entre entidades a lo largo de tu workspace. Pasa una cadena de búsqueda y opcionalmente reduce los resultados por proyecto, tipo de entidad o cantidad de resultados.

Parámetros requeridos

Parámetros opcionales

Tipos de entidad

Al usar el parámetro type, especifica uno de estos tipos de entidad para reducir resultados:

Búsqueda básica

El uso más simple — pasa una cadena de búsqueda y obtén resultados en todos los tipos de entidad.

You:  "Busca todo sobre autenticación"
AI:   Llama a search action=search con q="authentication"
      → devuelve tareas, discusiones, páginas wiki y más coincidentes

You:  "Encuentra todo lo relacionado con el módulo de facturación"
AI:   Llama a search action=search con q="billing"
      → devuelve resultados entre entidades ordenados por relevancia

You:  "Busca 'memory leak'"
AI:   Llama a search action=search con q="memory leak"
      → devuelve tareas, comentarios y discusiones que mencionan fugas de memoria

Búsqueda con alcance

Reduce tu búsqueda a un proyecto o tipo de entidad específico para resultados más precisos.

Por proyecto

You:  "Busca 'login' en el proyecto Backend"
AI:   Llama a search action=search con q="login", project_slug="backend"
      → devuelve resultados solo del proyecto Backend

You:  "Encuentra referencias a 'payment' en el proyecto Mobile App"
AI:   Llama a search action=search con q="payment", project_slug="mobile-app"

Por tipo de entidad

You:  "Encuentra tareas relacionadas con rendimiento de API"
AI:   Llama a search action=search con q="API performance", type="task"
      → devuelve solo tareas coincidentes

You:  "Busca discusiones sobre la migración de base de datos"
AI:   Llama a search action=search con q="database migration", type="discussion"
      → devuelve solo hilos de discusión coincidentes

You:  "Encuentra páginas wiki sobre despliegue"
AI:   Llama a search action=search con q="deployment", type="wiki"
      → devuelve solo páginas wiki coincidentes

You:  "Busca historias de usuario que mencionen 'checkout flow'"
AI:   Llama a search action=search con q="checkout flow", type="user_story"

Filtros combinados

You:  "Busca tareas de 'timeout' en el proyecto Backend"
AI:   Llama a search action=search con q="timeout", type="task",
      project_slug="backend" → devuelve resultados con alcance preciso

You:  "Encuentra discusiones sobre 'auth' en el proyecto API, muestra las 5 primeras"
AI:   Llama a search action=search con q="auth", type="discussion",
      project_slug="api", per_page=5

Patrones de búsqueda multi-entidad

La búsqueda global es más poderosa cuando estás explorando un tema a través de límites de entidades. Aquí hay patrones que aprovechan la búsqueda entre entidades de manera efectiva:

Descubrimiento

Cuando no sabes dónde vive la información, busca globalmente primero, luego profundiza en resultados específicos.

You:  "¿Qué tenemos sobre OAuth2?"
AI:   Llama a search con q="OAuth2" → devuelve:
      - 3 tareas relacionadas con implementación de OAuth2
      - 1 discusión sobre estrategia de OAuth2
      - 2 páginas wiki documentando el flujo de OAuth2
      La IA resume hallazgos en todos los tipos de entidad

You:  "Encuentra todo de la semana pasada sobre el lanzamiento móvil"
AI:   Llama a search con q="mobile release" → agrega resultados de
      tareas, discusiones, comentarios y sprints

Análisis de impacto

Antes de hacer cambios, busca todas las referencias para entender el alcance del impacto.

You:  "Busca todas las referencias al endpoint de API v2"
AI:   Llama a search con q="v2 API" → identifica tareas, páginas wiki
      y discusiones que referencian el endpoint obsoleto

You:  "Encuentra todo lo que mencione la tabla user_profiles"
AI:   Llama a search con q="user_profiles" → devuelve tareas de código,
      documentación wiki y discusiones de arquitectura

Recopilación de contexto

Reúne rápidamente todo el contexto sobre un tema antes de comenzar a trabajar.

You:  "Voy a empezar a trabajar en la funcionalidad de reembolso de pagos. Encuentra todos los elementos relacionados."
AI:   Llama a search con q="payment refund" → devuelve:
      - Tareas existentes para la funcionalidad
      - Hilos de discusión con decisiones de diseño
      - Páginas wiki con documentación de arquitectura de pagos
      - Historias de usuario describiendo el requerimiento

Conocimiento del equipo

Busca contribuciones y contexto de miembros específicos del equipo.

You:  "Busca elementos que mencionen el trabajo de auth de @sarah"
AI:   Llama a search con q="auth" → la IA filtra resultados por participación de @sarah

You:  "¿Qué decisiones se han tomado sobre la capa de caché?"
AI:   Llama a search con q="caching" → identifica discusiones y comentarios
      donde se registraron decisiones

Resultados de búsqueda

La herramienta de búsqueda devuelve resultados estructurados que incluyen:

• Tipo de entidad — Qué tipo de objeto coincidió (tarea, discusión, wiki, etc.)
• Título — El nombre o título de la entidad coincidente
• Extracto — Un fragmento de contenido mostrando dónde ocurrió la coincidencia
• Metadatos — Proyecto, fecha de creación, estado y otros campos relevantes
• UUID — Identificador único para profundizar en el resultado con herramientas específicas de entidad

El asistente de IA puede usar estos UUIDs para obtener detalles completos con la herramienta apropiada — task action=get, discussion action=get, wiki action=get, etc.

You:  "Busca 'rate limiting' y muéstrame los detalles de la primera tarea"
AI:   Llama a search → obtiene resultados → llama a task action=get en el UUID de la primera tarea
      → devuelve los detalles completos de la tarea

Búsqueda vs filtrado específico por entidad

Ambos enfoques tienen su lugar. Usa la herramienta adecuada para el trabajo:

Regla general: Si sabes que estás buscando tareas, usa task action=filter. Si estás explorando un tema a través de todo, usa search.

Resolución automática de contexto

La herramienta de búsqueda soporta resolución automática de contexto. Si tu asistente de IA ya conoce el workspace de una llamada anterior en la conversación, puedes decir "busca X" sin especificar el workspace cada vez.

Cuando los resultados de búsqueda incluyen entidades de múltiples proyectos, la respuesta incluye identificadores de proyecto para cada resultado, permitiendo al asistente de IA profundizar en cualquier contexto de proyecto específico.

Próximos pasos

• Tareas: Usa el filtrado específico de tareas para búsqueda granular de tareas.
• Wiki: Busca dentro de páginas wiki para documentación del proyecto.
• Discusiones: Navega y crea hilos de discusión.
• Inicio Rápido: Configura el servidor MCP si aún no lo has hecho.