> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 在 Warp 中使用 MCP 网页搜索与抓取

> 为 Warp 智能体添加 Firecrawl 网络搜索与抓取功能

通过远程托管的 MCP 服务器将 Firecrawl 连接到 Warp 的本地智能体，然后使用你的 Firecrawl 账户登录。

<h2 id="quick-setup">
  快速配置
</h2>

1. 在 Warp 中，依次打开 **Settings** → **Agents** → **MCP 服务器**。也可以在命令面板中搜索 **Open MCP Servers**。
2. 点击 **+ Add**，然后粘贴以下配置：

```json theme={null}
{
  "mcpServers": {
    "firecrawl": {
      "url": "https://mcp.firecrawl.dev/v2/mcp-oauth"
    }
  }
}
```

3. 启动服务器。Warp 会打开浏览器页面进行 Firecrawl 登录。批准访问后，Warp 会将凭据保存在你的设备上。
4. 确认 `firecrawl` 在 MCP 服务器列表中显示为运行中，然后让智能体执行搜索或抓取。

<Accordion title="想使用基于文件的配置？">
  Warp 还会从 `~/.warp/.mcp.json` 加载适用于所有项目的服务器，或从项目根目录下的 `.warp/.mcp.json` 加载服务器。使用与上文相同的 JSON 即可。项目文件中的服务器需经你批准后才会启动。
</Accordion>

<Accordion title="想使用 API 密钥？">
  Warp 支持为 URL 服务器设置自定义标头。将 URL 设为 `https://mcp.firecrawl.dev/v2/mcp`，并添加 `"headers": { "Authorization": "Bearer fc-YOUR-API-KEY" }`。请参见[配置 API 密钥](/zh/mcp-server/keyless#add-an-api-key)。
</Accordion>

更多详情，请参见 [OAuth 连接指南](/zh/mcp-server/oauth)。

<h2 id="try-it">
  试一试
</h2>

```text theme={null}
进行网页搜索，查找最新的 Rust 版本发布说明，并总结这些信息来源。
```

```text theme={null}
抓取 https://firecrawl.dev 并说明它的功能。
```

<h2 id="what-you-can-do">
  功能概览
</h2>

<CardGroup cols={2}>
  <Card title="搜索" icon="magnifying-glass" href="/zh/features/search">
    查找最新信息，并读取相关结果的内容。
  </Card>

  <Card title="抓取" icon="file-lines" href="/zh/features/scrape">
    将 URL 转换为干净的 markdown 或结构化数据。
  </Card>

  <Card title="交互" icon="hand-pointer" href="/zh/features/interact">
    通过页面导航、点击和表单填写，获取所需数据。
  </Card>

  <Card title="Alexandria" icon="books" href="/zh/features/alexandria">
    发现结构化数据工具，查看其输入参数和定价，然后通过 Firecrawl 运行这些工具。
  </Card>
</CardGroup>

<h2 id="troubleshooting">
  故障排除
</h2>

* **登录页面无法打开：**在 MCP 服务器页面重新启动该服务器。
* **登录反复失败：**运行 `rm -rf ~/.mcp-auth` 清除已存储的 MCP 令牌，然后重新启动服务器。此操作会清除所有 MCP 服务器的令牌。
* **服务器无法启动：**在该服务器上选择 **查看日志**，查看错误信息。
* **工具未被调用：**不同模型调用 MCP 工具的可靠性有所差异。请在智能体选择器中换用其他模型。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.