Context7 MCP

Problema: Os dados de treino de um modelo têm uma data de corte. Perguntas sobre React 19, Next.js 15 ou qualquer biblioteca que lançou uma versão major nos últimos meses voltam com respostas erradas. Padrões desatualizados. APIs inventadas. Funções que foram renomeadas há duas versões.

Vitória Rápida: Adiciona Context7 à tua config MCP e acrescenta use context7 a qualquer prompt. A documentação é carregada antes de qualquer código ser escrito.

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

O Que é o Context7 MCP na Prática

Versão curta. Context7 é um servidor MCP. O seu único trabalho: ir buscar documentação atual, com versão fixada, e exemplos diretamente da fonte da própria biblioteca, não de um ficheiro de pesos com meses de atraso.

O fluxo é simples. A documentação oficial é indexada em IDs de biblioteca. Quando mencionas uma biblioteca num prompt, o servidor resolve o nome, vai buscar as secções certas e insere esse material na conversa antes de o modelo responder.

Porque Importa para o Claude Code

APIs inventadas são a dor central. Os modelos sugerem funções que foram renomeadas, descontinuadas ou que nunca existiram. A causa é sempre a mesma: os dados de treino ficam para trás da linha do tempo real dos lançamentos.

Com este servidor carregado, tens:

• Documentação no momento da consulta em vez do que veio nos pesos
• Exemplos com versão correspondente ligados ao lançamento mencionado no teu prompt
• Padrões funcionais retirados da documentação oficial que compilam à primeira
• Menos alucinações porque APIs reais substituem as inventadas

Pedes padrões do app router do Next.js 15. Context7 vai buscar a documentação do Next.js 15 na hora. O teu código volta a referenciar o que existe hoje, não o que existia quando Next.js 13 era o lançamento mais recente no conjunto de treino.

Instalação e Configuração

Node.js 18 ou mais recente é necessário. O pacote é @upstash/context7-mcp.

Claude Code CLI

Um comando geralmente resolve:

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

Ou coloca diretamente em .mcp.json na raiz do projeto:

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

Claude Desktop

Utilizadores de macOS devem editar ~/Library/Application Support/Claude/claude_desktop_config.json:

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

O ficheiro equivalente no Windows fica em %APPDATA%\Claude\claude_desktop_config.json.

Alternativa: Runtime Bun

Usas Bun? Troca o comando:

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

Reinicia o Claude Code depois de guardar a config.

Usar na Prática

Dois tools são incluídos com o servidor:

resolve-library-id: Mapeia um nome simples de biblioteca para um identificador compatível com Context7. O Claude usa isto sempre que uma biblioteca é mencionada pelo nome.

query-docs: Vai buscar a documentação real de uma biblioteca. Volta com documentação atual, exemplos e referências de API.

Uso Básico

Acrescenta use context7 a qualquer prompt que precise de documentação recente:

Create a Next.js 15 middleware that handles authentication. use context7

Três coisas acontecem:

1. O nome "Next.js" resolve para o ID de biblioteca /vercel/next.js
2. A documentação de middleware volta de uma consulta
3. O código é escrito contra as formas atuais da API

Consultas com Versão Específica

Um número de versão colocado no prompt é detetado automaticamente:

How do I configure Prisma 6 with PostgreSQL? use context7

A documentação retornada vai corresponder ao lançamento exato mencionado.

IDs de Biblioteca Comuns

O formato do ID é /organização/repositório. Oito que vais encontrar com frequência:

Salta a resolução por completo passando o ID tu mesmo:

use library /supabase/supabase for API and docs

Bibliotecas Suportadas

Milhares de bibliotecas vivem no índice. As categorias principais:

Frontend: React, Vue, Svelte, Angular, Solid, Qwik

Meta-frameworks: Next.js, Nuxt, SvelteKit, Astro, Remix

Backend: Express, Fastify, Hono, NestJS, Koa

Bases de dados: Prisma, Drizzle, Mongoose, TypeORM, Supabase

Utilitários: Zod, tRPC, React Query, SWR, Zustand, Jotai

Testes: Vitest, Jest, Playwright, Cypress

Qualquer biblioteca com documentação pública provavelmente está coberta. Novas versões são adicionadas numa base contínua.

Combinação com MCP Tool Search

O MCP Tool Search combina bem com este servidor. Liga-o e os tools só carregam quando a conversa os precisar, mantendo o arranque da sessão leve.

Porque importa: podes empilhar este servidor com outros servidores MCP sem encontrar limites de contexto:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp@latest"]
    },
    "brave-search": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-brave-search"],
      "env": { "BRAVE_API_KEY": "your-key" }
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "your-token" }
    }
  }
}

O servidor só acorda quando a documentação surge no prompt ou a frase de ativação aparece. O tempo de inatividade custa zero tokens.

Resolução de Problemas

ERR_MODULE_NOT_FOUND: Troca npx por bunx. Alguns ambientes tropeçam na camada de cache do npm.

Biblioteca não encontrada: Nem todos os pacotes estão indexados. O servidor diz-te claramente quando não consegue resolver um nome. Usa um MCP de pesquisa web como alternativa.

Resultados desatualizados: A indexação corre numa agenda. Lançamentos dos últimos dias podem ainda não estar lá. Para funcionalidades de ponta, lê a documentação oficial diretamente.

Próximos Passos

Um servidor como este transforma o Claude Code de um snapshot fixo em algo que pesquisa ativamente. Empilha-o com outros para uma configuração mais completa:

• Lê os fundamentos do MCP se o protocolo ainda é novidade
• Explora um catálogo de 50+ servidores MCP para mais capacidades
• Adiciona um MCP de pesquisa web para pesquisa além das bibliotecas
• Ativa o MCP Tool Search para manter o uso de contexto reduzido

Liga Context7 e os padrões descontinuados param de aparecer. use context7 torna-se um reflexo na primeira vez que a diferença na qualidade do código se nota.