Skip to main content
当客户端需要启动本地进程、需要使用本地 HTTP 传输，或 MCP 服务器必须连接自托管 Firecrawl API 时，请在本地运行 Firecrawl MCP。对于托管服务，请使用Agent MCP或Human MCP。

​
前置条件

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

​
启动服务器

当 MCP 客户端以本地进程方式启动 Firecrawl 时，使用 stdio：
将客户端配置为运行 npx -y firecrawl-mcp@3.23.4，并通过客户端的受保护环境变量或密钥机制提供 FIRECRAWL_API_KEY。

​
配置 Firecrawl API

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

​
全局安装

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

​
故障排除

安装 Node.js 22 或更高版本，确认客户端的 PATH 中包含 npx，然后彻底重启客户端。在 Windows 上，请在命令提示符中运行 where npx，并将客户端配置为使用返回的 npx.cmd 路径。
确认已设置 HTTP_STREAMABLE_SERVER=true，然后访问 http://localhost:3000/health。客户端端点应使用 http://localhost:3000/mcp，而非托管的 /v2/mcp 路径。
工具是否可用取决于目标部署中启用的 Firecrawl 服务。请对照工具检查连接，并查看本地进程输出中是否有注册或身份验证错误。
限流由所连接的 Firecrawl API 执行。请查看当前的限流以及自托管部署配置的限制。