Firecrawl MCP 登录配置：获取 API 密钥并完成鉴权

Firecrawl MCP（把网页搜索、抓取、解析等能力接入 AI 客户端的 MCP 服务器）有两种常用鉴权方式：浏览器登录，或使用 API 密钥；按 2026-10-30 更新的官方文档，下面给出可直接复制的配置路径。

先选登录方式：OAuth 还是 API 密钥

两种方式都能访问团队套餐中的完整工具集，区别主要在于是否需要浏览器，以及密钥应该放在哪里。

方式	适合谁	客户端配置	是否需要 API 密钥
OAuth 浏览器登录	想快速连接、已经在使用 Codex 或 Claude Code 的用户	https://mcp.firecrawl.dev/v2/mcp-oauth	不需要
API 密钥	想让脚本、CI 或无浏览器环境稳定运行的用户	https://mcp.firecrawl.dev/v2/mcp	需要

官方文档把 OAuth 地址称为供 MCP 客户端使用的服务器 URL，而不是可以直接在浏览器中打开的页面。使用 OAuth 时，应把地址交给 MCP 客户端，由客户端启动浏览器登录和授权流程。

前置条件：先准备这三项

1. 准备 Firecrawl 账户或团队权限：打开 Firecrawl MCP 开始使用文档，确认自己能进入 Firecrawl 的账户设置，并能看到 API 密钥管理入口。
2. 准备一个支持 MCP 的客户端：可以是 Codex、Claude Code 或其他 MCP 客户端。客户端需要支持添加远程 MCP 服务器；如果客户端要求填写 Authorization 请求头，则应选择 API 密钥方式。
3. 确认网络能访问 Firecrawl：OAuth 登录需要能打开浏览器，API 密钥方式需要客户端能够访问 mcp.firecrawl.dev。不要把密钥写进 URL、提交到 Git 仓库或贴到聊天记录里。

API 密钥方式需要使用环境变量或客户端自带的密钥存储配置。官方文档明确要求：不要将密钥放在 MCP URL 中。

方式一：用 OAuth 完成浏览器登录

1. 把 OAuth 地址填进客户端

在客户端的 MCP 配置中新增一个服务器，使用下面这段官方配置：

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

type: "http" 表示客户端按远程 HTTP MCP 服务器连接；mcpServers 中的 firecrawl 是这个连接的名称，可以换成客户端允许的名称。

2. 触发客户端的登录流程

保存配置后，让客户端重新连接 Firecrawl MCP。客户端通常会打开浏览器窗口，在其中登录 Firecrawl，并选择一个要授权的团队。

如果客户端没有自动打开浏览器，先在客户端中执行一次“重新连接”或“启用服务器”，再观察是否出现登录授权页面。官方文档说明，OAuth 连接完成后可以在 MCP 设置中查看并撤销连接。

3. 确认连接成功

成功标志不是“浏览器登录成功”这一句，而是客户端已经识别出 Firecrawl 的工具。重新打开 MCP 工具列表，应该能看到 firecrawl_scrape、firecrawl_map、firecrawl_crawl、firecrawl_search 等工具；不同客户端的展示位置不同，通常在 MCP 服务器、工具列表或连接详情面板中。

如果只是想临时试用网页抓取，OAuth 是最短路径；如果后面要放进自动化任务，直接使用下一种方式。

方式二：获取 API 密钥并填到请求头

1. 创建 Firecrawl API 密钥

登录 Firecrawl 账户，在账户的 API 密钥管理页面创建一枚密钥。创建后立即保存密钥内容，因为完整密钥通常只在创建时显示。

不要把密钥直接硬编码到 MCP 配置文件中。优先使用客户端的环境变量、密钥管理功能，或启动客户端时注入的环境变量。下面的配置示例使用官方占位符：

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

把 <FIRECRAWL_API_KEY> 替换成实际密钥时，不要保留尖括号。若客户端使用环境变量插值，应按该客户端的语法填写变量名，而不是把真实密钥再写进配置文本。

2. 让客户端读取环境变量

不同客户端的环境变量写法不一样，先查看客户端自己的 MCP 配置说明。可以先在终端确认变量已经存在，但不要把输出中的密钥发出来：

echo "$FIRECRAWL_API_KEY"

如果输出为空，说明当前终端没有加载密钥；如果输出了一串字符，检查它是否以 fc- 等密钥前缀开头，并把结果视为敏感信息。Windows PowerShell、macOS/Linux 的环境变量设置方式不同，选择与当前系统对应的写法即可。

3. 检查工具是否能调用

重新连接 MCP 客户端，然后调用一个成本和影响较小的工具，例如对公开页面执行一次抓取。成功时，客户端应返回页面内容或结构化结果，而不是连接错误。

官方仓库对工具用途的区分很清楚：已知 URL 用 firecrawl_scrape，从查询开始用 firecrawl_search，发现站点 URL 用 firecrawl_map，批量读取多个页面用 firecrawl_crawl。第一次验证只调用一个工具，避免同时触发多个抓取任务而消耗额度。

最容易填错的位置

把 OAuth URL 当成普通网页打开

官方文档特别提醒，https://mcp.firecrawl.dev/v2/mcp-oauth 是供 MCP 客户端使用的服务器 URL，不是可以直接在浏览器中打开的页面。正确做法是把它填入客户端配置，再让客户端发起连接；直接浏览器访问不能完成客户端配置。

把密钥放进 URL

API 密钥方式的服务器地址仍是：

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

密钥应放在 Authorization 请求头中，格式为：

Bearer <FIRECRAWL_API_KEY>

不要写成 https://mcp.firecrawl.dev/v2/mcp?key=...。URL 会更容易出现在日志、历史记录或截图里，也不符合官方文档的安全要求。

OAuth 与 API 密钥混用

如果配置中使用 OAuth 地址，就不需要额外填写 Authorization 头；如果配置中使用普通 /v2/mcp 地址，就需要 Bearer 令牌。两套地址不要拼接，也不要把 OAuth 地址改成带密钥参数的 URL。

客户端能登录，但工具列表为空

先确认连接类型是 http，再确认服务器 URL 没有漏掉 /v2 路径。随后重新连接客户端；如果客户端提供 MCP 设置面板，检查是否把服务器设成了禁用状态。官方文档还说明，OAuth 连接可以在 MCP 设置中查看和撤销，因此可以先撤销旧连接，再用新的地址重新授权。

想看额度却不知道调用了什么

官方仓库列出了 firecrawl_credit_usage 工具，可用于查看当前或历史 Firecrawl credit 使用情况，并按月份、日期或端点细分。第一次配置后如果需要核对用量，可在客户端调用这个工具，而不是反复用抓取任务猜测消耗。

怎么算配置成功

满足下面几个可观察条件，就可以认为鉴权已经接通：

• OAuth 方式：浏览器完成 Firecrawl 登录和团队授权，客户端重新连接后不再要求登录。
• API 密钥方式：客户端连接 https://mcp.firecrawl.dev/v2/mcp，并在请求头中发送 Bearer 令牌。
• 两种方式共同标志：客户端的工具列表出现 Firecrawl 工具；对一个公开 URL 调用 firecrawl_scrape 能返回 Markdown 或 JSON 内容。
• 账户检查：调用 firecrawl_credit_usage 能返回用量信息。

如果工具能出现但调用失败，先区分“鉴权失败”和“目标网站抓取失败”：前者检查 URL、Authorization 头或 OAuth 授权，后者再检查目标 URL 是否公开、是否需要登录，以及当前 Firecrawl 套餐和额度状态。

后续连接与官方入口

需要切换连接方式时，直接编辑同一个 MCP 服务器配置：浏览器登录使用 OAuth 配置说明，自动化环境使用 API 密钥配置说明。

工具名称、用途和限制可在 Firecrawl MCP 官方仓库 README 核对。仓库还提供版本文件、CHANGELOG.md 和 docs 目录，适合在客户端升级后确认配置字段是否发生变化。若客户端本身的 MCP 连接语法需要查证，可参考 GitHub 官方文档；这与 Firecrawl 的服务端 URL、密钥位置无关，不要把 GitHub 登录页当成 Firecrawl 登录入口。

参考来源

• 开始使用