在本地运行 Firecrawl MCP

通过 stdio 或 Streamable HTTP 启动并配置开源 Firecrawl MCP 服务器。

当客户端需要启动本地进程、需要使用本地 HTTP 传输，或 MCP 服务器必须连接自托管 Firecrawl API 时，请在本地运行 Firecrawl MCP。对于托管服务，请从MCP 设置开始。

​

前置条件

• Node.js 22 或更高版本
• Node.js 自带的 npm 和 npx
• 云端 API 所需的 Firecrawl API 密钥，或自托管 Firecrawl API 的 URL

确认已安装的 Node.js 版本：

node --version

​

启动服务器

stdio

当 MCP 客户端以本地进程方式启动 Firecrawl 时，使用 stdio：

env FIRECRAWL_API_KEY=fc-YOUR-API-KEY \
  npx -y firecrawl-mcp@3.23.7

将客户端配置为运行 npx -y firecrawl-mcp@3.23.7，并通过客户端的受保护环境变量或密钥机制提供 FIRECRAWL_API_KEY。

Streamable HTTP

当 n8n 等客户端连接到已运行的服务器时，使用 HTTP：

env HTTP_STREAMABLE_SERVER=true \
  FIRECRAWL_API_KEY=fc-YOUR-API-KEY \
  npx -y firecrawl-mcp@3.23.7

将客户端连接到：

http://localhost:3000/mcp

确认服务器已就绪：

curl http://localhost:3000/health

健康检查将返回 ok。本地路由为 /mcp；/v2/mcp 属于托管的 Firecrawl 服务。

​

配置 Firecrawl API

环境变量	用途
FIRECRAWL_API_KEY	用于向 Firecrawl 云端 API 进行身份验证。只有在自托管 API 无需身份验证时，该变量才是可选的。
FIRECRAWL_API_URL	将请求发送至自托管 Firecrawl API，而不是云端 API。
HTTP_STREAMABLE_SERVER	设为 true 可启动本地 Streamable HTTP 传输，而非 stdio。

云端 API

export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
npx -y firecrawl-mcp@3.23.7

使用 firecrawl_parse 直接解析本地文件时，FIRECRAWL_API_URL 必须指向自托管 Firecrawl API。仅连接云端 API 的本地 MCP 服务器无法通过该工具上传本地文件；托管服务器则使用签名上传交接。

​

全局安装

使用 npx 可快速完成设置。如需全局安装同一经过审核的版本：

npm install -g firecrawl-mcp@3.23.7

然后运行：

env FIRECRAWL_API_KEY=fc-YOUR-API-KEY firecrawl-mcp

​

故障排除

客户端报错 spawn npx ENOENT

安装 Node.js 22 或更高版本，确认客户端的 PATH 中包含 npx，然后彻底重启客户端。在 Windows 上，请在命令提示符中运行 where npx，并将客户端配置为使用返回的 npx.cmd 路径。

HTTP 客户端无法连接

确认已设置 HTTP_STREAMABLE_SERVER=true，然后访问 http://localhost:3000/health。客户端端点应使用 http://localhost:3000/mcp，而非托管的 /v2/mcp 路径。

工具不可用

工具是否可用取决于目标部署中启用的 Firecrawl 服务。请对照工具检查连接，并查看本地进程输出中是否有注册或身份验证错误。

服务器已被限流

限流由所连接的 Firecrawl API 执行。请查看当前的限流以及自托管部署配置的限制。