Firecrawl MCP server in Claude Desktop give Claude real web access.
Claude Desktop can't browse the web on its own plan limits alone — Firecrawl gives it proper scrape, crawl, and extract tools. The config is one JSON block; the gotchas are the file path and the restart.
Firecrawl MCP Server (6.5k stars, github.com/firecrawl/firecrawl-mcp-server) turns Claude Desktop into a research tool that can actually fetch pages: scrape a URL into clean markdown, search the web, crawl a whole site, or extract structured data from messy HTML.
Claude Desktop has no settings UI for MCP servers — you edit claude_desktop_config.json by hand and restart the app. That makes the file path and the restart the two places where most setups go wrong, so this guide is specific about both.
Prerequisites
You need Node.js installed (Claude Desktop spawns the server with npx, which ships with Node) and a Firecrawl API key from firecrawl.dev — keys start with fc-. The MCP server package is open source; the key authenticates the actual scraping calls against Firecrawl's hosted API.
If you run a self-hosted Firecrawl instance instead, the same MCP server can point at it: add FIRECRAWL_API_URL to the env block with your instance's address, and the API key becomes optional. Everything else in this guide stays identical — only the backend changes.
Find and edit claude_desktop_config.json
On macOS the file is at ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows it's %APPDATA%\Claude\claude_desktop_config.json. The quickest way to open it is from inside the app: Settings, then Developer, then Edit Config. If the file doesn't exist yet, that button creates it.
Add Firecrawl under the mcpServers key:
{
"mcpServers": {
"firecrawl": {
"command": "npx",
"args": ["-y", "firecrawl-mcp"],
"env": {
"FIRECRAWL_API_KEY": "fc-YOUR-API-KEY"
}
}
}
}Restart properly, then test
Claude Desktop only reads the config at launch, and closing the window does not quit the app. Quit it fully — Cmd+Q on macOS, or right-click the system tray icon on Windows and choose Quit — then reopen. The Firecrawl tools should appear under the tools icon in the chat input.
Test with something concrete: "scrape https://news.ycombinator.com and list the top five headlines." If Claude asks permission to run a Firecrawl tool and returns real titles, everything works. You can cross-check the expected tool list on the server's live listing at https://loomal.ai/marketplace/firecrawl-mcp-server.
Troubleshooting in Claude Desktop
No tools after restart: first confirm you actually quit the app rather than closing the window — this is the single most common failure. Next, validate the JSON; a stray trailing comma makes Claude Desktop silently ignore the entire mcpServers block.
Still nothing: read the logs. macOS writes them to ~/Library/Logs/Claude/ (look for mcp-server-firecrawl.log and mcp.log); on Windows they're under %APPDATA%\Claude\logs. A spawn error there usually means npx isn't on the PATH Claude Desktop sees — common with nvm installs. Fix it by setting command to the absolute path of npx (`which npx` on macOS, `where npx` on Windows). 401 errors in the log mean the fc- key is wrong or was pasted with whitespace.
FAQ
How do I install Firecrawl in Claude Desktop?
Edit claude_desktop_config.json (Settings > Developer > Edit Config), add a firecrawl entry under mcpServers with command npx, args ["-y", "firecrawl-mcp"], and your FIRECRAWL_API_KEY in env, then fully quit and reopen Claude Desktop.
Where is Claude Desktop's MCP config file?
On macOS: ~/Library/Application Support/Claude/claude_desktop_config.json. On Windows: %APPDATA%\Claude\claude_desktop_config.json. There's no Linux build of Claude Desktop as of mid-2026, so those are the two paths that matter.
I restarted and Firecrawl still doesn't show up — what's wrong?
In order of likelihood: the app wasn't fully quit (use Cmd+Q or the tray icon, not the window close button), the JSON has a syntax error, or npx isn't reachable from Claude Desktop's environment. The logs in ~/Library/Logs/Claude/ or %APPDATA%\Claude\logs will tell you which.
Is Firecrawl free to use this way?
The MCP server software is open source and free. The scraping itself runs through Firecrawl's API and counts against your fc- key's plan — firecrawl.dev has a free tier; check their docs for current limits.
More MCP servers for Claude Desktop.
Browse scraping, search, and productivity servers with live tool lists.