Skip to main content
Connect OpenAI Codex CLI to Firecrawl through the hosted OAuth MCP server.

​
Quick setup

​
1. Add Firecrawl

The URL is a client configuration value, not a page to open directly in a browser. Codex opens the Firecrawl sign-in flow, where you choose a team and approve the connection.

​
2. Start Codex and verify

Enter /mcp and confirm that firecrawl is connected. If you changed an existing Firecrawl connection, start a new Codex session before retrying. Try:

​
Other connection modes

  • Try keyless MCP for Search, Scrape, and Parse without an account or key.
  • Configure an API key with bearer_token_env_var for unattended use. Keep the secret outside agent chat and source control.
  • Run MCP locally only when you need a local process or a self-hosted Firecrawl API. The local package requires Node.js 22 or newer.

​
Troubleshooting

  • Codex does not see the tools: run codex mcp list, confirm that only one firecrawl entry exists, and restart Codex.
  • OAuth returns 401: run codex mcp login firecrawl and complete sign-in. A bare request to the OAuth server is expected to return 401 before authentication.
  • An API-key connection returns 401: replace the key in the environment that starts Codex, then start a new session.