> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-ul56gh.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Busca na web e scraping via MCP no Codex CLI

> Adicione a busca e o scraping na web do Firecrawl ao OpenAI Codex CLI

Conecte o [OpenAI Codex CLI](https://github.com/openai/codex) ao Firecrawl por meio do servidor MCP hospedado com OAuth.

<h2 id="quick-setup">
  Configuração rápida
</h2>

<h3 id="1-add-firecrawl">
  1. Adicione o Firecrawl
</h3>

```bash theme={null}
codex mcp add firecrawl --url https://mcp.firecrawl.dev/v2/mcp-oauth
codex mcp login firecrawl
```

A URL é um valor de configuração do cliente, não uma página para ser aberta diretamente no navegador. O Codex abre o fluxo de login do Firecrawl, no qual você escolhe uma equipe e aprova a conexão.

<h3 id="2-start-codex-and-verify">
  2. Inicie o Codex e verifique
</h3>

```bash theme={null}
codex
```

Digite `/mcp` e confirme que `firecrawl` está conectado. Se você alterou uma conexão existente do Firecrawl, inicie uma nova sessão do Codex antes de tentar novamente.

Experimente:

```text theme={null}
Search the web for the latest Next.js App Router release notes and summarize the sources.
```

```text theme={null}
Scrape https://docs.firecrawl.dev and list the top-level sections.
```

<h2 id="other-connection-modes">
  Outras formas de conexão
</h2>

* [Experimente o MCP sem chave](/pt-BR/mcp-server/keyless#try-keyless) para busca, scraping e parse sem conta nem chave.
* [Configure uma chave de API](/pt-BR/mcp-server/keyless#add-an-api-key) com `bearer_token_env_var` para uso não assistido. Mantenha o segredo fora do chat do agente e do controle de versão.
* [Execute o MCP localmente](/pt-BR/mcp-server/local) apenas se precisar de um processo local ou de uma API do Firecrawl auto-hospedada. O pacote local requer o Node.js 22 ou mais recente.

<h2 id="optional-literature-research">
  Opcional: pesquisa bibliográfica
</h2>

Para trabalhos com artigos científicos e literatura, a skill research-index direciona essas queries para as ferramentas `firecrawl_research_*` e o [Research Index](/pt-BR/features/research), em vez da busca geral na web:

```bash theme={null}
npx skills add firecrawl/skills@firecrawl-research-index
```

<h2 id="troubleshooting">
  Solução de problemas
</h2>

* **O Codex não detecta as ferramentas:** execute `codex mcp list`, confirme que há apenas uma entrada `firecrawl` e reinicie o Codex.
* **O OAuth retorna `401`:** execute `codex mcp login firecrawl` e faça login. É esperado que uma solicitação sem credenciais ao servidor OAuth retorne `401` antes da autenticação.
* **Uma conexão com chave de API retorna `401`:** substitua a chave no ambiente que inicia o Codex e inicie uma nova sessão.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.