--- title: "opencode com o Bright Data MCP da Bright Data no seu CLI" slug: opencode-with-web-mcp date: 2025-08-26T08:13:43+00:00 modified: 2025-11-04T08:46:01+00:00 permalink: https://brightdata.com.br/blog/ai/opencode-with-web-mcp type: blog --- [ Blog ](https://brightdata.com.br/blog "Blog") / [AI](https://brightdata.com.br/blog/ai) [AI](https://brightdata.com.br/blog/ai) # opencode com o Bright Data MCP da Bright Data no seu CLI Saiba como expandir os recursos do opencode conectando-o ao Web MCP da Bright Data. Siga este tutorial para extrair dados da Web em tempo real em seu terminal. 12 min de leitura [ ![Antonello Zanini](https://media.brightdata.com.br/2022/12/Antonello-Zanini-2-50x50.jpg) ](https://brightdata.com/blog/authors/antonello-zanini) [Antonello Zanini Technical Writer ](https://brightdata.com/blog/authors/antonello-zanini) ![Opencode × Bright Data MCP](https://media.brightdata.com.br/2025/08/Opencode%E2%80%AF%C3%97%E2%80%AFBright%E2%80%AFData-MCP.png) Neste tutorial, você verá: - O que é o opencode, quais recursos ele oferece e por que não deve ser confundido com o Crush. - Como ampliá-lo com interação com a Web e recursos de extração de dados pode torná-lo ainda mais útil. - Como conectar o opencode ao servidor MCP da Bright Data na CLI para criar um agente de codificação de IA avançado. Vamos nos aprofundar! ## O que é o opencode? [O opencode](https://opencode.ai/) é um agente de codificação de IA de código aberto criado para o terminal. Em particular, ele funciona como: 1. Uma TUI[(Terminal User Interface](https://github.com/rothgar/awesome-tuis)) em sua CLI. 2. Uma integração de IDE no Visual Studio Code, Cursor, etc. 3. Uma extensão do GitHub. Mais detalhadamente, o opencode permite que você: - Configurar uma interface de terminal responsiva e com tema. - Carregar o LSP[(Language Server Protocols](https://microsoft.github.io/language-server-protocol/)) correto para seu LLM. - Executar vários agentes em paralelo no mesmo projeto. - Compartilhar links para qualquer sessão para referência ou depuração. - Faça login no Anthropic para usar sua conta Claude Pro ou Max, além de integrar-se a outros mais de 75 provedores de LLM via [Models.dev](https://models.dev/) (incluindo modelos locais). Como você pode ver, a CLI é agnóstica em relação ao LLM. Ela foi desenvolvida principalmente em Go e TypeScript e já acumulou [mais de 20 mil estrelas no GitHub](https://github.com/sst/opencode), o que comprova sua popularidade na comunidade. **Observação**: essa tecnologia não deve ser confundida com o Crush, um projeto diferente cujo nome original era “opencode”. Saiba mais sobre a [disputa de nomes no X](https://x.com/thdxr/status/1933561254481666466). Se você estiver procurando o Crush, consulte nosso guia sobre a integração do [Crush com o Bright Data MCP da Bright Data](/blog/ai/crush-cli-with-web-mcp). ## Por que é importante integrar o Bright Data MCP da Bright Data na TUI do opencode Não importa qual LLM você acabe configurando no opencode, todos eles compartilham a mesma limitação: [o conhecimento deles é estático](/blog/dados-do-site/train-an-ai-model). Os dados em que foram treinados representam um instantâneo no tempo, que rapidamente se torna desatualizado. Isso é especialmente verdadeiro em campos de rápida evolução, como o desenvolvimento de software. Agora, imagine dar ao seu assistente de CLI do opencode a capacidade de: - Obter novos tutoriais e documentação. - Consultar guias ao vivo enquanto escreve código. - Navegar em sites dinâmicos com a mesma facilidade com que navega em seus arquivos locais. Esses são exatamente os recursos que você desbloqueia ao conectá-lo ao [Bright Data MCP da Bright Data](/ai/mcp-server). O Bright Data MCP da Bright Data fornece acesso a mais de 60 ferramentas prontas para IA, projetadas para interação com a Web em tempo real e coleta de dados, todas alimentadas pela [infraestrutura de IA da Bright Data](/ai). As duas ferramentas mais usadas[(mesmo disponíveis no nível gratuito](https://docs.brightdata.com/mcp-server/overview)) no Bright Data MCP da Bright Data são: **Ferramenta****Descrição da ferramenta**`scrape_as_markdown`Extrai o conteúdo de uma única página da Web com opções avançadas de extração, retornando os dados resultantes em Markdown. Pode ignorar a detecção de bots e CAPTCHA.`search_engine`Extraia resultados de pesquisa do Google, Bing ou Yandex. Retorna dados SERP em formato JSON ou Markdown.Além dessas duas, há [mais de 55 ferramentas especializadas](https://github.com/brightdata/brightdata-mcp/blob/main/assets/Tools.md) para interagir com páginas da Web (por exemplo, `scraping_browser_click`) e coletar dados estruturados de vários domínios, como LinkedIn, Amazon, Yahoo Finance, TikTok e outros. ool recupera informações de perfil estruturadas de uma página pública do LinkedIn quando recebe o URL de um profissional. É hora de verificar como o Bright Data MCP funciona dentro do opencode! ## Como conectar o opencode ao Bright Data MCP da Bright Data Saiba como instalar e configurar o opencode localmente e integrá-lo ao servidor Bright Data MCP da Bright Data. O resultado será um agente de codificação estendido com acesso a mais de 60 ferramentas da Web. Esse agente CLI será usado em uma tarefa de exemplo para: 1. Extrair uma página de produto do LinkedIn em tempo real para coletar dados de perfil do mundo real. 2. Armazenar os dados localmente em um arquivo JSON. 3. Criar um script Node.js para carregar e processar os dados. Siga as etapas abaixo! **Observação**: esta seção do tutorial se concentra no uso do opencode por meio da CLI. No entanto, você pode usar uma configuração semelhante para integrá-lo diretamente ao seu IDE, [conforme mencionado na documentação](https://opencode.ai/docs/ide/). ### Pré-requisitos Antes de começar, verifique se você tem o seguinte: - Um ambiente macOS ou Linux (os usuários do Windows devem [usar a WSL](https://learn.microsoft.com/en-us/windows/wsl/install)). - Uma [assinatura do Claude Pro ou Max](https://claude.ai/settings/billing?action=subscribe) ou uma [conta do Anthropic com alguns fundos e uma chave de API](https://www.anthropic.com/pricing) (neste tutorial, usaremos uma chave de API do Anthropic, mas você pode configurar [qualquer outro LLM compatível](https://opencode.ai/docs/providers/)). - [Node.js instalado localmente](https://nodejs.org/en/download) (recomendamos a versão mais recente do LTS). - Uma conta da Bright Data com uma chave de API pronta. Não se preocupe com a configuração do Bright Data por enquanto, pois você será orientado nas etapas a seguir. A seguir, apresentamos alguns conhecimentos básicos opcionais, mas úteis: - Uma compreensão geral de [como o MCP funciona](https://docs.anthropic.com/en/docs/mcp). - Alguma familiaridade com o Bright Data MCP da Bright Data e suas ferramentas. ### Etapa 1: Instalar o opencode Instale o opencode em seu sistema baseado em Unix usando o seguinte comando: ```none curl -fsSL https://opencode.ai/install | bash ``` Isso fará o download do instalador de `https://opencode.ai/install` e o executará para configurar o opencode em seu computador. Explore as [outras opções de instalação possíveis](https://opencode.ai/docs/#install). Verifique se o opencode está funcionando com: ```none opencode ``` Se você encontrar um erro do tipo “missing executable” (executável ausente) ou “unrecognized command” (comando não reconhecido), reinicie o computador e tente novamente. Se tudo funcionar como esperado, você verá algo parecido com isto: ![The opencode TUI](https://media.brightdata.com/2025/08/image-134-1024x472.png)Ótimo! Agora o opencode está pronto para ser usado. ### Etapa 2: configurar o LLM O opencode pode se conectar a muitos LLMs, mas os modelos recomendados são da Anthropic. Certifique-se de que você tenha uma assinatura Claude Max ou Pro, ou uma conta Anthropic com alguns fundos e uma chave de API. As etapas a seguir mostrarão como conectar o opencode à sua conta Anthropic via chave de API, mas [qualquer outra integração de LLM compatível também funcionará](https://opencode.ai/docs/providers/#directory). Feche a janela do opencode com o comando `/exit` e, em seguida, [inicie a autenticação com um provedor LLM](https://opencode.ai/docs/#configure) usando: ```none opencode auth login ``` Você será solicitado a selecionar um provedor de modelo de IA: ![Selecting the “Anthropic” provider in opencode](https://media.brightdata.com/2025/08/image-135-1024x266.png)Escolha “Anthropic” pressionando `Enter` e, em seguida, selecione a opção “Manually enter API key”: ![Selecting the “Manually enter API key” option](https://media.brightdata.com/2025/08/image-136-1024x180.png)Cole sua chave de API do Anthropic e pressione Enter: ![LLM integration](https://media.brightdata.com/2025/08/image-137-1024x222.png)A configuração do LLM está concluída. Reinicie o opencode, inicie o comando [`/models`](https://opencode.ai/docs/tui/#models) e você poderá selecionar um modelo Anthropic. Por exemplo, escolha “Claude Opus 4.1”: ![Selecting the “Claude Opus 4.1” model](https://media.brightdata.com/2025/08/image-138-1024x538.png)Pressione `Enter` e você verá: ![Selecting the “Claude Opus 4.1” model from Anthropic](https://media.brightdata.com/2025/08/image-139-1024x459.png)Observe como o opencode agora opera usando o modelo Anthropic Claude Opus 4.1 configurado. Muito bem! ### Etapa 3: inicializar seu projeto opencode Vá para o diretório de seu projeto usando o comando `cd` e inicie o opencode lá: ```none cd opencode ``` Execute o comando `/init` para [inicializar um projeto do opencode](https://opencode.ai/docs/#initialize). A saída deve ser semelhante a esta: ![The /init command output](https://media.brightdata.com/2025/08/image-140-1024x474.png)Especificamente, o comando `/init` criará um arquivo [`AGENTS.md`](https://opencode.ai/docs/rules/). Semelhante ao [`CLAUDE.md`](https://docs.anthropic.com/en/docs/claude-code/settings#key-points-about-the-configuration-system) ou às [regras do Cursor](https://docs.cursor.com/en/context/rules), ele fornece instruções personalizadas para o opencode. Essas instruções são incluídas no contexto do LLM para personalizar seu comportamento para seu projeto específico. Abra o arquivo `AGENTS.md` em seu IDE (por exemplo, Visual Studio Code) e você verá: ![Exploring the AGENTS.md file in VS Code](https://media.brightdata.com/2025/08/image-141-1024x586.png)Personalize-o de acordo com suas necessidades para instruir o agente de codificação de IA sobre como operar no diretório do seu projeto. **Dica**: o arquivo `AGENTS.md` deve ser confirmado no repositório Git da pasta do projeto. ### Etapa 4: testar o Bright Data MCP da Bright Data Antes de tentar integrar seu agente opencode com o servidor Bright Data MCP da Bright Data, é importante entender como esse servidor funciona e se sua máquina pode executá-lo. Se ainda não o fez, comece [criando uma conta da Bright Data](/?hs_signup=1). Caso contrário, se já tiver uma, basta [fazer o login](/cp/start). Para uma configuração rápida, [dê uma olhada na página “MCP” da sua conta](/cp/mcp): ![The Bright Data “MCP” page in your account](https://media.brightdata.com/2025/08/image-142-1024x548.png)Caso contrário, siga as instruções abaixo. Agora, [gere sua chave de API da Bright Data](https://docs.brightdata.com/api-reference/authentication#generating-an-api-key%3A). Certifique-se de armazená-la em um local seguro, pois você precisará dela em breve. Aqui, assumiremos que você está usando uma chave de API com permissões de administrador, pois isso facilita a integração. No terminal, instale o Bright Data MCP globalmente por meio do pacote [`@brightdata/mcp`](https://www.npmjs.com/package/@brightdata/mcp): ```none npm install -g @brightdata/mcp ``` Verifique se o servidor MCP local funciona com este comando Bash: ```none API_TOKEN="" npx -y @brightdata/mcp ``` Substitua o espaço reservado `` pelo token real da API da Bright Data. O comando define a variável de ambiente `API_TOKEN` necessária e, em seguida, aciona o Bright Data MCP por meio do pacote `@brightdata/mcp`. Em caso de sucesso, você deverá ver registros semelhantes a este: ![Bright Data MCP startup logs](https://media.brightdata.com/2025/08/image-143-1024x157.png)Na primeira inicialização, o pacote configura automaticamente duas zonas padrão em sua conta da Bright Data: - `mcp_unlocker`: Uma zona para o [Web Unlocker](/products/web-unlocker). - `mcp_browser`: Uma zona para a [API do navegador](/products/scraping-browser). Essas duas zonas são exigidas pelo Bright Data MCP para alimentar todas as ferramentas que ele expõe. Para confirmar que as duas zonas acima foram criadas, faça login na sua conta da Bright Data. No painel, navegue até a página[“Proxies & Scraping Infrastructure](/cp/zones)“. Lá, você deverá ver as duas zonas na tabela: ![The mcp_unlocker and mcp_browser zones created by the Bright Data MCP at startup](https://media.brightdata.com/2025/08/image-144-1024x539.png)**Observação**: se o seu token de API não tiver permissões de administrador, essas zonas talvez não sejam criadas automaticamente. Nesse caso, você pode configurá-las manualmente no painel e especificar seus nomes por meio de variáveis de ambiente, [conforme explicado na página do pacote no GitHub](https://github.com/brightdata/brightdata-mcp?tab=readme-ov-file#-account-setup). Por padrão, o servidor MCP expõe apenas as ferramentas `search_engine` e `scrape_as_markdown`[(que podem ser usadas gratuitamente](/blog/ai/web-mcp-free-tier)!). Para desbloquear recursos avançados, como automação do navegador e recuperação de feed de dados estruturados, você deve ativar o modo Pro. Para fazer isso, defina a variável de ambiente `PRO_MODE=true` antes de iniciar o servidor MCP: ```none API_TOKEN="" PRO_MODE="true" npx -y @brightdata/mcp ``` **Importante**: Quando o modo Pro estiver ativado, você terá acesso a todas as mais de 60 ferramentas. Por outro lado, o modo Pro não está incluído no nível gratuito e incorrerá em cobranças adicionais. Perfeito! Você acabou de verificar que o servidor Bright Data MCP funciona em sua máquina. Interrompa o processo do servidor, pois agora você configurará o opencode para iniciá-lo e se conectar a ele. ### Etapa 5: integrar o Bright Data MCP ao opencode O opencode suporta a integração do MCP por meio da [entrada`mcp` no arquivo de configuração](https://opencode.ai/docs/mcp-servers/). Lembre-se de que há duas [abordagens de configuração](https://opencode.ai/docs/config/) compatíveis: - **Globalmente**: Por meio do arquivo em `~/.config/opencode/opencode.json`. A configuração global é útil para configurações como temas, provedores ou vinculações de teclas. - **Por projeto**: Por meio de um arquivo `opencode.json` local no diretório do seu projeto. Suponha que você queira configurar a integração do MCP localmente. Comece adicionando um arquivo `opencode.json` em seu diretório de trabalho. Em seguida, abra o arquivo e verifique se ele contém as seguintes linhas: ```none { "$schema": "https://opencode.ai/config.json", "mcp": { "brightData": { "type" (tipo): "local", "enabled": true, "command": [ "npx", "-y", "@brightdata/mcp" ], "environment" (ambiente): { "API_TOKEN": "", "PRO_MODE": "true" } } } } ``` Substitua `` pela chave da API da Bright Data que você gerou e testou anteriormente. Nessa configuração: - O objeto `mcp` informa ao opencode como iniciar servidores MCP externos. - A entrada `brightData` especifica o comando`(npx`) e as variáveis de ambiente necessárias para iniciar o Bright Data MCP.`(PRO_MODE` é opcional, mas sua ativação desbloqueia o conjunto completo de ferramentas disponíveis). Em outras palavras, a configuração `opencode.json` acima instrui a CLI a executar o mesmo comando `npx` com as variáveis de ambiente definidas anteriormente. Isso dá ao opencode a capacidade de iniciar e se conectar ao servidor Bright Data MCP. Até o momento em que este texto foi escrito, não havia nenhum comando dedicado para verificar as conexões do servidor MCP ou as ferramentas disponíveis. Portanto, vamos direto para o teste! ### Etapa 6: executar uma tarefa no opencode Para verificar os recursos da Web do seu agente de codificação opencode aprimorado, inicie um prompt como o seguinte: ```none Extraia "https://it.linkedin.com/in/antonello-zanini" e armazene os dados resultantes em um arquivo local "profile.json". Em seguida, configure um script Node.js básico que leia o arquivo JSON e retorne seu conteúdo ``` Isso representa um caso de uso do mundo real, pois coleta dados reais e os utiliza em um script Node.js. Inicie o opencode, digite o prompt e pressione `Enter` para executá-lo. Você verá um comportamento semelhante a este: ![Task execution in opencode](https://media.brightdata.com/2025/08/image-145-1024x533.png)O GIF foi acelerado, mas isso é o que acontece passo a passo: 1. O modelo Claude Opus define um plano. 2. A primeira etapa do plano é recuperar os dados do LinkedIn. Para fazer isso, o LLM seleciona a ferramenta MCP apropriada`(web_data_linkedin_person_profile`, referenciada como `Brightdata_web_data_linkedin_person_profile` na CLI) com os argumentos corretos extraídos do prompt`(https://it.linkedin.com/in/antonello-zanini)`. 3. O LLM coleta os dados de destino por meio da ferramenta de raspagem do LinkedIn e atualiza o plano. 4. Os dados são armazenados em um arquivo `profile.json` local. 5. Um script Node.js (chamado `readProfile.js`) é criado para ler os dados do `profile.json` e imprimi-los. 6. Você verá um resumo das etapas executadas, com instruções para executar o script Node.js produzido. Neste exemplo, a saída final produzida pela tarefa tem a seguinte aparência: ![The final instructions produced by opencode](https://media.brightdata.com/2025/08/image-146-1024x470.png)No final da interação, seu diretório de trabalho deve conter estes arquivos: ```none ├── AGENTS.md ├── opencode.json ├─── profile.json # <-- criado pela CLI readProfile.js # <-- criado pela CLI ``` Maravilhoso! Vamos agora verificar se os arquivos gerados contêm os dados e a lógica pretendidos. ### Etapa 7: explorar e testar a saída Abra o diretório do projeto no Visual Studio Code e comece inspecionando o arquivo `profile.json`: ![Exploring profile.json in VSC](https://media.brightdata.com/2025/08/image-147-1024x756.png)**Importante**: Os dados em `profile.json` são dados reais do LinkedIn coletados pelo Bright Data [LinkedIn Scraper](/products/web-scraper/linkedin) por meio da ferramenta MCP dedicada `web_data_linkedin_person_profile`. Não se trata de conteúdo alucinado ou inventado gerado pelo modelo Claude! Os dados do LinkedIn foram recuperados com êxito, como você pode verificar ao inspecionar a página de perfil público do LinkedIn mencionada no prompt: ![The input LinkedIn page](https://media.brightdata.com/2025/08/image-148-1024x550.png)**Observação**: [a raspagem do LinkedIn](/blog/procedimentos/linkedin-scraping-guide) é notoriamente desafiadora devido às suas sofisticadas proteções anti-bot. Um LLM comum não pode executar essa tarefa de forma confiável, o que demonstra como seu agente de codificação se tornou poderoso graças à integração do Bright Data MCP. Em seguida, dê uma olhada no arquivo `readProfile.js`: ![Exploring readProfile.json in VSC](https://media.brightdata.com/2025/08/image-149-1024x772.png)Observe que o código define uma função `readProfileData()` para ler os dados do perfil do LinkedIn em `profile.json`. Essa função é então chamada para imprimir os dados do perfil com todos os detalhes. Teste o script com: ```none node readProfile.js ``` A saída deve ser: ![The readProfile.js output](https://media.brightdata.com/2025/08/image-150-1024x621.png)Veja como o script produzido imprime os dados raspados do LinkedIn conforme planejado. Missão concluída! Experimente diferentes prompts e teste [fluxos de trabalho de dados avançados orientados por LLM](/ai/web-access) diretamente na CLI. ## Conclusão Neste artigo, você viu como conectar o opencode ao Bright Data MCP da Bright Data[(que agora oferece um nível gratuito!](/blog/ai/web-mcp-free-tier)). O resultado é um agente de codificação de IA rico em ferramentas capaz de extrair dados da Web e interagir com eles. Para criar agentes de IA mais complexos, explore toda a gama de serviços e produtos disponíveis na [infraestrutura de IA da Bright Data](/ai). Essas soluções oferecem suporte a uma ampla variedade de [cenários agênticos](/ai/web-access), incluindo várias integrações de CLI. Inscreva-se gratuitamente na Bright Data e comece a fazer experiências com nossas ferramentas da Web prontas para IA! Contate-nosTeste grátis![google social icon](/wp-content/themes/brightdata/assets/images/ic_google.svg) Índice [ ](https://news.ycombinator.com/submitlink?t=opencode+com+o+Bright+Data+MCP+da+Bright+Data+no+seu+CLI&u=https://brightdata.com.br/blog/ai/opencode-with-web-mcp) [ ](https://www.linkedin.com/shareArticle?mini=true&title=opencode+com+o+Bright+Data+MCP+da+Bright+Data+no+seu+CLI&url=https://brightdata.com.br/blog/ai/opencode-with-web-mcp) [ ](http://www.reddit.com/submit?title=opencode+com+o+Bright+Data+MCP+da+Bright+Data+no+seu+CLI&url=https://brightdata.com.br/blog/ai/opencode-with-web-mcp) ## Você também pode estar interessado em [ ![OpenHuman with Bright Data](https://media.brightdata.com.br/2026/09/OpenHuman-with-Bright-Data.png) ](https://brightdata.com.br/blog/ai/openhuman-with-bright-data "Acesso à Web Pronto para Produção no OpenHuman Através do Bright Data CLI") [AI ![Antonello Zanini](https://media.brightdata.com.br/2022/12/Antonello-Zanini-2-50x50.jpg) Antonello Zanini Technical Writer ### Acesso à Web Pronto para Produção no OpenHuman Através do Bright Data CLI Integre o Bright Data CLI ao OpenHuman para habilitar acesso à web pronto para produção e coleta de dados para agentes de IA. 09-Sep-2026 14 min de leitura ](https://brightdata.com.br/blog/ai/openhuman-with-bright-data) [ ![Multimodal Web Scraping with MiniMax](https://media.brightdata.com.br/2026/09/Multimodal-Web-Scraping-with-MiniMax.png) ](https://brightdata.com.br/blog/dados-do-site/multimodal-web-scraping-with-minimax "Scraping de Dados Multimodal com MiniMax") [Dados do site ![Antonello Zanini](https://media.brightdata.com.br/2022/12/Antonello-Zanini-2-50x50.jpg) Antonello Zanini Technical Writer ### Scraping de Dados Multimodal com MiniMax Combine a API Web Unlocker da Bright Data com a visão MiniMax M3 para extrair dados estruturados de imagens e capturas de tela de páginas web. 09-Sep-2026 5 min de leitura ](https://brightdata.com.br/blog/dados-do-site/multimodal-web-scraping-with-minimax) [ ![The 10 Best CLI Tools for Codex in 2026](https://media.brightdata.com.br/2026/08/The-10-Best-CLI-Tools-for-Codex-in-2026.png) ](https://brightdata.com.br/blog/ai/best-cli-tools-for-codex "As 10 Melhores Ferramentas CLI para Codex em 2026 – Testadas & Classificadas") [AI ![Daniel Shashko](https://media.brightdata.com.br/2022/04/Daniel-Shashko-2-50x50.png) Daniel Shashko Web Data & AI Expert ### As 10 Melhores Ferramentas CLI para Codex em 2026 – Testadas & Classificadas As 10 ferramentas CLI que tornam o Codex mais rápido e capaz, começando com o Bright Data CLI para acesso real à web de dentro do sandbox. 06-Sep-2026 24 min de leitura ](https://brightdata.com.br/blog/ai/best-cli-tools-for-codex)