# Busca na web e scraping via MCP no Codex CLI (/pt-BR/quickstarts/codex-cli)

<!-- agent-signals: reading_time_min: 1 · est_tokens: 599 · 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 [OpenAI Codex CLI](https://github.com/openai/codex) 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-codex">
  ### 2. Adicione o Firecrawl ao Codex [#2-adicione-o-firecrawl-ao-codex]
</div>

O Codex lê a configuração do servidor MCP em `~/.codex/config.toml`. Adicione o servidor Firecrawl:

```toml
[mcp_servers.firecrawl]
command = "npx"
args = ["-y", "firecrawl-mcp"]

[mcp_servers.firecrawl.env]
FIRECRAWL_API_KEY = "fc-YOUR-API-KEY"
```

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

<div id="3-start-codex">
  ### 3. Iniciar o Codex [#3-iniciar-o-codex]
</div>

```bash
codex
```

O Codex detecta as ferramentas do Firecrawl ao iniciar. Confirme se elas foram carregadas:

```bash
/mcp
```

Você deverá ver `firecrawl` listado com ferramentas como `firecrawl_search`, `firecrawl_scrape`, `firecrawl_crawl` e `firecrawl_extract`.

<div id="quick-demo">
  ## Demonstração rápida [#demonstração-rápida]
</div>

Experimente estes prompts:

```
Search the web for the latest Next.js App Router release notes and summarize.
```

```
Scrape https://docs.firecrawl.dev and list the top-level sections.
```

```
Crawl https://example.com and save the markdown for every page under /blog.
```

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

Se preferir não executar `npx` localmente:

```toml
[mcp_servers.firecrawl]
url = "https://mcp.firecrawl.dev/v2/mcp-oauth"
```

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

* **O Codex não reconhece as ferramentas** — execute `codex --version` para confirmar que você está usando uma versão com suporte a MCP e, em seguida, reinicie a CLI após editar `config.toml`.
* **`spawn npx ENOENT`** — instale o Node.js 18+ e verifique se `npx` está no seu `PATH`, ou use a URL hospedada remotamente acima.
* **401 / chave inválida** — gere uma nova chave de API em [firecrawl.dev/app/api-keys](https://www.firecrawl.dev/app/api-keys).