> ## 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.

# 在 Amazon Q Developer 中使用 MCP 网页搜索与抓取

> 在 IDE 中为 Amazon Q Developer 添加 Firecrawl 网页搜索与抓取功能

通过远程托管的 MCP 服务器，将 Firecrawl 连接到 VS Code、JetBrains 及其他受支持 IDE 中的 Amazon Q Developer。Q Developer 会打开浏览器，供你使用 Firecrawl 账户登录。

<Note>
  Amazon Q Developer CLI 现已更名为 Kiro CLI。如需在终端中使用，请参阅 [Kiro 设置指南](/zh/quickstarts/kiro)。
</Note>

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

1. 打开 IDE，依次进入 Q Developer 面板和 **Chat** 面板。
2. 点击工具图标，然后点击加号 (+) 按钮。
3. 选择作用域：**global** 会将服务器配置保存在 `~/.aws/amazonq/default.json` 中，**local** 则保存在项目内的 `.amazonq/default.json` 中。
4. 输入 `firecrawl` 作为名称，选择 **http** 作为传输方式，然后输入以下 URL：

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

5. 选择 **Save**。Q Developer 会打开一个浏览器页面，供您授权访问。登录 Firecrawl 并批准连接。
6. 保存后，在弹出的面板中检查每个工具的权限 (**Ask**、**Always allow** 或 **Deny**) 。

<Accordion title="想直接编辑配置文件？">
  Q Developer 还会从 `~/.aws/amazonq/mcp.json` (全局) 和 `.amazonq/mcp.json` (项目级) 读取 MCP 服务器配置：

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

  是否支持 `mcp.json` 文件由 `default.json` 中的 `useLegacyMcpJson` 字段控制，该字段默认为 `true`。
</Accordion>

<Accordion title="想改用 API 密钥？">
  在同一对话框中，添加名为 `Authorization` 的标头，值为 `Bearer fc-YOUR-API-KEY`，并将 URL 设置为 `https://mcp.firecrawl.dev/v2/mcp`。请参见[配置 API 密钥](/zh/mcp-server/keyless#add-an-api-key)。
</Accordion>

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

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

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

```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>

* **出现“Fix Configuration”告警：**点击该告警返回表单，检查 URL 是否正确。
* **浏览器页面未打开：**为该服务器选择 **Edit setup**，重新保存，并在页面打开后完成授权。
* **服务器已列出，但其工具无法运行：**在 MCP 服务器 面板中打开该服务器，确认其已启用，且工具未设置为 **Deny**。
* **出现两个 Firecrawl 条目：**`.amazonq/default.json` 中的服务器优先于全局服务器。请删除不需要的那个重复条目。


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