Pesquisa de Documentação (Context7)

Quando o usuário perguntar sobre bibliotecas, frameworks ou APIs, busque a documentação atual via Context7 MCP (ferramentas resolve-library-id e query-docs) em vez de depender dos dados de treinamento.

Conceitos Principais

• Context7: Servidor MCP que expõe documentação ao vivo; use-o em vez de dados de treinamento para bibliotecas e APIs.
• resolve-library-id: Retorna IDs de biblioteca compatíveis com Context7 (por exemplo, /vercel/next.js) a partir de um nome de biblioteca e consulta.
• query-docs: Busca documentação e trechos de código para um determinado ID de biblioteca e pergunta. Sempre chame resolve-library-id primeiro para obter um ID de biblioteca válido.

Quando Usar

Ative quando o usuário:

• Fizer perguntas de configuração (por exemplo, "Como configuro o middleware do Next.js?")
• Solicitar código que depende de uma biblioteca ("Escreva uma consulta Prisma para...")
• Precisar de informações de API ou referência ("Quais são os métodos de autenticação do Supabase?")
• Mencionar frameworks ou bibliotecas específicas (React, Vue, Svelte, Express, Tailwind, Prisma, Supabase, etc.)

Use esta habilidade sempre que a solicitação depender do comportamento preciso e atualizado de uma biblioteca, framework ou API. Aplica-se a todos os ambientes que possuem o Context7 MCP configurado (por exemplo, Claude Code, Cursor, Codex).

Como Funciona

Etapa 1: Resolver o ID da Biblioteca

Chame a ferramenta MCP resolve-library-id com:

• libraryName: O nome da biblioteca ou produto retirado da pergunta do usuário (por exemplo, Next.js, Prisma, Supabase).
• query: A pergunta completa do usuário. Isso melhora a relevância dos resultados.

Você deve obter um ID de biblioteca compatível com Context7 (formato /org/project ou /org/project/version) antes de consultar a documentação. Não chame query-docs sem um ID de biblioteca válido desta etapa.

Etapa 2: Selecionar a Melhor Correspondência

A partir dos resultados da resolução, escolha um resultado usando:

• Correspondência de nome: Prefira correspondência exata ou mais próxima do que o usuário pediu.
• Pontuação de benchmark: Pontuações mais altas indicam melhor qualidade da documentação (100 é o mais alto).
• Reputação da fonte: Prefira reputação Alta ou Média quando disponível.
• Versão: Se o usuário especificou uma versão (por exemplo, "React 19", "Next.js 15"), prefira um ID de biblioteca específico da versão, se listado (por exemplo, /org/project/v1.2.0).

Etapa 3: Buscar a Documentação

Chame a ferramenta MCP query-docs com:

• libraryId: O ID da biblioteca Context7 selecionado na Etapa 2 (por exemplo, /vercel/next.js).
• query: A pergunta ou tarefa específica do usuário. Seja específico para obter trechos relevantes.

Limite: não chame query-docs (ou resolve-library-id) mais de 3 vezes por pergunta. Se a resposta não for clara após 3 chamadas, declare a incerteza e use as melhores informações que você tem em vez de adivinhar.

Etapa 4: Usar a Documentação

• Responda à pergunta do usuário usando as informações atuais e buscadas.
• Inclua exemplos de código relevantes da documentação quando for útil.
• Cite a biblioteca ou versão quando for importante (por exemplo, "No Next.js 15...").

Exemplos

Exemplo: Middleware do Next.js

1. Chame resolve-library-id com libraryName: "Next.js", query: "How do I set up Next.js middleware?".
2. Dos resultados, escolha a melhor correspondência (por exemplo, /vercel/next.js) por nome e pontuação de benchmark.
3. Chame query-docs com libraryId: "/vercel/next.js", query: "How do I set up Next.js middleware?".
4. Use os trechos e textos retornados para responder; inclua um exemplo mínimo de middleware.ts da documentação, se relevante.

Exemplo: Consulta Prisma

1. Chame resolve-library-id com libraryName: "Prisma", query: "How do I query with relations?".
2. Selecione o ID da biblioteca oficial do Prisma (por exemplo, /prisma/prisma).
3. Chame query-docs com esse libraryId e a consulta.
4. Retorne o padrão Prisma Client (por exemplo, include ou select) com um pequeno trecho de código da documentação.

Exemplo: Métodos de autenticação do Supabase

1. Chame resolve-library-id com libraryName: "Supabase", query: "What are the auth methods?".
2. Escolha o ID da biblioteca de documentação do Supabase.
3. Chame query-docs; resuma os métodos de autenticação e mostre exemplos mínimos da documentação buscada.

Melhores Práticas

• Seja específico: Use a pergunta completa do usuário como consulta sempre que possível para melhor relevância.
• Consciência de versão: Quando os usuários mencionarem versões, use IDs de biblioteca específicos da versão da etapa de resolução, quando disponíveis.
• Prefira fontes oficiais: Quando várias correspondências existirem, prefira pacotes oficiais ou primários em vez de forks da comunidade.

…