O limite de taxa do Context7 MCP atrapalha desenvolvedores que recebem erros 429 no meio de uma sessão de programação. Este artigo apresenta a cota do plano gratuito, os planos pagos, a configuração exata para Claude Code e Cursor, soluções para a limitação de requisições e uma análise honesta sobre segurança.
Você está na metade de uma refatoração. Seu assistente de programação pede ao Context7 a documentação atual de roteamento do Next.js, e a resposta é um 429 seco. Nenhuma documentação, nenhuma explicação, apenas uma sessão travada. Esse é o limite de taxa do Context7 MCP em ação, e ele pega mais forte desde que o plano gratuito passou a ter um teto mensal no início de 2026. Este artigo apresenta os números reais, a configuração que evita a limitação, os hábitos que esticam uma cota pequena e uma resposta direta sobre segurança. Todos os valores vêm da página de planos e da documentação do próprio Context7, a menos que a linha diga que outra pessoa relatou. Limites e preços mudam, então confira o painel antes de montar um orçamento com qualquer número que você leu aqui.
O Context7 é um servidor MCP da Upstash que traz documentação atualizada de bibliotecas para a janela de contexto do seu assistente. Em vez de adivinhar uma API a partir de dados de treinamento desatualizados, o modelo consulta o Context7 e recebe trechos recentes para a versão do framework que você realmente usa. É por isso que os desenvolvedores instalam o servidor e também por que esbarram nos limites: ele fica no meio do ciclo de programação, onde uma única tarefa pode disparar uma dúzia de consultas sem você perceber.
MCP, o Model Context Protocol, é simplesmente o conector que permite a um assistente chamar ferramentas externas. Seu cliente (Claude Code, Cursor, VS Code e outros) inicia ou se conecta ao servidor, lista as ferramentas dele, e o modelo decide quando usá-las. Você aprova ou recusa cada chamada, mas raramente as conta.
O servidor expõe duas ferramentas. resolve-library-id transforma um nome simples, como "next.js", em um ID de biblioteca do Context7, como /vercel/next.js. query-docs recebe esse ID mais sua pergunta e devolve a documentação correspondente. Seu assistente escolhe quando chamar cada uma, o que significa que você raramente controla a contagem de chamadas diretamente.
Uma consulta típica são duas chamadas: resolver o ID e depois consultar a documentação. Pergunte sobre três bibliotecas em um único prompt e você já está em seis chamadas antes de o assistente escrever uma linha de código. As novas tentativas somam mais. Isso importa porque a cota é contada em chamadas de API, não em conversas ou perguntas. Planeje com base em chamadas.
Veja como os planos estão na página de preços do Context7:
| Plano | Preço | Chamadas de API incluídas | Observações |
|---|---|---|---|
| Free | $0 | 1.000 por mês | Repositórios públicos, OAuth 2.0 |
| Pro | $10 por assento por mês | 2.000 por assento | Repositórios privados, recursos para equipes, excedente a $5 por 1.000 chamadas |
| Enterprise | Sob consulta | Normalmente 2.000 por assento | SOC-2, SSO, opção de self-hosted |
💡 Contas Pro não são bloqueadas quando a cota acaba. Elas continuam funcionando e pagam pelo excedente, que é a principal diferença prática em relação ao plano gratuito.
Uma forma rápida de pensar: 1.000 chamadas equivalem a cerca de 500 consultas de duas etapas, ou aproximadamente 33 chamadas por dia se você quiser que a cota dure o mês inteiro. Esse ritmo é fácil de ultrapassar em uma única tarde intensa de depuração, e é por isso que o teto mensal surpreende quem estava acostumado a um limite diário.
O plano gratuito oferece 1.000 chamadas de API por mês. Ao ultrapassar esse limite, o serviço retorna um HTTP 429, Too Many Requests. Relatos de janeiro de 2026 dizem que o nível gratuito costumava ficar perto de 200 requisições por dia, foi anunciado com 500 por mês e depois subiu para 1.000. Trate os números antigos como história e a página de planos como fonte oficial.
O uso anônimo, sem nenhum token, é a opção mais restrita. A documentação descreve como um limite de requisições por hora, adequado para testes e sujeito a erros 429 em uso intenso. Crie uma conta gratuita no painel e gere um token, mesmo que você nunca pretenda pagar nada.
O Pro inclui 2.000 chamadas por assento e cobra US$ 5 a cada 1.000 extras. O preço do Enterprise é sob consulta, com as mesmas 2.000 chamadas típicas por assento, além de SOC-2, SSO e a opção de hospedagem própria para equipes que não podem enviar consultas a um terceiro. Para um desenvolvedor solo, a escolha é simples: fique no gratuito para uso leve e passe para o Pro quando o contador mensal continuar esgotando antes do fim do mês.
A maioria das reclamações de 429 tem origem em um só erro: rodar o Context7 sem nenhuma credencial. Configure um token uma vez e você deixa o balde anônimo para sempre. Você também ganha um contador de uso no painel, que transforma um erro misterioso em um número que você pode ler.
É necessário Node.js 18 ou mais recente. Em qualquer terminal, execute:
npx ctx7 setup
O comando cuida do login via OAuth, gera uma credencial e instala os arquivos de skill para o seu cliente. Adicione --cursor, --claude ou --opencode quando quiser direcionar uma única ferramenta em vez de todas as que ele encontrar.
Se você preferir configurar por conta própria, aponte o cliente para o servidor remoto https://mcp.context7.com/mcp e envie seu token como cabeçalho bearer:
claude mcp add --transport http context7 https://mcp.context7.com/mcp --header "Authorization: Bearer YOUR_TOKEN"
Reinicie a sessão, execute /mcp e confirme que context7 aparece como conectado antes de confiar nele para trabalho real.
Clientes que leem um arquivo JSON precisam dos mesmos dois ingredientes: uma URL e um cabeçalho:
{
"mcpServers": {
"context7": {
"url": "https://mcp.context7.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_TOKEN"
}
}
}
}
Os nomes dos campos variam um pouco entre os clientes, então confira o formato que a sua ferramenta espera. Nunca cole um token real em um arquivo que você vá versionar no Git.
Teste a conexão com um prompt que force uma consulta, como "Use o Context7 para mostrar como funcionam os matchers de middleware no Next.js mais recente." Uma configuração funcionando devolve trechos de documentação ligados a um ID de biblioteca. Uma configuração com cabeçalho errado normalmente falha logo com erro de autenticação ou de conexão, então você descobre antes que uma sessão real dependa dela.
Um orçamento de 1.000 chamadas dura muito tempo quando você para de desperdiçá-las. Três hábitos fazem a maior parte do trabalho.
Quando o prompt já contém o ID, por exemplo use library /vercel/next.js, o assistente geralmente pode pular resolve-library-id e ir direto para query-docs. Isso reduz pela metade o custo de muitas consultas. Mantenha uma lista curta dos IDs das bibliotecas que você usa todo dia e cole-os nas instruções do seu projeto.
Adicione uma regra de projeto como: "Chame o Context7 apenas para APIs lançadas ou alteradas recentemente, ou quando um erro de build apontar para incompatibilidade de assinatura." Sem essa regra, alguns assistentes disparam uma consulta para Array.map, o que gasta chamadas com conhecimento que o modelo já tem.
Quando uma consulta devolver algo de que você vai precisar de novo, cole o trecho útil em um arquivo de notas no repositório e aponte o assistente para ele. Um arquivo local não custa chamadas. Se você faz as mesmas cinco perguntas sobre o framework todo dia, são 10 chamadas por dia e 220 em 22 dias úteis. Uma única nota salva elimina a conta toda.
Seja qual for o hábito que escolher, dê uma olhada no contador do painel uma vez por semana. Se você passar de 250 chamadas após sete dias, está no ritmo de esgotar por volta do dia 28, e ainda dá tempo de mudar a rota.
Resposta curta: seguro o bastante para documentação pública de bibliotecas, desde que você trate o que volta como entrada não confiável. Os detalhes importam, então seguem aqui.
O texto da sua consulta e o nome da biblioteca viajam para os servidores do Context7. O código do servidor MCP é público no GitHub, mas o backend da API, os motores de análise e de rastreamento são privados, então as respostas vêm de uma infraestrutura que você não pode inspecionar. Não cole segredos, dados de clientes ou código proprietário em uma pergunta sobre documentação. Uma boa consulta diz "como o App Router trata redirecionamentos", e não um bloco copiado da sua base de código.
O próprio aviso do Context7 diz que os projetos são contribuições da comunidade, e os mantenedores não podem garantir a precisão nem a segurança de toda a documentação de bibliotecas. A documentação vinda de qualquer terceiro pode trazer texto que tente direcionar o seu assistente, o problema clássico de prompt injection em servidores MCP. Esse risco é minha avaliação do padrão geral do MCP, e não um incidente relatado com o Context7.
Defesas práticas:
O token é uma credencial, então trate-o como tal. Guarde-o em uma variável de ambiente ou no armazenamento de segredos do seu cliente, mantenha-o fora do Git e gere outro no painel se ele algum dia vazar.
Código privado merece um parágrafo próprio. O plano gratuito é limitado a repositórios públicos. O Pro adiciona suporte a repositórios privados, e o Enterprise adiciona a opção de hospedagem própria, que é o caminho a pedir se nada puder sair da sua rede. Se a sua política proíbe enviar texto a terceiros, leia os termos de dados do plano que você quer antes de ativar qualquer coisa.
| Risco | Probabilidade | O que fazer |
|---|---|---|
| Texto da consulta visto por terceiros | Sempre, por design | Mantenha segredos fora das perguntas |
| Documentação envenenada | Baixa, mas não zero | Aprovação manual para ferramentas arriscadas |
| Token de acesso vazado | Depende dos seus hábitos | Variáveis de ambiente, rotacionar em caso de exposição |
| Trecho desatualizado ou errado | Ocasional | Confira na documentação oficial |
Três situações diferentes produzem o mesmo código de erro:
No plano gratuito, o contador zera com o novo mês. No Pro, não há nada para esperar. Enquanto estiver bloqueado, três alternativas mantêm você em movimento: o caminho pela CLI (ctx7 library e ctx7 docs), que não precisa da camada MCP, a documentação oficial do framework, ou colar a página de documentação relevante diretamente no chat. Presuma que a CLI usa a mesma cota até que o seu painel prove o contrário.
Mais uma regra: não deixe o assistente tentar de novo em loop. Não consegui confirmar se chamadas rejeitadas contam no total mensal, então presuma que possam contar e pare após o primeiro 429, em vez de deixar a sessão bombardear o endpoint.
Os números abaixo são ilustrações construídas a partir das cotas publicadas, não medições de uma conta real. Eles consideram 22 dias úteis por mês.
| Hábito | Chamadas por dia | Chamadas por mês | Cabe no plano gratuito? |
|---|---|---|---|
| 30 consultas, resolver e consultar | 60 | 1.320 | Não, esgota por volta do dia 17 |
| 30 consultas, ID informado no prompt | 30 | 660 | Sim |
| 60 consultas, resolver e consultar | 120 | 2.640 | Não, Pro mais cerca de US$ 3 de excedente |
A linha do meio é todo o argumento a favor de informar os IDs das bibliotecas: o mesmo trabalho, metade das chamadas, nenhuma fatura extra. A última linha mostra o que o Pro faz bem. Um usuário intenso paga US$ 10 mais cerca de US$ 3 por 640 chamadas extras, ou seja, cerca de US$ 13 por um mês que teria travado no plano gratuito por volta do dia 9.
Equipes multiplicam a conta. Cada assento Pro traz 2.000 chamadas, então cinco desenvolvedores formam um total agregado de 10.000 antes que o excedente comece. Se uma pessoa consome bem mais que as outras, o número agregado pode esconder um problema, então veja o uso por pessoa antes de decidir que o plano é pequeno.
Quando o seu assistente parar de travar na documentação, você entrega mais rápido, e entregar significa páginas de lançamento, cabeçalhos de blog e imagens para redes sociais. O Picasso IA reúne geradores de texto e de imagem em um só lugar, então a mesma tarde que resolve seu limite de taxa também pode produzir as imagens do lançamento.
Para escrever e revisar código, experimente Claude Sonnet 5 ou GPT 5.6 Sol, e dê uma chance ao Kimi K2.6 quando estiver criando fluxos de trabalho com agentes. Para imagens, o P Image devolve rascunhos fotorrealistas em cerca de um segundo, o Seedream 4.5 gera saídas em 4K a partir de texto, e o Flux 2 Pro aceita texto ou uma foto de referência.
As imagens deste artigo seguem uma forma simples de prompt que funciona em qualquer um deles:
💡 Sujeito e ação, depois ambiente, depois direção da luz, depois lente e ângulo, depois detalhes de textura. Example: "A developer at an oak desk in a brick loft, rain on the window behind, soft overcast light from the right, 85mm f/1.8 shallow depth of field, wool sweater texture, Kodak Portra 400 grain."
Abra um modelo, cole um prompt assim para o banner do seu próximo lançamento e gere três variações antes de mudar uma única palavra. Escolha a melhor imagem, compare com as outras e guarde o prompt que funcionou. Seu primeiro lote levará minutos, e o segundo será melhor porque você já sabe quais detalhes o modelo obedece. Experimente no Picasso IA hoje e veja como fica o seu próximo projeto.
Escolha seu idioma
