在客户端中配置 Firecrawl MCP

请先参阅连接 Firecrawl MCP，选择账户 OAuth、无人值守的 API 密钥访问或免密钥访问。以下客户端专用示例均采用相同的模式感知约定。

在 Cursor 中运行

一键安装托管的免密钥服务器 (无需 API 密钥) ：

或者，手动将其添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp"
    }
  }
}

使用 API 密钥在本地运行

注意：需要 Cursor 0.45.6 或更高版本。如需最新配置说明，请参阅 Cursor 官方 MCP 服务器配置文档： Cursor MCP Server 配置指南在 Cursor v0.48.6 中配置 Firecrawl MCP

打开 Cursor 设置
前往 Features > MCP Servers
点击“+ Add new global MCP server”

输入以下代码：

{
  "mcpServers": {
    "firecrawl-mcp": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR-API-KEY"
      }
    }
  }
}

在 Cursor v0.45.6 中配置 Firecrawl MCP

打开 Cursor 设置
前往 Features > MCP Servers
点击“+ Add New MCP Server”
输入以下内容：
- 名称：“firecrawl-mcp” (或您自定义的名称)
- 类型：“command”
- 命令：env FIRECRAWL_API_KEY=your-api-key npx -y firecrawl-mcp@3.22.4

如果您使用 Windows 时遇到问题，请尝试 cmd /c "set FIRECRAWL_API_KEY=your-api-key && npx -y firecrawl-mcp@3.22.4"

将 your-api-key 替换为您的 Firecrawl API 密钥。如果您还没有 API 密钥，可以创建账户并在 https://www.firecrawl.dev/app/api-keys 获取。添加后，刷新 MCP 服务器列表即可看到新工具。Composer 代理会在适当时自动使用 Firecrawl MCP，但您也可以通过描述网页数据需求来明确要求使用它。按 Command+L (Mac) 打开 Composer，在提交按钮旁选择“Agent”，然后输入您的查询。

在 Windsurf 中运行

将以下内容添加到 ./codeium/windsurf/model_config.json：

{
  "mcpServers": {
    "mcp-server-firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

以 Streamable HTTP 模式运行

如需在本地以 Streamable HTTP 传输方式运行服务器，而非使用默认的 stdio 传输方式：

env HTTP_STREAMABLE_SERVER=true FIRECRAWL_API_KEY=fc-YOUR_API_KEY npx -y firecrawl-mcp@3.22.4

本地使用 URL：http://localhost:3000/v2/mcp；或使用托管地址：https://mcp.firecrawl.dev/v2/mcp

通过 Smithery 安装 (旧版)

要通过 Smithery 自动为 Claude Desktop 安装 Firecrawl：

npx -y @smithery/cli install @mendableai/mcp-server-firecrawl --client claude

在 VS Code 中运行

如需一键安装，请点击以下任一安装按钮……

如需手动安装，请将以下 JSON 块添加到 VS Code 的“用户设置 (JSON)”文件中。按 Ctrl + Shift + P，然后输入 Preferences: Open User Settings (JSON) 即可打开该文件。

{
  "mcp": {
    "inputs": [
      {
        "type": "promptString",
        "id": "apiKey",
        "description": "Firecrawl API Key",
        "password": true
      }
    ],
    "servers": {
      "firecrawl": {
        "command": "npx",
        "args": ["-y", "firecrawl-mcp"],
        "env": {
          "FIRECRAWL_API_KEY": "${input:apiKey}"
        }
      }
    }
  }
}

您也可以将其添加到工作区中的 .vscode/mcp.json 文件，以便与他人共享该配置：

{
  "inputs": [
    {
      "type": "promptString",
      "id": "apiKey",
      "description": "Firecrawl API Key",
      "password": true
    }
  ],
  "servers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "${input:apiKey}"
      }
    }
  }
}

**注意：**部分用户报告称，由于 VS Code 使用过时的 schema 格式验证 JSON，将 MCP 服务器添加到 VS Code 时会遇到问题 (microsoft/vscode#155379) 。这会影响包括 Firecrawl 在内的多种 MCP 工具。 **解决方法：**在 VS Code 中禁用 JSON 验证，以便 MCP 服务器能够正常加载。请参见：directus/directus#25906 (评论) 。通过其他扩展调用 MCP 服务器时仍可正常使用，但直接在 MCP 服务器列表中注册时会出现此问题。待 VS Code 更新其 schema 验证后，我们会补充相关说明。

在 Claude Desktop 上运行

如需以交互方式连接账户，请添加账户端点并完成浏览器 OAuth 流程：

{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth"
    }
  }
}

对于无人值守或使用 API 密钥的配置，请改用 https://mcp.firecrawl.dev/v2/mcp，并设置 Authorization: Bearer <FIRECRAWL_API_KEY> 请求头。如果出现 “无法连接到 MCP 服务器” 错误，可能是你的 Claude Desktop 版本不支持 Streamable HTTP 传输。请改用本地 npx 方式 (需要 Node.js) ：

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

如果出现 spawn npx ENOENT 错误，说明 Node.js 未安装，或未添加到系统 PATH。从 nodejs.org 安装 Node.js (LTS 版本) ，然后完全重启 Claude Desktop。在 Windows 上，也可以在命令提示符中运行 where npx，并将完整路径 (例如 C:\\Program Files\\nodejs\\npx.cmd) 作为 command 的值。

在 Claude Code 中运行

使用 Claude Code CLI 添加 Firecrawl MCP 服务器。您可以使用远程托管 URL，或在本地运行：

# 交互式连接账户（推荐）
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth

# 如需无人值守的 API 密钥配置，请使用 Authorization 请求头
claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp --header "Authorization: Bearer <FIRECRAWL_API_KEY>"

# 或通过 npx 在本地运行
claude mcp add firecrawl -e FIRECRAWL_API_KEY=fc-your-api-key -- npx -y firecrawl-mcp@3.22.4

在 Google Antigravity 上运行

Google Antigravity 支持通过其代理界面直接配置 MCP 服务器。

在编辑器中打开代理侧边栏，或打开代理管理器视图
点击 ”…” (更多操作) 菜单，然后选择 MCP 服务器
选择 查看原始配置，打开本地 mcp_config.json 文件
添加以下配置：

{
  "mcpServers": {
    "firecrawl": {
      "command": "npx",
      "args": ["-y", "firecrawl-mcp"],
      "env": {
        "FIRECRAWL_API_KEY": "YOUR_FIRECRAWL_API_KEY"
      }
    }
  }
}

保存文件，然后在 Antigravity MCP 界面中点击刷新，即可看到新工具。

将 YOUR_FIRECRAWL_API_KEY 替换为你的 API 密钥。

在 n8n 中运行

要在 n8n 中连接 Firecrawl MCP 服务器：

前往 https://firecrawl.dev/app/api-keys 获取您的 Firecrawl API 密钥
在 n8n 工作流中添加 AI 代理 节点
在 AI 代理配置中添加新的工具
选择 MCP Client Tool 作为工具类型
输入 MCP 服务器端点：

  https://mcp.firecrawl.dev/v2/mcp

将 Server Transport 设置为 HTTP Streamable
将 Authentication 设置为 Bearer，然后粘贴您的 Firecrawl API 密钥；或者保留为 None，以使用免密钥免费档位
在 Tools to include 中，您可以选择 All、Selected 或 All Except，这将启用相应的 Firecrawl 工具 (scrape、crawl、map、search、extract 等)

对于自托管部署，请使用 npx 运行 MCP 服务器，并启用 HTTP 传输模式：

env HTTP_STREAMABLE_SERVER=true \
    FIRECRAWL_API_KEY=fc-YOUR_API_KEY \
    FIRECRAWL_API_URL=YOUR_FIRECRAWL_INSTANCE \
    npx -y firecrawl-mcp@3.22.4

这会在 http://localhost:3000/v2/mcp 启动服务器，你可以在 n8n 工作流中将其用作端点。由于 n8n 需要使用 HTTP 传输，因此必须设置 HTTP_STREAMABLE_SERVER=true 环境变量。

快速上手

核心端点

更多

快速入门

开发者指南

Webhooks

使用场景

其他

参与贡献

在客户端中配置 Firecrawl MCP

在 Cursor 中运行

使用 API 密钥在本地运行

在 Windsurf 中运行

以 Streamable HTTP 模式运行

通过 Smithery 安装 (旧版)

在 VS Code 中运行

在 Claude Desktop 上运行

在 Claude Code 中运行

在 Google Antigravity 上运行

在 n8n 中运行

​在 Cursor 中运行

​使用 API 密钥在本地运行

​在 Windsurf 中运行

​以 Streamable HTTP 模式运行

​通过 Smithery 安装 (旧版)

​在 VS Code 中运行

​在 Claude Desktop 上运行

​在 Claude Code 中运行

​在 Google Antigravity 上运行

​在 n8n 中运行

在 Cursor 中运行

使用 API 密钥在本地运行

在 Windsurf 中运行

以 Streamable HTTP 模式运行

通过 Smithery 安装 (旧版)

在 VS Code 中运行

在 Claude Desktop 上运行

在 Claude Code 中运行

在 Google Antigravity 上运行

在 n8n 中运行