> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-27eiio.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 在本地运行 Firecrawl MCP

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

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

<div id="prerequisites">
  ## 前置条件
</div>

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

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

```bash theme={null}
node --version
```

<div id="start-the-server">
  ## 启动服务器
</div>

<Tabs>
  <Tab title="stdio">
    当 MCP 客户端以本地进程方式启动 Firecrawl 时，使用 stdio：

    ```bash theme={null}
    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`。
  </Tab>

  <Tab title="Streamable HTTP">
    当 n8n 等客户端连接到已运行的服务器时，使用 HTTP：

    ```bash theme={null}
    env HTTP_STREAMABLE_SERVER=true \
      FIRECRAWL_API_KEY=fc-YOUR-API-KEY \
      npx -y firecrawl-mcp@3.23.7
    ```

    将客户端连接到：

    ```text theme={null}
    http://localhost:3000/mcp
    ```

    确认服务器已就绪：

    ```bash theme={null}
    curl http://localhost:3000/health
    ```

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

<div id="configure-the-firecrawl-api">
  ## 配置 Firecrawl API
</div>

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

<CodeGroup>
  ```bash 云端 API theme={null}
  export FIRECRAWL_API_KEY=fc-YOUR-API-KEY
  npx -y firecrawl-mcp@3.23.7
  ```

  ```bash 自托管 API theme={null}
  export FIRECRAWL_API_URL=https://firecrawl.your-domain.com
  export FIRECRAWL_API_KEY=your-api-key # 如果实例无需身份验证，可省略
  npx -y firecrawl-mcp@3.23.7
  ```
</CodeGroup>

<Note>
  使用 `firecrawl_parse` 直接解析本地文件时，`FIRECRAWL_API_URL` 必须指向自托管 Firecrawl API。仅连接云端 API 的本地 MCP 服务器无法通过该工具上传本地文件；[托管服务器则使用签名上传交接](/zh/mcp-server/tools#important-behavior)。
</Note>

<div id="install-globally">
  ## 全局安装
</div>

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

```bash theme={null}
npm install -g firecrawl-mcp@3.23.7
```

然后运行：

```bash theme={null}
env FIRECRAWL_API_KEY=fc-YOUR-API-KEY firecrawl-mcp
```

<div id="troubleshooting">
  ## 故障排除
</div>

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

  <Accordion title="HTTP 客户端无法连接">
    确认已设置 `HTTP_STREAMABLE_SERVER=true`，然后访问 `http://localhost:3000/health`。客户端端点应使用 `http://localhost:3000/mcp`，而非托管的 `/v2/mcp` 路径。
  </Accordion>

  <Accordion title="工具不可用">
    工具是否可用取决于目标部署中启用的 Firecrawl 服务。请对照[工具](/zh/mcp-server/tools)检查连接，并查看本地进程输出中是否有注册或身份验证错误。
  </Accordion>

  <Accordion title="服务器已被限流">
    限流由所连接的 Firecrawl API 执行。请查看当前的[限流](/zh/rate-limits)以及自托管部署配置的限制。
  </Accordion>
</AccordionGroup>