Conecte o OpenAI Codex CLI ao Firecrawl por meio do servidor MCP hospedado com OAuth.
Configuração rápida#
1. Adicione o 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.
2. Inicie o Codex e verifique#
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:
Outras formas de conexão#
- Experimente o MCP sem chave para busca, scraping e parse sem conta nem chave.
- Configure uma chave de API com
bearer_token_env_varpara uso não assistido. Mantenha o segredo fora do chat do agente e do controle de versão. - Execute o MCP localmente 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.
Opcional: pesquisa bibliográfica#
Para trabalhos com artigos científicos e literatura, a skill research-index direciona essas queries para as ferramentas firecrawl_research_* e o Research Index, em vez da busca geral na web:
Solução de problemas#
- O Codex não detecta as ferramentas: execute
codex mcp list, confirme que há apenas uma entradafirecrawle reinicie o Codex. - O OAuth retorna
401: executecodex mcp login firecrawle faça login. É esperado que uma solicitação sem credenciais ao servidor OAuth retorne401antes 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.

