Requirements
- Qwen Code 0.25 or newer.
- A Firecrawl API key, exported as
FIRECRAWL_API_KEY.
Quick setup
- Export your API key in the shell you start Qwen Code from:
- Add the server. Single quotes keep the shell from expanding the variable, so the settings file stores the reference instead of your key:
- Confirm the server connects:
- Start Qwen Code, run
/mcpto see the Firecrawl tools, and ask it to search or scrape.
Prefer to edit the settings file?
Prefer to edit the settings file?
Add the server to
~/.qwen/settings.json, or to .qwen/settings.json in a project:Try it
What you can do
Search
Find current information and read the content of relevant results.
Scrape
Turn URLs into clean markdown or structured data.
Interact
Navigate, click, and fill forms to reach the data you need.
Alexandria
Discover structured data tools, inspect inputs and pricing, then run them through Firecrawl.
Troubleshooting
- The server is missing in a running session: restart Qwen Code in the same project after adding it.
- The server shows as not connected: run
qwen mcp list, and check thatFIRECRAWL_API_KEYis exported in the shell that starts Qwen Code. - Tool calls are rejected for an invalid key: confirm the header value is
Bearer $FIRECRAWL_API_KEYand that the variable holds a valid key. - Tools are not used: some models call MCP tools more reliably than others. Try a different model.

