Skip to main content
托管的 Firecrawl MCP 服务提供三种使用模式。请根据是否有人可登录，以及客户端能否安全存储 API 密钥进行选择。

​
连接账户

此模式适用于 Claude 或 Codex 等支持 OAuth 的交互式客户端。将此 URL 添加到客户端后，它会发现 Firecrawl’s 授权元数据、打开浏览器，并要求你批准要使用的团队。
客户端获得的是短期有效、与资源绑定的令牌，而非您的 Firecrawl API 密钥。您可以在 MCP 设置中查看和撤销访问权限。
如果客户端要求提供 OAuth Client ID 或 Client Secret，请将两者留空。兼容的客户端会使用 Client ID Metadata Documents 或 Dynamic Client Registration。

​
无人值守运行

此模式适用于 CI、服务器、脚本或任何没有浏览器的运行时。请将 API 密钥存储在环境变量或密钥存储中，并通过 Authorization 请求头发送。
这将使用完整的 Firecrawl MCP 工具集。新的配置不应将 API 密钥放在 URL 中，也不应将其提交到项目配置文件。

​
试用免密钥模式

使用此模式，无需账户或 API 密钥即可试用 Firecrawl：
免密钥 MCP 按 IP 限流，符合条件时仅提供 Search、Scrape 和 Parse。如需使用完整工具集或更高限额，请连接账户或使用 API 密钥。

​
选择合适的模式

​
客户端专属帮助

配置示例请参见客户端设置。如果您的客户端无法完成远程 OAuth 流程，请改用基于请求头的无人值守配置或免密钥模式。如果也无法发送自定义请求头，请参见下方的旧版备用方案。

​
旧版 API 密钥 URL 支持

此旧版形式仅适用于无法完成 OAuth 流程或无法发送自定义 Authorization 请求头的现有配置和客户端。不建议新集成采用此设置。
API 密钥包含在 URL 中，因此请将完整 URL 视为密码。只要客户端支持，应优先使用账户 OAuth 或由环境变量提供的 Authorization: Bearer 请求头。如果此 URL 泄露，请轮换 API 密钥。切勿将其粘贴到聊天记录、截图、问题单或共享配置中。 此备用方案仅适用于完整的 /v2/mcp 接口。它不适用于仅支持 OAuth 的搜索资源。

​
迁移期间的兼容性

迁移至专用账户端点期间，现有的 /v2/mcp OAuth 连接仍然受支持。新的交互式账户连接应使用 /v2/mcp-oauth；为该账户资源新生成的令牌无法被 /v2/mcp 接受。