# Busca na web e scraping com MCP no OpenCode (/pt-BR/quickstarts/opencode)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 609 · updated: 2026-07-30 -->
Related: [Node.js](/pt-BR/quickstarts/nodejs.md), [Next.js](/pt-BR/quickstarts/nextjs.md), [Express](/pt-BR/quickstarts/express.md), [NestJS](/pt-BR/quickstarts/nestjs.md), [Fastify](/pt-BR/quickstarts/fastify.md), [Hono](/pt-BR/quickstarts/hono.md)

Adicione as ferramentas de busca, scraping, rastreamento e navegador do Firecrawl ao [OpenCode](https://opencode.ai) via MCP.

<div id="quick-setup">
  ## Configuração rápida [#configuração-rápida]
</div>

<div id="1-get-your-api-key">
  ### 1. Obtenha sua chave de API [#1-obtenha-sua-chave-de-api]
</div>

Cadastre-se em [firecrawl.dev/app](https://www.firecrawl.dev/app) e copie sua chave de API.

<div id="2-add-firecrawl-to-opencode">
  ### 2. Adicione o Firecrawl ao OpenCode [#2-adicione-o-firecrawl-ao-opencode]
</div>

O OpenCode lê a configuração em `~/.config/opencode/config.json` (global) ou em `./opencode.json` no seu projeto. Adicione:

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "firecrawl": {
      "type": "local",
      "command": ["npx", "-y", "firecrawl-mcp"],
      "environment": {
        "FIRECRAWL_API_KEY": "fc-YOUR-API-KEY"
      }
    }
  }
}
```

Substitua `fc-YOUR-API-KEY` pela sua chave da API do Firecrawl.

<div id="3-start-opencode">
  ### 3. Inicie o OpenCode [#3-inicie-o-opencode]
</div>

```bash
opencode
```

O OpenCode carrega os servidores MCP ao iniciar. Confirme que o Firecrawl está vinculado:

```
/mcp
```

<div id="quick-demo">
  ## Demo rápida [#demo-rápida]
</div>

```
Search the web for "Bun 2.0 changelog" and summarize the top results.
```

```
Scrape https://docs.firecrawl.dev/introduction and list the code examples.
```

```
Crawl https://example.com/blog and save each post as markdown.
```

<div id="remote-hosted-url-no-nodejs-required">
  ## URL hospedada remotamente (sem necessidade de Node.js) [#url-hospedada-remotamente-sem-necessidade-de-nodejs]
</div>

```json
{
  "mcp": {
    "firecrawl": {
      "type": "remote",
      "url": "https://mcp.firecrawl.dev/v2/mcp"
    }
  }
}
```

Esta configuração usa o conjunto de ferramentas keyless do Firecrawl. Para uma configuração vinculada a uma conta ou não supervisionada, siga os [modos de conexão MCP hospedados](/pt-BR/developer-guides/mcp-setup-guides/oauth); mantenha as chaves de API em um cabeçalho Authorization ou em um armazenamento seguro de segredos, nunca em uma URL.

<div id="troubleshooting">
  ## Solução de problemas [#solução-de-problemas]
</div>

* **Servidor não conectado** — execute `opencode doctor` para verificar erros de carregamento do MCP.
* **Permissão negada no `npx`** — instale o Node.js 18+ e verifique se seu shell reconhece a instalação (`which npx`).