Context7 pode ser conectado ao Claude Code pelo plugin, pela CLI ou por configuração manual do MCP. O plugin usa login pelo navegador e dispensa Node.js, npm, npx e API key locais; a CLI usa um fluxo OAuth por dispositivo que, segundo o Context7, funciona também em hosts remotos, sem interface gráfica ou via SSH. A escolha depende principalmente do método de autenticação que você precisa usar.
MCP é a sigla de Model Context Protocol, o protocolo que permite ao Claude Code se conectar às ferramentas do Context7 para consultar documentação de bibliotecas. O guia oficial do Context7 para Claude Code descreve as opções de integração.
Escolha uma rota de configuração
| Rota | Autenticação | Requisitos locais | Quando faz sentido |
| Plugin do Context7 | Login pelo navegador | Não exige Node.js, npm, npx ou API key locais | Para conectar pelo marketplace e autenticar no navegador |
| CLI do Context7 | Fluxo OAuth por dispositivo; a configuração gera uma API key e instala uma skill | O comando usa npx | Para usar o fluxo da CLI, inclusive em hosts remotos, sem interface gráfica ou via SSH |
| MCP manual | Configuração direta do MCP com API key | Depende da configuração escolhida | Para quem precisa configurar o MCP diretamente ou usar uma API key |
Escolha a autenticação antes de instalar: o plugin usa login pelo navegador, enquanto a CLI oferece o fluxo OAuth por dispositivo.
Se você precisa que a integração funcione em um host remoto ou via SSH, a CLI é a rota documentada pelo Context7 para esse cenário. Já o plugin não lê a variável CONTEXT7_API_KEY; para um fluxo que dependa dessa chave, use a CLI ou a configuração manual do MCP.
Instale o Context7 e confira a conexão
Antes de começar, tenha o Claude Code instalado. Em seguida, siga apenas os passos da rota escolhida.
Pelo plugin
- Adicione o marketplace do Context7 ao Claude Code:
/plugin marketplace add upstash/context7 - Instale o plugin:
/plugin install context7@context7-marketplace - Reinicie o Claude Code para carregar a integração.
- Abra
/mcp, selecione o Context7 e conclua o login pelo navegador.
Pela CLI
- Execute o comando de configuração indicado pelo Context7:
npx ctx7 setup --claude - Conclua a autenticação OAuth pelo fluxo de dispositivo. O Context7 informa que esse fluxo funciona em hosts remotos, sem interface gráfica ou via SSH.
- Abra
/mcpno Claude Code e confira a conexão do Context7.
A configuração pela CLI gera uma API key e instala uma skill que pode acionar consultas de documentação para perguntas sobre bibliotecas. Se você conhece o identificador de uma biblioteca, o Context7 também documenta consultas explícitas que permitem usá-lo sem passar pela etapa de resolução do nome.
Pela configuração manual do MCP
Se você precisa configurar o servidor diretamente com uma API key, consulte as instruções de configuração MCP no guia oficial do Context7. A página também diferencia essa opção do plugin hospedado, que não lê CONTEXT7_API_KEY.
Uma forma prática de verificar a integração é abrir /mcp e, em seguida, pedir ao Claude Code documentação para uma biblioteca. O Context7 descreve esse fluxo como uma maneira de consultar as ferramentas disponíveis e, quando necessário, usar diretamente um identificador de biblioteca conhecido.
O que o Context7 diz que recebe e retém
Segundo a política de privacidade do Context7, a consulta enviada à API é formulada pelo assistente e inclui o nome ou identificador da biblioteca. A empresa diz que não envia nessa consulta o prompt original, o código-fonte ou o histórico da conversa.
A mesma política lista metadados transmitidos, como uma API key quando fornecida, informações e versões do cliente e do servidor, ID da sessão e tipo de transporte. Para conexões HTTP hospedadas, também menciona uma declaração temporária de IP; o nome do plugin pode ser enviado quando aplicável.
O Context7 informa que usa as consultas formuladas para reclassificar resultados de documentação e para benchmarking anônimo. Consultas de espaços de equipe Enterprise não são armazenadas para benchmarking. A empresa declara ainda que os registros da API são mantidos por 30 dias; a retenção de dados do usuário depende do estado da conta, e dados excluídos são removidos permanentemente em até 30 dias após o pedido de exclusão.
Limites de uso e cobranças publicados
A página de planos do Context7 lista as seguintes franquias e cobranças em dólares americanos:
| Plano | Preço publicado e período | Chamadas de API incluídas | Chamadas adicionais |
| Free | US$ 0 | 1.000 por mês | Quando o acesso é bloqueado, 20 chamadas bônus por dia até a renovação mensal |
| Pro | US$ 10 por assento por mês | 2.000 por assento por mês | US$ 5 por 1.000 chamadas adicionais |
O processamento de repositórios privados aparece como uma cobrança separada: US$ 5 por 1 milhão de tokens, ao adicionar um repositório privado ou atualizar um já existente. Esses valores e condições são os publicados na página de planos do Context7.