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

# 在 Zencoder 中使用 MCP 网络搜索与抓取

> 为 Zencoder IDE 插件添加 Firecrawl 网络搜索与抓取功能

在 JetBrains IDE 和 VS Code 中将 Firecrawl 添加到 Zencoder。JetBrains 支持通过 OAuth2 连接远程服务器，因此你可以直接使用 Firecrawl 账户登录。VS Code 则使用 API 密钥在本地启动服务器。

<h2 id="requirements">
  前置要求
</h2>

* 已在 JetBrains IDE 或 VS Code 中安装 Zencoder 插件。
* 若使用 VS Code 配置方式：需要 Node.js 22 或更高版本，以及 [Firecrawl API 密钥](https://www.firecrawl.dev/app/api-keys)。

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

<Tabs>
  <Tab title="JetBrains">
    1. 依次打开 **设置** → **Tools** → **Zencoder** → **MCP 服务器**。
    2. 添加以下服务器并应用更改：

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

    3. 在浏览器中完成 Firecrawl 登录，然后确认这些工具已出现在智能体的工具列表中。
  </Tab>

  <Tab title="VS Code">
    1. 打开用户级或工作区级的 `settings.json`。
    2. 在 `zencoder.mcpServers` 下添加 Firecrawl：

    ```json theme={null}
    {
      "zencoder.mcpServers": {
        "firecrawl": {
          "command": "npx",
          "args": ["-y", "firecrawl-mcp@3.33.2"],
          "env": {
            "FIRECRAWL_API_KEY": "fc-YOUR-API-KEY"
          }
        }
      }
    }
    ```

    3. 重启 VS Code，然后确认 Firecrawl 工具已出现在 **智能体工具** 下。
  </Tab>
</Tabs>

根据 Zencoder 文档，VS Code 对 HTTP 和 OAuth2 服务器的支持仍在逐步推出，因此在你的版本支持之前，请先使用本地配置方式。更多详情请参见 [OAuth 连接指南](/zh/mcp-server/oauth) 和 [在本地运行 MCP](/zh/mcp-server/local)。

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

```text theme={null}
进行网页搜索，查找最新的 Spring Boot 版本发布说明，并汇总各信息来源的内容。
```

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

* **服务器未出现在智能体工具中：** 检查 JSON 语法，然后重启 IDE。MCP 服务器在启动时加载。
* **JetBrains 登录失败：** 清除该服务器的缓存令牌，然后重新登录。
* **VS Code 提示缺少命令：** 确认 `npx` 能在终端中正常运行，且 `node --version` 输出的版本为 22 或更高。
* **工具无法运行：** Zencoder 会在工具调用前请求权限。请为 Firecrawl 工具选择 **Allow once** 或 **Always allow**。


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