Pesquisa

Código Aberto — O GitScrum MCP Server é código aberto sob a licença MIT. Disponível no npm e no GitHub. Servidor Model Context Protocol para GitScrum — Claude, GitHub Copilot, Cursor e qualquer cliente compatível com MCP têm acesso operacional completo à sua stack de gerenciamento de projetos.

A ferramenta search fornece 1 ação — uma pesquisa global unificada que consulta todas as entidades do GitScrum em uma única chamada. Em vez de pesquisar tarefas, discussões e projetos individualmente, a ferramenta de pesquisa abrange todo o seu workspace e retorna resultados correspondentes de todos os tipos de entidade.

Esta é a ferramenta que seu assistente de IA utiliza quando sua solicitação é exploratória — "encontre tudo sobre autenticação", "o que temos relacionado ao módulo de faturamento", ou "pesquise tudo em que a @sarah trabalhou". Ela retorna resultados de tarefas, projetos, discussões, user stories e mais, classificados por relevância.

Visão Geral das Ações

Pesquisando

A ação search realiza uma consulta entre entidades em todo o seu workspace. Passe uma string de pesquisa e opcionalmente restrinja os resultados por projeto, tipo de entidade ou quantidade de resultados.

Parâmetros Obrigatórios

Parâmetros Opcionais

Tipos de Entidade

Ao usar o parâmetro type, especifique um destes tipos de entidade para restringir os resultados:

Pesquisa Básica

O uso mais simples — passe uma string de pesquisa e obtenha resultados de todos os tipos de entidade.

You:  "Pesquise tudo sobre autenticação"
AI:   Chama search action=search com q="authentication"
      → retorna tarefas, discussões, páginas wiki e mais correspondentes

You:  "Encontre tudo relacionado ao módulo de faturamento"
AI:   Chama search action=search com q="billing"
      → retorna resultados entre entidades classificados por relevância

You:  "Pesquise 'memory leak'"
AI:   Chama search action=search com q="memory leak"
      → retorna tarefas, comentários e discussões mencionando memory leaks

Pesquisa com Escopo

Restrinja sua pesquisa a um projeto ou tipo de entidade específico para resultados mais direcionados.

Por Projeto

You:  "Pesquise 'login' no projeto Backend"
AI:   Chama search action=search com q="login", project_slug="backend"
      → retorna resultados apenas do projeto Backend

You:  "Encontre referências a 'payment' no projeto Mobile App"
AI:   Chama search action=search com q="payment", project_slug="mobile-app"

Por Tipo de Entidade

You:  "Encontre tarefas relacionadas a performance da API"
AI:   Chama search action=search com q="API performance", type="task"
      → retorna apenas tarefas correspondentes

You:  "Pesquise discussões sobre a migração de banco de dados"
AI:   Chama search action=search com q="database migration", type="discussion"
      → retorna apenas threads de discussão correspondentes

You:  "Encontre páginas wiki sobre deploy"
AI:   Chama search action=search com q="deployment", type="wiki"
      → retorna apenas páginas wiki correspondentes

You:  "Pesquise user stories mencionando 'fluxo de checkout'"
AI:   Chama search action=search com q="checkout flow", type="user_story"

Filtros Combinados

You:  "Pesquise tarefas de 'timeout' no projeto Backend"
AI:   Chama search action=search com q="timeout", type="task",
      project_slug="backend" → retorna resultados com escopo preciso

You:  "Encontre discussões sobre 'auth' no projeto API, mostre as 5 primeiras"
AI:   Chama search action=search com q="auth", type="discussion",
      project_slug="api", per_page=5

Padrões de Pesquisa Multi-Entidade

A pesquisa global é mais poderosa quando você está explorando um tópico além dos limites de entidade. Aqui estão padrões que aproveitam a pesquisa entre entidades de forma eficaz:

Descoberta

Quando você não sabe onde a informação está, pesquise globalmente primeiro, depois aprofunde em resultados específicos.

You:  "O que temos sobre OAuth2?"
AI:   Chama search com q="OAuth2" → retorna:
      - 3 tarefas relacionadas à implementação de OAuth2
      - 1 discussão sobre estratégia de OAuth2
      - 2 páginas wiki documentando o fluxo OAuth2
      AI resume descobertas de todos os tipos de entidade

You:  "Encontre tudo da semana passada sobre o lançamento mobile"
AI:   Chama search com q="mobile release" → agrega resultados de
      tarefas, discussões, comentários e sprints

Análise de Impacto

Antes de fazer mudanças, pesquise todas as referências para entender o escopo do impacto.

You:  "Pesquise todas as referências ao endpoint da API v2"
AI:   Chama search com q="v2 API" → identifica tarefas, páginas wiki
      e discussões que referenciam o endpoint deprecado

You:  "Encontre tudo que menciona a tabela user_profiles"
AI:   Chama search com q="user_profiles" → retorna tarefas de código,
      documentação wiki e discussões de arquitetura

Coleta de Contexto

Reúna rapidamente todo o contexto sobre um tópico antes de começar o trabalho.

You:  "Vou começar a trabalhar na funcionalidade de reembolso de pagamento. Encontre todos os itens relacionados."
AI:   Chama search com q="payment refund" → retorna:
      - Tarefas existentes para a funcionalidade
      - Threads de discussão com decisões de design
      - Páginas wiki com docs de arquitetura de pagamento
      - User stories descrevendo o requisito

Conhecimento da Equipe

Pesquise contribuições e contexto de membros específicos da equipe.

You:  "Pesquise itens mencionando o trabalho de auth da @sarah"
AI:   Chama search com q="auth" → AI filtra resultados pelo envolvimento da @sarah

You:  "Que decisões foram tomadas sobre a camada de cache?"
AI:   Chama search com q="caching" → identifica discussões e comentários
      onde decisões foram registradas

Resultados da Pesquisa

A ferramenta de pesquisa retorna resultados estruturados que incluem:

• Tipo de entidade — Que tipo de objeto correspondeu (tarefa, discussão, wiki, etc.)
• Título — O nome ou título da entidade correspondente
• Trecho — Um snippet de conteúdo mostrando onde a correspondência ocorreu
• Metadados — Projeto, data de criação, status e outros campos relevantes
• UUID — Identificador único para aprofundar no resultado com ferramentas específicas de entidade

O assistente de IA pode usar esses UUIDs para buscar detalhes completos com a ferramenta apropriada — task action=get, discussion action=get, wiki action=get, etc.

You:  "Pesquise 'rate limiting' e me mostre os detalhes da primeira tarefa"
AI:   Chama search → obtém resultados → chama task action=get no primeiro UUID de tarefa
      → retorna detalhes completos da tarefa

Pesquisa vs Filtragem Específica de Entidade

Ambas as abordagens têm seu lugar. Use a ferramenta certa para o trabalho:

Regra geral: Se você sabe que está procurando tarefas, use task action=filter. Se está explorando um tópico em tudo, use search.

Resolução Automática de Contexto

A ferramenta de pesquisa suporta resolução automática de contexto. Se seu assistente de IA já conhece o workspace de uma chamada anterior na conversa, você pode dizer "pesquise X" sem especificar o workspace toda vez.

Quando os resultados da pesquisa incluem entidades de múltiplos projetos, a resposta inclui identificadores de projeto para cada resultado, permitindo que o assistente de IA aprofunde em qualquer contexto de projeto específico.

Próximos Passos

• Tarefas: Use filtragem específica de tarefas para pesquisa granular de tarefas.
• Wiki: Pesquise dentro de páginas wiki para documentação do projeto.
• Discussões: Navegue e crie threads de discussão.
• Início Rápido: Configure o MCP server se ainda não o fez.