Context7 MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Documentos novos e com pinos de versão para mais de 30 mil bibliotecas JS/TS/Python/Rust/Go
Apenas duas ferramentas — resolve-library-id + query-docs — zero sobrecarga cognitiva
Nível gratuito, chave de API gratuita opcional para limites de taxa mais altos
Trabalha em Claude Desktop, Cursor, Windsurf, Zed, Continue, Claude Code, VS Code
Puxa os documentos para a versão que você está realmente usando, não o que está no corte de treinamento do modelo de 2024

Demo ao vivo

Como fica na prática

context7.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "context7",
      "command": "npx",
      "args": [
        "-y",
        "@upstash/context7-mcp@latest"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "context7": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@upstash/context7-mcp@latest"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add context7 -- npx -y @upstash/context7-mcp@latest

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: Context7

Impeça seu agente de alucinar funções que não existem

👤 Qualquer pessoa que use um assistente de codificação de IA com uma biblioteca mais recente do que o modelo de corte ⏱ ~5 min beginner

Quando usar: Você está trabalhando com Next.js 15, Prisma 5, Drizzle, LangChain 0.3 ou qualquer biblioteca em movimento rápido e seu agente continua inventando funções que não existem.

Pré-requisitos

Nó 18+ — node -v
Context7 MCP instalado — Cole o bloco de configuração acima nas configurações do Claude Desktop / Cursor / Windsurf

Fluxo

Nomeie a biblioteca explicitamente

Usando Context7, puxe os documentos mais recentes para prisma e mostre-me a maneira certa de fazer uma transação com gravações de relação aninhadas.✓ Copiado

→ O agente chama resolve-library-id e depois query-docs com uma consulta relevante, não um resumo no estilo Wikipedia
Fixe uma versão se for importante

Estou no pró[email protected]. Use o Context7 para obter os documentos de streaming do Roteador de Aplicativos para essa versão exata.✓ Copiado

→ A citação inclui a versão; o código usa convenções baseadas em arquivos, não getServerSideProps
Verifique seu próprio código

Leia as importações em src/lib/db.ts e use o Context7 para verificar se todas as funções que eu importei realmente existem no drizzle-orm 0.30.x.✓ Copiado

→ Por importação✓/✗relatório com links de documentos

Resultado: A saída do agente usa APIs reais e atuais — primeira tentativa — em vez de APIs inventadas de aparência plausível.

Armadilhas

O agente esquece de ligar para o Context7 no segundo turno — Coloque "sempre usar o Context7 para perguntas da biblioteca" no prompt do sistema ou no CLAUDE.md
Nome da biblioteca ambíguo (por exemplo, 'supabase') — Permita que resolve-library-id retorne correspondências; escolha o pacote específico (supabase-js vs @supabase/ssr)

Combine com: filesystem · github

Crie um novo recurso usando o padrão idiomático atual

👤 Engenheiros iniciando um recurso em uma versão desconhecida ou mais recente de uma estrutura ⏱ ~15 min intermediate

Quando usar: Você precisa adicionar auth a um aplicativo Next.js 15 e deseja ignorar as postagens antigas do blog.

Pré-requisitos

Estrutura de destino identificada — package.json ou pyproject.toml já o lista

Fluxo

Peça expressões idiomáticas atuais

Usando o Context7, busque os documentos NextAuth v5 e defina uma configuração do provedor de Credenciais para mim. Eu quero o beta atual, não o v4.✓ Copiado

→ O código usa a função auth() e a configuração compatível com Edge da v5, não da v4 getServerSession
Verificar notas de migração

Puxe a seção 'upgrade da v4' dos documentos do NextAuth e liste o que eu preciso alterar no meu código atual.✓ Copiado

→ Lista de mudanças de interrupção no estilo Diff

Resultado: Trabalhando código v5 no primeiro commit — não um híbrido meio migrado.

Armadilhas

Os documentos não cobrem o seu caso de borda — O Context7 é somente para documentos; para comportamentos não lançados, volte para a fonte via GitHub MCP

Combine com: github · filesystem

Revise uma RP com citações reais de documentos, não vibrações

👤 Revisores que querem fazer backup de comentários com evidências ⏱ ~20 min intermediate

Quando usar: Revisar um PR que usa uma API de biblioteca que você não tem 100% de certeza está correto.

Fluxo

Leia o diff

Puxe a diferença do PR #482. Para cada chamada de biblioteca, use Context7 para verificar a assinatura e sinalizar qualquer coisa que pareça errada.✓ Copiado

→ Veredicto por chamada com link e versão do documento
Escreva comentários citáveis

Para cada chamada sinalizada, elabore um comentário de revisão que vincule o documento oficial via Context7.✓ Copiado

→ Comentários como "de acordo com os documentos v15<link>, X deve ser Y"

Resultado: Revise os comentários com citações, não opiniões.

Combine com: github

Migrar uma base de código para uma nova versão principal de uma biblioteca

👤 Engenheiros fazendo uma grande atualização (React 18→19, Tailwind 3→4, etc.) ⏱ ~90 min advanced

Quando usar: Você está lançando uma versão principal e o guia de atualização tem 40 páginas de "depende".

Pré-requisitos

Versão de destino escolhida — Escolha a versão exata; não faça 'mais recente' nas especialidades

Fluxo

Extraia o guia de migração

Use Context7 para obter o documento de migração Tailwind v3→v4. Resuma como uma lista de verificação.✓ Copiado

→ Lista de verificação ordenada de alterações significativas
Analise o repositório para cada problema

Para cada item dessa lista de verificação, use o sistema de arquivos MCP para encontrar padrões correspondentes em src/. Dê-me um relatório por arquivo.✓ Copiado

→ Padrão → lista de arquivos afetados
Patch em pequenos commits

Faça de cada item de migração um commit separado com uma mensagem referenciando a seção do documento.✓ Copiado

→ Limpe o log de commit, você pode reverter item por item

Resultado: Um PR de migração que você pode realmente revisar, com cada alteração vinculada a uma seção de documentos.

Armadilhas

Assumindo muitos itens em um commit — Uma alteração significativa → um commit; facilita a bissecção se algo quebrar

Combine com: filesystem · git · github

Combinações

Combine com outros MCPs para 10× de alavancagem

context7 + filesystem

Leia o package.json para escolher a versão exata e consulte o Context7 para obter documentos correspondentes

Leia package.json, encontre a próxima versão e extraia os documentos correspondentes do Context7 para Server Actions.✓ Copiado

context7 + github

Para PRs relacionados a APIs de biblioteca, anote a revisão com citações de documentos

Para cada chamada de API no PR #482, adicione um comentário de revisão citando os documentos do Context7.✓ Copiado

context7 + sequential-thinking

Planeje uma migração passo a passo antes de tocar no código

Use o pensamento sequencial para planejar a migração do Prisma v4→v5, extraindo evidências documentais do Context7 em cada etapa.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
resolve-library-id	libraryName: str	Primeira chamada - elimine a ambiguidade do nome da biblioteca de seu interesse	1 free request
query-docs	libraryId: str, query: str, version?: str	Depois de resolver-library-id - faça a pergunta real	1 free request (higher rate limit with API key)

Custo e limites

O que custa rodar

Cota de API: O nível gratuito é generoso; chave de API gratuita (context7.com/dashboard) aumenta os limites de taxa
Tokens por chamada: Cerca de 200–2.000 por consulta, dependendo do tamanho do documento
Monetário: Livre
Dica: Consultas de escopo - 'como usar X' é mais barato do que 'dê-me tudo sobre X'; o servidor já retorna trechos focados

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Opcional CONTEXT7_API_KEY env var para limites de taxa mais altos

Saída de dados: As consultas vão para api.context7.com; sem saída de código — apenas o nome da biblioteca e sua consulta são enviados

Context7 vê o que você pergunta, não o seu código. Não cole a fonte proprietária no campo de consulta.

Solução de problemas

Erros comuns e correções

Biblioteca não encontrada por resolve-library-id

Experimente nomes alternativos (por exemplo, 'nextjs' vs 'next.js' vs '@vercel/next'); Índices Context7 por aliases comuns, mas não por cada bifurcação

Verificar: Check context7.com/browse for the official slug

Os documentos parecem desatualizados

Inclua um argumento de versão explícito; sem ele, você obtém os documentos indexados mais recentes da biblioteca, que podem atrasar os lançamentos por horas

Verificar: Compare the returned snippet URL to the official docs site

Limite de taxa atingido no uso anônimo

Obtenha uma chave de API gratuita em context7.com/dashboard e defina CONTEXT7_API_KEY no bloco env de sua configuração MCP

Verificar: Re-run the same query and check it succeeds

Alternativas

Context7 vs. outros

Alternativa	Quando usar	Troca
GitHub MCP (docs folder)	Você precisa da verdade no nível da fonte ou de um comportamento não divulgado	A latência por arquivo é alta; você tem que navegar no repositório manualmente
Ref Tools	Você quer um provedor de documentos diferente com seu próprio índice	Cobertura diferente da biblioteca
Direct web fetch	O documento não está em nenhum índice – você tem o URL	Sem resolução de versão; você faz o URL funcionar

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills