> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-dne9il.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 将 MCP 客户端连接到您的账户

> 将交互式 MCP 客户端连接到您的 Firecrawl 账户

需要用户登录并授权访问时，请使用 Firecrawl 的账户端点。客户端将获得短期有效且绑定特定资源的令牌，而不是您的原始 Firecrawl API 密钥。

如需了解账户 OAuth、无人值守的 API 密钥访问和免密钥访问这几种方式，请参见 [连接 Firecrawl MCP](/zh/mcp-server/connect)。

<div id="connect-an-interactive-client">
  ## 连接交互式客户端
</div>

将兼容的交互式客户端连接至：

```text theme={null}
https://mcp.firecrawl.dev/v2/mcp-oauth
```

如果客户端要求提供 OAuth Client ID 或 客户端密钥，请将两者留空。兼容的客户端会通过 Client ID 元数据文档或动态客户端注册来识别自身。

客户端会在您的浏览器中打开 Firecrawl。登录后，选择连接器要使用的团队，查看授权请求并批准访问。请求费用将计入所选团队。

请参阅 [ChatGPT](/zh/developer-guides/mcp-setup-guides/chatgpt) 和 [Claude](/zh/developer-guides/mcp-setup-guides/claude-ai) 的专用指南，因为它们的设置界面和工作区规则各不相同。

<div id="cursor-and-vs-code-redirect-support">
  ### Cursor 和 VS Code 重定向支持
</div>

仅当已安装的客户端版本能够完成远程 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。

<div id="choose-the-hosted-mode">
  ## 选择托管模式
</div>

| 端点                                       | 适用场景         | 身份验证和可用工具                                                                                              |
| ---------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------ |
| `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 或项目配置文件中。

<div id="manage-a-connection">
  ## 管理连接
</div>

要断开客户端连接，请在 [Firecrawl Settings](https://www.firecrawl.dev/app/settings?tab=mcp) 中打开 **MCP**，然后撤销该连接。撤销后，访问令牌和刷新令牌将失效；请在客户端重新连接并再次授权。

<div id="compatibility-during-migration">
  ## 迁移期间的兼容性
</div>

* 明确绑定到 `/v2/mcp` 的现有 OAuth 令牌可继续用于 `/v2/mcp`。
* 在迁移期间，`/v2/mcp-oauth` 也可接受兼容的现有 `/v2/mcp` 令牌。
* 为 `/v2/mcp-oauth` 签发的新令牌不被 `/v2/mcp` 接受。
* 缺少受众或受众不明确的令牌将被默认拒绝。
* 现有的旧版路径内含密钥的 MCP 配置可继续使用，但新配置应使用 OAuth 或 Bearer 请求头。

<div id="security-properties">
  ## 安全特性
</div>

* 访问令牌的有效期为一小时。
* 每次成功刷新时，刷新令牌都会轮换。
* 每个连接均与其 OAuth 客户端、用户、团队、作用域和 MCP 资源绑定。
* OAuth 客户端使用带 PKCE 的授权码流程，无需客户端密钥。

<div id="supported-standards">
  ## 支持的标准
</div>

* 使用 PKCE (S256) 的 OAuth 2.0 授权码流程
* RFC 8414 授权服务器元数据
* RFC 9728 受保护资源元数据
* 客户端 ID 元数据文档 (CIMD)
* RFC 7591 动态客户端注册 (DCR)
* RFC 8707 资源指示器

新账户连接在授权和令牌请求中必须使用此确切资源：

```text theme={null}
https://mcp.firecrawl.dev/v2/mcp-oauth
```

授权服务器元数据位于：

```bash theme={null}
curl -s "https://www.firecrawl.dev/.well-known/oauth-authorization-server" | jq .
```