How to Connect Firecrawl Web Scraper Remote MCP to OpenAI Codex CLI

Add Firecrawl's remote MCP server to OpenAI Codex CLI in about a minute.

๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPBearer Tokenยทhttps://mcp.firecrawl.dev/v2/mcp

Step-by-step

  1. Edit ~/.codex/config.toml
    Add the [mcp_servers.firecrawl] table shown in the connect card (TOML) to ~/.codex/config.toml โ€” Codex loads remote MCP servers at startup.
  2. Authorize
    Add an Authorization: Bearer <your-key> header in the server's config โ€” get the credential from https://docs.firecrawl.dev/.
  3. Verify
    Restart Codex, then run codex mcp list (or ask the agent to call a tool). Verify in the browser: paste https://mcp.firecrawl.dev/v2/mcp into remotemcp.net/inspector and run initialize + tools/list.

Troubleshooting OAuth / 401

  • A 401 Unauthorized on first connect is normal โ€” the endpoint is OAuth-protected; let OpenAI Codex CLI finish the browser consent flow.
  • If the consent window never opens, remove and re-add the server, then retry.
  • Check the exact challenge at our OAuth debugger.
  • Run the live endpoint through the online inspector to see the raw JSON-RPC exchange.
Streamable HTTPhttps://mcp.firecrawl.dev/v2/mcp

๐Ÿ”’ Client-side only โ€” never leaves your browser.

Add to ~/.codex/config.toml โ€” Codex reads remote HTTP servers from [mcp_servers.*] tables:

[mcp_servers.firecrawl]
url = "https://mcp.firecrawl.dev/v2/mcp"
bearer_token_env_var = "FIRECRAWL_TOKEN"

Tools exposed by Firecrawl Web Scraper MCP (10)

ToolSafetyDescriptionParameters
firecrawl_scrape
~32 tok
๐ŸŸข ReadScrape a URL into clean markdown.โ€”
firecrawl_map
~30 tok
๐ŸŸข ReadMap a website's URL structure.โ€”
firecrawl_crawl
~32 tok
๐ŸŸ  WriteStart an async crawl of a website.โ€”
firecrawl_check_crawl_status
~33 tok
๐ŸŸข ReadCheck status of a crawl job.โ€”
firecrawl_search
~32 tok
๐ŸŸข ReadSearch the web and scrape results.โ€”
firecrawl_extract
~32 tok
๐ŸŸข ReadExtract structured data from URLs.โ€”
firecrawl_deep_research
~33 tok
๐ŸŸ  WriteRun deep research across the web.โ€”
firecrawl_generate_llmstxt
~33 tok
๐ŸŸข ReadGenerate llms.txt for a site.โ€”
firecrawl_batch_scrape
~32 tok
๐ŸŸข ReadBatch-scrape multiple URLs.โ€”
firecrawl_extract_status
~33 tok
๐ŸŸข ReadGet status of an extract job.โ€”

Connect Firecrawl Web Scraper MCP to another client

Other servers for OpenAI Codex CLI

GitHub's official remote MCP server hosted at api.githubcopilot.com. Gives AI agents first-party access to repositories, issues, pull requests and code search.

https://api.githubcopilot.com/mcp/
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~3096 tok92 toolsOnline310ms
Notion MCPNotion Labs

Notion's official hosted MCP server. Agents can search your workspace, read and create pages, and query databases over Streamable HTTP or SSE.

https://mcp.notion.com/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedHTTP + SSEOAuth 2.1๐Ÿ›ก๏ธ A+~606 tok18 toolsOnline21ms
Linear MCPLinear Orbit Inc.

Linear's official remote MCP server. Agents can search, create and update issues and query your team's workflow over Streamable HTTP or SSE.

https://mcp.linear.app/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedHTTP + SSEOAuth 2.1๐Ÿ›ก๏ธ A+~899 tok30 toolsOnline8ms

Figma's official remote MCP server. Agents can pull design context, variables, Code Connect mappings and screenshots from your Figma files.

https://mcp.figma.com/mcp
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿงฉ MCP App๐Ÿ›ก๏ธ A+~286 tok8 toolsOnline218ms
AWS KnowledgeAmazon Web Services

AWS Knowledge's hosted remote MCP server. AWS's fully-managed public knowledge MCP gives agents access to the latest AWS documentation, API references, What's New posts and architectural guidance across all AWS services. It is public and unauthenticated โ€” connect and call tools immediately.

https://knowledge-mcp.global.api.aws
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPPublic ยท No Auth๐Ÿ›ก๏ธ A+~1896 tok5 toolsOnline178ms

Stripe's official remote MCP server at mcp.stripe.com. Agents can query customers, payment intents and subscriptions and invoke Stripe API operations with OAuth.

https://mcp.stripe.com
๐Ÿ›ก๏ธ Officialโœ“ VerifiedStreamable HTTPOAuth 2.1๐Ÿ›ก๏ธ A+~1336 tok43 toolsOnline225ms