1. Home
  2. Firecrawl MCP Server
  3. Firecrawl MCP Server for Claude Code: Setup & Config

Data as of

Firecrawl MCP Server for Claude Code: Setup & Config

Firecrawl MCP connects Claude Code to web search, scraping, crawling, and live browser interaction.

Firecrawl MCP Server Claude Code configuration

  1. Choose Claude Code configuration scope

    For Firecrawl MCP Server, open Project scope: .mcp.json at the repository root. Project JSON: merge into mcpServers; user scope: use the CLI.

  2. Add Firecrawl MCP Server to Claude Code

    Use the firecrawl-mcp-server entry below in mcpServers. Keep Firecrawl MCP Server's documented stdio connection fields and your other Claude Code entries.

  3. Check Firecrawl MCP Server in Claude Code

    Firecrawl MCP Server: Inspect claude mcp list and /mcp status.

Config file · Project scope: .mcp.json at the repository root

JSON
{
  "mcpServers": {
    "firecrawl-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "firecrawl-mcp"
      ],
      "env": {
        "FIRECRAWL_API_KEY": "<your Firecrawl API key>"
      }
    }
  }
}

CLI (POSIX shell)
claude mcp add-json --scope project 'firecrawl-mcp-server' '{"type":"stdio","command":"npx","args":["-y","firecrawl-mcp"],"env":{"FIRECRAWL_API_KEY":"<your Firecrawl API key>"}}'

Firecrawl in Claude Code: stdio checks

  • If Firecrawl MCP Server fails to start, check npx firecrawl-mcp (Node.js/npm), the working directory, and Claude Code's selected scope; inspect claude mcp list and /mcp.
  • Firecrawl MCP Server: check FIRECRAWL_API_KEY; keep credentials out of shared .mcp.json.
  • Firecrawl MCP Server uses stdio here: Claude Code must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
Tools
firecrawl_scrape, firecrawl_map, firecrawl_search

Firecrawl MCP Server — details. Claude Code guide

Frequently asked questions

Register Firecrawl MCP Server with the displayed claude mcp add-json --scope project command, or merge the JSON into .mcp.json at the repository root.

Claude Code's firecrawl-mcp-server example uses stdio.

Firecrawl MCP Server's Claude Code configuration invokes npx firecrawl-mcp (Node.js/npm).

Claude Code's Firecrawl MCP Server example references FIRECRAWL_API_KEY. Check these names if startup or authentication fails; the example alone does not distinguish required from optional values.

Firecrawl MCP Server's stored list contains 27 tools, including firecrawl_scrape, firecrawl_map, firecrawl_search. Compare those names with Claude Code's connected tool list; the stored list is not a live check.