Firecrawl 怎么安装：MCP 与 CLI 两种方式

Firecrawl MCP 可把网页搜索、采集和解析能力接入支持 MCP 的 AI 客户端。

截至 2026 年 10 月 30 日，Firecrawl 官方 MCP 文档新增了免密钥体验、浏览器登录、API Key 和原生连接器等入口。现在值得重新安装，是因为连接方式已经从“必须先准备密钥”扩展为可先试用、再决定认证方案；普通用户不必先改本地开发环境。

先选路线：远程 MCP 还是本地 CLI

MCP（Model Context Protocol，模型上下文协议）是一套让 AI 客户端调用外部工具的接口规范。Firecrawl MCP 通过它提供网页搜索、页面抓取、文档解析、站点爬取等能力。

按官方口径推下来的选择建议是：只想给一个客户端加网页搜索，选远程 MCP；日常同时使用多个编码 Agent，选 CLI 的 --all 初始化方式更省事。这里的建议是路线对比，不是官方强制结论。

安装前准备这 3 项

1. 准备可用客户端。打开准备接入 Firecrawl 的 AI 客户端，确认其中存在 MCP 或工具连接入口；Claude Code 可在会话中输入 /mcp 查看连接。
2. 准备网络与浏览器。远程 OAuth 和 CLI 初始化都需要在浏览器完成登录，因此确认当前终端可以联网，并允许浏览器打开。
3. 确认额度与费用。官方 2026 年 10 月 30 日文档提供免账号试用，但设有每日限制；账户登录和 API Key 都进入团队的完整工具范围，费用取决于团队方案。现有官方材料没有列出统一价格，不应把免密钥模式当成无限使用。

方式一：安装远程 Firecrawl MCP

Claude Code 可直接复制下面这条官方命令：

claude mcp add --transport http firecrawl https://mcp.firecrawl.dev/v2/mcp-oauth

执行后，在 Claude Code 会话中输入：

/mcp

客户端会打开浏览器，登录 Firecrawl 并批准团队访问。回到客户端后，应能看到 firecrawl 已连接。

Cursor 用户不用运行上述命令：打开 Cursor Settings → MCP，添加 Firecrawl 的远程服务器，然后按界面提示完成 Firecrawl 登录。官方文档还提供 Claude Code、ChatGPT、Codex 等客户端的原生连接器入口。

如果现有客户端要求手写 JSON，可以采用 API Key 方式。这里要区分两个地址：浏览器登录流程用 /v2/mcp-oauth，而API Key 无人值守集成用 /v2/mcp（不带 oauth），并且必须在请求头里带上密钥。常见配置形态如下：

{
  "mcpServers": {
    "firecrawl": {
      "type": "http",
      "url": "https://mcp.firecrawl.dev/v2/mcp",
      "headers": {
        "Authorization": "Bearer ${FIRECRAWL_API_KEY}"
      }
    }
  }
}

官方文档特别强调两条红线：不要把 API Key 写进服务器 URL，也不要在聊天内容里粘贴密钥——密钥应放在客户端的安全 header 或 secret 配置里。如果把带 oauth 的地址误配给 API Key 场景，客户端会走浏览器登录流程而没有密钥参与，通常表现为连接成功但请求被拒。配置完成后可以在客户端的 MCP 面板里跑一次 /mcp，看到 firecrawl 已连接且工具列表能加载出来，才算真正接通。如果列表里只有 firecrawl 但没有具体工具（如 scrape、crawl），通常是服务端鉴权失败，检查 Bearer 头是否正确拼写。

需要预先准备 API Key 时，也可以让本地 MCP 进程读取环境变量：

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

把 fc-YOUR_API_KEY 替换成真实密钥后，将它放入客户端的 MCP 配置。若使用 VS Code，可按 Ctrl + Shift + P → Preferences: Open User Settings (JSON) 打开用户设置；项目级配置则使用 .vscode/mcp.json。

方式二：安装 Firecrawl CLI

CLI（命令行工具）方式会安装 Firecrawl CLI、在浏览器完成认证，并为检测到的编码 Agent 添加技能。官方提供的完整初始化命令是：

npx -y firecrawl-cli@latest init --all --browser

运行后等待浏览器完成 Firecrawl 登录，再重启正在使用的编码 Agent。重启是必要步骤：客户端需要重新扫描配置，才能发现刚添加的技能。

如果只想初始化当前检测到的 Agent，也可以将 --all 换成具体的客户端参数；但首次安装优先使用官方给出的完整命令，可以减少“技能装好了、客户端却没发现”的情况。

这条路线与远程 MCP 的差别不只是命令不同。远程 MCP 在客户端内暴露可调用的 firecrawl_scrape、firecrawl_search 等工具；CLI 则向编码 Agent 添加网页相关技能。前者适合调用明确工具，后者更适合让 Agent 按任务自动选择网页能力。

卡点：VS Code 拒绝加载配置

中文官方文档记录过一类真实问题：VS Code 可能“以过时的模式格式（microsoft/vscode#155379）验证 JSON 的方式”导致 Firecrawl MCP 无法在服务器列表中注册。这个问题会影响多个 MCP 工具，并非 Firecrawl 独有。

可执行的处理方式：

1. 打开 VS Code 设置，搜索 JSON validation 或 JSON Schema Validation。
2. 暂时关闭相关 JSON Schema 校验。
3. 重新加载 VS Code 窗口。
4. 回到 Settings → MCP 或项目中的 .vscode/mcp.json，检查 Firecrawl 是否出现。

文档同时指出：通过其他扩展调用时，MCP 服务器仍可能正常工作；故障集中在直接通过 MCP 服务器列表注册时。因此修改校验前，先确认你使用的是列表注册路径，避免为了一个显示问题改动过多全局设置。

怎么确认安装成功

远程 MCP 安装成功后，客户端的 MCP 页面应显示 firecrawl 已连接；Claude Code 中可用 /mcp 检查状态。CLI 方式则需要重启编码 Agent，并确认技能列表中出现 Firecrawl 相关技能。

最后做一次最小验证：让客户端抓取一个确定公开的网址，并要求返回页面 Markdown；或者要求搜索一个明确主题。成功结果应包含目标页面的正文，而不是只有服务器已连接的文字状态。

工具选择也有边界。已知 URL 直接读取时用 firecrawl_scrape；只知道关键词时用 firecrawl_search。官方 README 特别提醒：给搜索结果附加 scrapeOptions 会抓取每条结果页，并按 scrape 计费；因此只需要少量完整正文时，不要无条件展开所有搜索结果。

官方入口与后续配置

• Firecrawl MCP 官方仓库与 README：查看功能、工具选择和自托管说明。
• Firecrawl MCP Get Started：选择免密钥、浏览器登录或 API Key，并查看各客户端入口。
• Firecrawl 文档 Introduction：查看远程服务器、CLI 和 Agent 接入示例。