将 MCP 客户端连接到您的账户
将交互式 MCP 客户端连接到您的 Firecrawl 账户
需要用户登录并授权访问时，请使用 Firecrawl 的账户端点。客户端将获得短期有效且绑定特定资源的令牌，而不是您的原始 Firecrawl API 密钥。
如需了解账户 OAuth、无人值守的 API 密钥访问和免密钥访问这几种方式，请参见 连接 Firecrawl MCP。
将兼容的交互式客户端连接至：
https://mcp.firecrawl.dev/v2/mcp-oauth如果客户端要求提供 OAuth Client ID 或 客户端密钥，请将两者留空。兼容的客户端会通过 Client ID 元数据文档或动态客户端注册来识别自身。
客户端会在您的浏览器中打开 Firecrawl。登录后，选择连接器要使用的团队，查看授权请求并批准访问。请求费用将计入所选团队。
请参阅 ChatGPT 和 Claude 的专用指南，因为它们的设置界面和工作区规则各不相同。
仅当已安装的客户端版本能够完成远程 OAuth 流程时，才使用账户端点。Firecrawl 支持 HTTPS 重定向 URI，以及使用 http://localhost、http://127.0.0.1 或 http://[::1] 的回环重定向 URI。对于原生 HTTP 回环客户端，端口可在每次运行时变化，但已注册的主机和路径必须与请求的重定向 URI 一致。
如果所用版本的 Cursor 或 VS Code 无法完成远程 OAuth，请改为使用 Authorization: Bearer <FIRECRAWL_API_KEY> 请求头配置 https://mcp.firecrawl.dev/v2/mcp。请将 key 保存在客户端的环境变量或安全密钥存储中；切勿将其放入 URL。
| 端点 | 适用场景 | 身份验证和可用工具 |
|---|---|---|
https://mcp.firecrawl.dev/v2/mcp | 免密钥试用或无人值守流程 | 未提供凭据时，符合条件的用户可在限流下仅使用 Search、Scrape 和 Parse。使用 Authorization: Bearer <FIRECRAWL_API_KEY> 时，可使用全部工具。 |
https://mcp.firecrawl.dev/v2/mcp-oauth | 交互式的浏览器账户连接 | 会启动 OAuth，并在授权后提供全部工具。也接受 API 密钥作为兼容方式。 |
对于 CI、服务器、脚本及其他无人值守客户端，请使用 https://mcp.firecrawl.dev/v2/mcp，并通过由环境变量提供的 Authorization: Bearer <FIRECRAWL_API_KEY> 请求头进行身份验证。请勿将 API 密钥放入 URL 或项目配置文件中。
要断开客户端连接，请在 Firecrawl Settings 中打开 MCP，然后撤销该连接。撤销后，访问令牌和刷新令牌将失效；请在客户端重新连接并再次授权。
- 明确绑定到
/v2/mcp的现有 OAuth 令牌可继续用于/v2/mcp。 - 在迁移期间，
/v2/mcp-oauth也可接受兼容的现有/v2/mcp令牌。 - 为
/v2/mcp-oauth签发的新令牌不被/v2/mcp接受。 - 缺少受众或受众不明确的令牌将被默认拒绝。
- 现有的旧版路径内含密钥的 MCP 配置可继续使用，但新配置应使用 OAuth 或 Bearer 请求头。
- 访问令牌的有效期为一小时。
- 每次成功刷新时，刷新令牌都会轮换。
- 每个连接均与其 OAuth 客户端、用户、团队、作用域和 MCP 资源绑定。
- OAuth 客户端使用带 PKCE 的授权码流程，无需客户端密钥。
- 使用 PKCE (S256) 的 OAuth 2.0 授权码流程
- RFC 8414 授权服务器元数据
- RFC 9728 受保护资源元数据
- 客户端 ID 元数据文档 (CIMD)
- RFC 7591 动态客户端注册 (DCR)
- RFC 8707 资源指示器
新账户连接在授权和令牌请求中必须使用此确切资源：
https://mcp.firecrawl.dev/v2/mcp-oauth授权服务器元数据位于：
curl -s "https://www.firecrawl.dev/.well-known/oauth-authorization-server" | jq .