context7/docs/README.pt-BR.md
2025-09-02 14:55:08 +03:00

31 KiB
Raw Blame History

Context7 MCP - Documentação de Código Atualizada para Qualquer Prompt

Website smithery badge

Instalar no Cursor Instalar no VS Code (npx)

Documentation in English 繁體中文 简体中文 日本語 한국어 문서 Documentación en Español Documentation en Français Documentazione in italiano Dokumentasi Bahasa Indonesia Dokumentation auf Deutsch Документация на русском языке Українська документація Türkçe Doküman Arabic Documentation Tiếng Việt

Sem o Context7

Os LLMs dependem de informações desatualizadas ou genéricas sobre as bibliotecas que você usa. Você obtém:

  • Exemplos de código desatualizados e baseados em dados de treinamento de anos atrás
  • APIs alucinadas que nem existem
  • Respostas genéricas para versões antigas de pacotes

Com o Context7

O Context7 MCP extrai documentação e exemplos de código atualizados e específicos para cada versão diretamente da fonte — e os coloca diretamente em seu prompt.

Adicione use context7 ao seu prompt no Cursor:

Create a basic Next.js project with app router. use context7
Create a script to delete the rows where the city is "" given PostgreSQL credentials. use context7

O Context7 busca exemplos de código e documentação atualizados diretamente para o contexto do seu LLM.

  • 1 Escreva seu prompt naturalmente
  • 2 Diga ao LLM use context7
  • 3 Obtenha respostas com código funcional

Sem alternar entre abas, sem APIs alucinadas que não existem, sem gerações de código desatualizadas.

📚 Adicionando Projetos

Confira nosso guia de adição de projetos para aprender como adicionar (ou atualizar) suas bibliotecas favoritas ao Context7.

🛠️ Instalação

Requisitos

  • Node.js >= v18.0.0
  • Cursor, Claude Code, VSCode, Windsurf ou outro Cliente MCP
Instalando via Smithery

Para instalar o Context7 MCP Server automaticamente em qualquer cliente via Smithery:

npx -y @smithery/cli@latest install @upstash/context7-mcp --client <CLIENT_NAME> --key <YOUR_SMITHERY_KEY>

Você pode encontrar sua chave Smithery na página do Smithery.ai.

Instalar no Cursor

Vá em: Settings -> Cursor Settings -> MCP -> Add new global MCP server

Colar a seguinte configuração no arquivo ~/.cursor/mcp.json do Cursor é a abordagem recomendada. Você também pode instalar em um projeto específico criando .cursor/mcp.json na pasta do seu projeto. Veja mais em Cursor MCP docs.

Desde o Cursor 1.0, você pode clicar no botão de instalar abaixo para uma instalação instantânea com um clique.

Conexão Remota do Servidor Cursor

Install MCP Server

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Conexão Local do Servidor Cursor

Install MCP Server

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
Instalar no Claude Code

Execute este comando. Veja mais em Claude Code MCP docs.

Conexão Remota do Servidor Claude Code

claude mcp add --transport http context7 https://mcp.context7.com/mcp

Ou usando transporte SSE:

claude mcp add --transport sse context7 https://mcp.context7.com/sse

Conexão Local do Servidor Claude Code

claude mcp add context7 -- npx -y @upstash/context7-mcp
Instalar no Windsurf

Adicione isto ao arquivo de configuração MCP do Windsurf. Veja mais em Windsurf MCP docs.

Conexão Remota do Servidor Windsurf

{
  "mcpServers": {
    "context7": {
      "serverUrl": "https://mcp.context7.com/mcp"
    }
  }
}

Conexão Local do Servidor Windsurf

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
Instalar no VS Code

Install in VS Code (npx) Install in VS Code Insiders (npx)

Adicione isto ao arquivo de configuração MCP do VS Code. Veja mais em VS Code MCP docs.

Conexão Remota do Servidor VS Code

"mcp": {
  "servers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Conexão Local do Servidor VS Code

"mcp": {
  "servers": {
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
Instalar no Cline

Você pode instalar o Context7 facilmente pelo Cline MCP Server Marketplace seguindo estas instruções:

  1. Abra o Cline.
  2. Clique no ícone de menu (☰) para entrar na seção MCP Servers.
  3. Use a barra de busca na aba Marketplace para encontrar Context7.
  4. Clique no botão Install.
Instalar no Zed

Pode ser instalado via Zed Extensions ou você pode adicionar isto ao seu settings.json do Zed. Veja mais em Zed Context Server docs.

{
  "context_servers": {
    "Context7": {
      "command": {
        "path": "npx",
        "args": ["-y", "@upstash/context7-mcp"]
      },
      "settings": {}
    }
  }
}
Instalar no Augment Code

Para configurar o Context7 MCP no Augment Code, você pode usar a interface gráfica ou a configuração manual.

A. Usando a UI do Augment Code

  1. Clique no menu hambúrguer.

  2. Selecione Settings.

  3. Navegue até a seção Tools.

  4. Clique no botão + Add MCP.

  5. Insira o seguinte comando:

    npx -y @upstash/context7-mcp@latest
    
  6. Nomeie o MCP: Context7.

  7. Clique no botão Add.

Depois que o servidor MCP for adicionado, você pode começar a usar os recursos de documentação de código atualizada do Context7 diretamente no Augment Code.


B. Configuração Manual

  1. Pressione Cmd/Ctrl Shift P ou vá ao menu hambúrguer no painel do Augment
  2. Selecione Edit Settings
  3. Em Advanced, clique em Edit em settings.json
  4. Adicione a configuração do servidor ao array mcpServers no objeto augment.advanced
"augment.advanced": {
  "mcpServers": [
    {
      "name": "context7",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  ]
}

Depois de adicionar o servidor MCP, reinicie seu editor. Se você receber algum erro, verifique a sintaxe para garantir que colchetes ou vírgulas não estejam faltando.

Instalar no Roo Code

Adicione isto ao arquivo de configuração MCP do Roo Code. Veja mais em Roo Code MCP docs.

Conexão Remota do Servidor Roo Code

{
  "mcpServers": {
    "context7": {
      "type": "streamable-http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Conexão Local do Servidor Roo Code

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
Instalar no Gemini CLI

Veja os detalhes em Configuração do Gemini CLI.

  1. Abra o arquivo de configurações do Gemini CLI. A localização é ~/.gemini/settings.json (onde ~ é o seu diretório home).
  2. Adicione o seguinte ao objeto mcpServers no seu arquivo settings.json:
{
  "mcpServers": {
    "context7": {
      "httpUrl": "https://mcp.context7.com/mcp"
    }
  }
}

Ou, para um servidor local:

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

Se o objeto mcpServers não existir, crie-o.

Instalar no Claude Desktop

Conexão Remota

Abra o Claude Desktop e navegue até Settings > Connectors > Add Custom Connector. Insira o nome como Context7 e a URL remota do MCP server como https://mcp.context7.com/mcp.

Conexão Local

Abra as configurações de desenvolvedor do Claude Desktop e edite seu arquivo claude_desktop_config.json para adicionar a seguinte configuração. Veja mais em Claude Desktop MCP docs.

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

Adicione isto ao arquivo de configuração do Opencode. Veja mais em Opencode MCP docs.

Conexão Remota do Opencode

"mcp": {
  "context7": {
    "type": "remote",
    "url": "https://mcp.context7.com/mcp",
    "enabled": true
  }
}

Conexão Local do Opencode

{
  "mcp": {
    "context7": {
      "type": "local",
      "command": ["npx", "-y", "@upstash/context7-mcp"],
      "enabled": true
    }
  }
}
Instalar no OpenAI Codex

Veja mais em OpenAI Codex.

Adicione a seguinte configuração às definições do servidor MCP do OpenAI Codex:

[mcp_servers.context7]
args = ["-y", "@upstash/context7-mcp"]
command = "npx"
Instalar no JetBrains AI Assistant

Veja mais detalhes na Documentação do JetBrains AI Assistant.

  1. Nos IDEs da JetBrains vá em Settings -> Tools -> AI Assistant -> Model Context Protocol (MCP)
  2. Clique em + Add.
  3. Clique em Command no canto superior esquerdo do diálogo e selecione a opção As JSON na lista
  4. Adicione esta configuração e clique em OK
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
  1. Clique em Apply para salvar as alterações.
  2. Da mesma forma, o context7 pode ser adicionado ao JetBrains Junie em Settings -> Tools -> Junie -> MCP Settings
Instalar no Kiro

Veja a Documentação do Kiro Model Context Protocol para detalhes.

  1. Navegue até Kiro > MCP Servers
  2. Adicione um novo servidor MCP clicando no botão + Add.
  3. Cole a configuração abaixo:
{
  "mcpServers": {
    "Context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"],
      "env": {},
      "disabled": false,
      "autoApprove": []
    }
  }
}
  1. Clique em Save para aplicar as alterações.
Instalar no Trae

Use o recurso Add manually e preencha as informações de configuração JSON para esse servidor MCP. Para mais detalhes, visite a documentação do Trae.

Conexão Remota do Servidor Trae

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Conexão Local do Servidor Trae

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
Usando Bun ou Deno

Use estas alternativas para executar o servidor Context7 MCP local com outros runtimes. Esses exemplos funcionam para qualquer cliente que suporte iniciar um servidor MCP local via command + args.

Bun

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

Deno

{
  "mcpServers": {
    "context7": {
      "command": "deno",
      "args": [
        "run",
        "--allow-env=NO_DEPRECATION,TRACE_DEPRECATION",
        "--allow-net",
        "npm:@upstash/context7-mcp"
      ]
    }
  }
}
Usando Docker

Se preferir executar o servidor MCP em um contêiner Docker:

  1. Crie a Imagem Docker:

    Primeiro, crie um Dockerfile na raiz do projeto (ou onde preferir):

    Clique para ver o conteúdo do Dockerfile
    FROM node:18-alpine
    
    WORKDIR /app
    
    # Instalar a versão mais recente globalmente
    RUN npm install -g @upstash/context7-mcp
    
    # Expor porta padrão se necessário (opcional, depende da interação do cliente MCP)
    # EXPOSE 3000
    
    # Comando padrão para rodar o servidor
    CMD ["context7-mcp"]
    

    Em seguida, construa a imagem usando uma tag (por exemplo, context7-mcp). Certifique-se de que o Docker Desktop (ou o daemon Docker) esteja em execução. Execute o comando abaixo no mesmo diretório onde você salvou o Dockerfile:

    docker build -t context7-mcp .
    
  2. Configure seu Cliente MCP:

    Atualize a configuração do seu cliente MCP para usar o comando Docker.

    Exemplo para um cline_mcp_settings.json:

    {
      "mcpServers": {
        "Сontext7": {
          "autoApprove": [],
          "disabled": false,
          "timeout": 60,
          "command": "docker",
          "args": ["run", "-i", "--rm", "context7-mcp"],
          "transportType": "stdio"
        }
      }
    }
    

    Nota: Este é um exemplo de configuração. Consulte os exemplos específicos do seu cliente MCP (como Cursor, VS Code, etc.) anteriormente neste README para adaptar a estrutura (por exemplo, mcpServers vs servers). Além disso, garanta que o nome da imagem em args corresponda à tag usada durante o comando docker build.

Instalar Usando a Extensão Desktop

Instale o arquivo context7.dxt na pasta dxt e adicione-o ao seu cliente. Para mais informações, confira a documentação de desktop extensions.

Instalar no Windows

A configuração no Windows é um pouco diferente em comparação ao Linux ou macOS (Cline é usado no exemplo). O mesmo princípio se aplica a outros editores; consulte a configuração de command e args.

{
  "mcpServers": {
    "github.com/upstash/context7-mcp": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@upstash/context7-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}
Instalar no Amazon Q Developer CLI

Adicione isto ao arquivo de configuração do Amazon Q Developer CLI. Veja mais em documentação do Amazon Q Developer CLI.

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

Veja mais em Documentação do Warp Model Context Protocol.

  1. Vá em Settings > AI > Manage MCP servers.
  2. Adicione um novo servidor MCP clicando no botão + Add.
  3. Cole a configuração abaixo:
{
  "Context7": {
    "command": "npx",
    "args": ["-y", "@upstash/context7-mcp"],
    "env": {},
    "working_directory": null,
    "start_on_launch": true
  }
}
  1. Clique em Save para aplicar as alterações.
Instalar no Copilot Coding Agent

Usando o Context7 com o Copilot Coding Agent

Adicione a seguinte configuração à seção mcp do arquivo de configuração do seu Copilot Coding Agent Repository->Settings->Copilot->Coding agent->MCP configuration:

{
  "mcpServers": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp",
      "tools": ["get-library-docs", "resolve-library-id"]
    }
  }
}

Para mais informações, veja a documentação oficial do GitHub.

Instalar no LM Studio

Veja mais em Suporte a MCP no LM Studio.

Instalação com um clique:

Add MCP Server context7 to LM Studio

Configuração manual:

  1. Navegue até Program (lado direito) > Install > Edit mcp.json.
  2. Cole a configuração abaixo:
{
  "mcpServers": {
    "Context7": {
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
  1. Clique em Save para aplicar as alterações.
  2. Ative/desative o servidor MCP no lado direito, em Program, ou clicando no ícone de plug na parte inferior da caixa de chat.
Instalar no Visual Studio 2022

Você pode configurar o Context7 MCP no Visual Studio 2022 seguindo a documentação de MCP Servers do Visual Studio.

Adicione isto ao arquivo de configuração MCP do Visual Studio (veja os docs do Visual Studio para detalhes):

{
  "mcp": {
    "servers": {
      "context7": {
        "type": "http",
        "url": "https://mcp.context7.com/mcp"
      }
    }
  }
}

Ou, para um servidor local:

{
  "mcp": {
    "servers": {
      "context7": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@upstash/context7-mcp"]
      }
    }
  }
}

Para mais informações e solução de problemas, consulte a documentação de MCP Servers do Visual Studio.

Instalar no Crush

Adicione isto ao arquivo de configuração do Crush. Veja mais em Crush MCP docs.

Conexão Remota do Crush (HTTP)

{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "context7": {
      "type": "http",
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Conexão Remota do Crush (SSE)

{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "context7": {
      "type": "sse",
      "url": "https://mcp.context7.com/sse"
    }
  }
}

Conexão Local do Crush

{
  "$schema": "https://charm.land/crush.json",
  "mcp": {
    "context7": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@upstash/context7-mcp"]
    }
  }
}
Instalar no BoltAI

Abra a página "Settings" do app, navegue até "Plugins" e insira o seguinte JSON:

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

Depois de salvar, digite no chat get-library-docs seguido do seu Context7 documentation ID (por exemplo, get-library-docs /nuxt/ui). Mais informações em BoltAI's Documentation site. Para o BoltAI no iOS, veja este guia.

Instalar no Rovo Dev CLI

Edite sua configuração MCP do Rovo Dev CLI executando o comando abaixo -

acli rovodev mcp

Configuração de exemplo -

Conexão Remota

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}

Conexão Local

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

Para configurar o Context7 MCP no Zencoder, siga estes passos:

  1. Vá ao menu do Zencoder (...)
  2. No menu suspenso, selecione Agent tools
  3. Clique em Add custom MCP
  4. Adicione o nome e a configuração do servidor abaixo e certifique-se de clicar no botão Install
{
  "command": "npx",
  "args": ["-y", "@upstash/context7-mcp"]
}

Depois que o servidor MCP for adicionado, você pode continuar usando-o facilmente.

Instalar no Qodo Gen

Veja mais em docs do Qodo Gen.

  1. Abra o painel de chat do Qodo Gen no VSCode ou IntelliJ.
  2. Clique em Connect more tools.
  3. Clique em + Add new MCP.
  4. Adicione a seguinte configuração:

Conexão Local do Qodo Gen

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

Conexão Remota do Qodo Gen

{
  "mcpServers": {
    "context7": {
      "url": "https://mcp.context7.com/mcp"
    }
  }
}
Instalar no Perplexity Desktop

Veja mais em Local and Remote MCPs for Perplexity.

  1. Vá em Perplexity > Settings
  2. Selecione Connectors.
  3. Clique em Add Connector.
  4. Selecione Advanced.
  5. Insira Server Name: Context7
  6. Cole o seguinte JSON na área de texto:
{
  "args": ["-y", "@upstash/context7-mcp"],
  "command": "npx",
  "env": {}
}
  1. Clique em Save.

🔨 Ferramentas Disponíveis

O Context7 MCP fornece as seguintes ferramentas que LLMs podem usar:

  • resolve-library-id: Resolve um nome geral de biblioteca em um ID compatível com o Context7.

    • libraryName (obrigatório): O nome da biblioteca a ser pesquisada
  • get-library-docs: Busca documentação para uma biblioteca usando um ID compatível com o Context7.

    • context7CompatibleLibraryID (obrigatório): ID exato compatível com Context7 (por exemplo, /mongodb/docs, /vercel/next.js)
    • topic (opcional): Focar os docs em um tópico específico (por exemplo, "routing", "hooks")
    • tokens (opcional, padrão 10000): Número máximo de tokens para retornar. Valores menores que o padrão de 10000 são automaticamente aumentados para 10000.

🛟 Dicas

Adicionar uma Regra

Se você não quiser adicionar use context7 a todo prompt, você pode definir uma regra simples no seu arquivo .windsurfrules no Windsurf ou em Cursor Settings > Rules no Cursor (ou equivalente no seu cliente MCP) para invocar o Context7 automaticamente em qualquer questão de código:

[[calls]]
match = "quando o usuário solicitar exemplos de código, passos de configuração ou documentação de biblioteca/API"
tool  = "context7"

A partir daí você receberá os docs do Context7 em qualquer conversa relacionada sem digitar nada extra. Você pode adicionar seus casos de uso na parte match.

Usar o ID da Biblioteca

Se você já sabe exatamente qual biblioteca deseja usar, adicione o ID do Context7 ao seu prompt. Assim, o servidor MCP do Context7 pode pular a etapa de correspondência de biblioteca e ir direto para recuperar os docs.

implementar autenticação básica com supabase. use library /supabase/supabase para api e docs

A sintaxe com barra informa à ferramenta MCP exatamente qual biblioteca carregar.

💻 Desenvolvimento

Clone o projeto e instale as dependências:

bun i

Build:

bun run build

Execute o servidor:

bun run dist/index.js

Argumentos de CLI

context7-mcp aceita as seguintes flags de CLI:

  • --transport <stdio|http> Transporte a ser usado (stdio por padrão). Observe que o transporte HTTP fornece automaticamente endpoints HTTP e SSE.
  • --port <number> Porta para escutar ao usar o transporte http (padrão 3000).

Exemplo com transporte http e porta 8080:

bun run dist/index.js --transport http --port 8080

Outro exemplo com transporte stdio:

bun run dist/index.js --transport stdio
Exemplo de Configuração Local
{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["tsx", "/path/to/folder/context7-mcp/src/index.ts"]
    }
  }
}
Testando com o MCP Inspector
npx -y @modelcontextprotocol/inspector npx @upstash/context7-mcp

🚨 Solução de Problemas

Erros de Módulo Não Encontrado

Se você encontrar ERR_MODULE_NOT_FOUND, tente usar bunx em vez de npx:

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

Isso frequentemente resolve problemas de resolução de módulos em ambientes onde o npx não instala ou resolve os pacotes corretamente.

Problemas de Resolução ESM

Para erros como Error: Cannot find module 'uriTemplate.js', tente a flag --experimental-vm-modules:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "--node-options=--experimental-vm-modules", "@upstash/context7-mcp@1.0.6"]
    }
  }
}
Problemas de TLS/Certificados

Use a flag --experimental-fetch para contornar problemas relacionados a TLS:

{
  "mcpServers": {
    "context7": {
      "command": "npx",
      "args": ["-y", "--node-options=--experimental-fetch", "@upstash/context7-mcp"]
    }
  }
}
Erros Gerais do Cliente MCP
  1. Tente adicionar @latest ao nome do pacote
  2. Use bunx como alternativa ao npx
  3. Considere usar deno como outra alternativa
  4. Certifique-se de estar usando Node.js v18 ou superior para suporte nativo a fetch

⚠️ Aviso

Os projetos do Context7 são contribuídos pela comunidade e, embora nos esforcemos para manter alta qualidade, não podemos garantir a precisão, integridade ou segurança de toda a documentação de bibliotecas. Os projetos listados no Context7 são desenvolvidos e mantidos por seus respectivos proprietários, não pelo Context7. Se você encontrar qualquer conteúdo suspeito, impróprio ou potencialmente prejudicial, use o botão "Report" na página do projeto para nos notificar imediatamente. Levamos todos os relatos a sério e revisaremos o conteúdo sinalizado prontamente para manter a integridade e a segurança de nossa plataforma. Ao usar o Context7, você reconhece que o faz por sua própria conta e risco.

🤝 Conecte-se Conosco

Mantenha-se atualizado e junte-se à nossa comunidade:

  • 📢 Siga-nos no X para as últimas notícias e atualizações
  • 🌐 Visite nosso Website
  • 💬 Junte-se ao nosso Discord Community

📺 Context7 na Mídia

Histórico de Stars

Gráfico de Histórico de Stars

📄 Licença

MIT